Grupy i użytkownicy programu MS Graph
Łącznik Grupy i użytkownicy programu MS Graph ułatwia pobieranie grup identyfikatorów entra firmy Microsoft, członków (użytkowników) i szczegółów licencji
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Jay Jani, Microsoft |
| jayjani@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Jay Jani |
| Witryna internetowa | https://graph.microsoft.com |
| Zasady ochrony prywatności | https://privacy.microsoft.com/en-us/privacystatement |
| Kategorie | Operacje IT; Dane |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Pobieranie grup członków |
Członkostwa w grupach dla użytkownika (członka) |
| Pobieranie szczegółów licencji członka |
Pobieranie szczegółów licencji elementu członkowskiego grupy (użytkownika) |
| Pobieranie właściwości grupy |
Pobieranie właściwości i relacji grupy identyfikatorów entra firmy Microsoft |
| Wyświetlanie listy bezpośrednich członków grupy |
Pobieranie bezpośrednich członków grupy z liczbą |
| Wyświetlanie listy grup według wyszukiwania nazw wyświetlanych |
Pobieranie grup przez wyszukiwanie nazwy wyświetlanej grupy |
| Wyświetlanie listy subskrybowanych jednostek SKU |
Szczegóły jednostek SKU planu licencjonowania subskrybowanego w organizacji |
| Wyświetlanie listy użytkowników |
Pobieranie wszystkich użytkowników w organizacji (dzierżawa identyfikatora entra firmy Microsoft) |
Pobieranie grup członków
Członkostwa w grupach dla użytkownika (członka)
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator obiektu elementu członkowskiego Microsoft Entra ID (użytkownik)
|
member-id | True | string |
Identyfikator obiektu elementu członkowskiego Microsoft Entra ID (użytkownik) |
|
Tylko włączone zabezpieczenia (prawda/fałsz)
|
securityEnabledOnly | True | boolean |
Czy chcesz pobrać tylko grupy z włączonymi zabezpieczeniami? |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontekst Odata
|
@odata.context | string |
Link Odata.context. |
|
value
|
value | array of string |
value |
Pobieranie szczegółów licencji członka
Pobieranie szczegółów licencji elementu członkowskiego grupy (użytkownika)
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator obiektu elementu członkowskiego Microsoft Entra ID (użytkownik)
|
id | True | string |
Identyfikator obiektu elementu członkowskiego Microsoft Entra ID (użytkownik) |
|
Wybór punktów danych (kolumn)
|
$select | string |
Wybór punktów danych (kolumn) |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontekst Odata
|
@odata.context | string |
Link Odata.context. |
|
value
|
value | array of object |
value |
|
identyfikator
|
value.id | string |
id |
|
Identyfikator SKU
|
value.skuId | string |
Identyfikator jednostki SKU. |
|
Numer części jednostki SKU
|
value.skuPartNumber | string |
Nazwa SKU |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus (stan aprowizacji)
|
value.servicePlans.provisioningStatus | string |
provisioningStatus (stan aprowizacji) |
|
dotyczy
|
value.servicePlans.appliesTo | string |
dotyczy |
Pobieranie właściwości grupy
Pobieranie właściwości i relacji grupy identyfikatorów entra firmy Microsoft
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator obiektu grupy Microsoft Entra ID
|
group-id | True | string |
Identyfikator obiektu grupy Microsoft Entra ID |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontekst Odata
|
@odata.context | string |
Link Odata.context. |
|
identyfikator
|
id | string |
Identyfikator obiektu grupy |
|
Usunięto datę i godzinę
|
deletedDateTime | string |
Data usunięcia grupy o godzinie |
|
Classification
|
classification | string |
klasyfikacja |
|
Utworzono datę i godzinę
|
createdDateTime | string |
Data utworzenia grupy |
|
creationOptions
|
creationOptions | array of string |
Utworzone opcje grupy. |
|
Description
|
description | string |
opis |
|
Wyświetlana nazwa
|
displayName | string |
Nazwa wyświetlana grupy |
|
Data wygaśnięcia
|
expirationDateTime | string |
Data wygaśnięcia grupy |
|
groupTypes
|
groupTypes | array of string |
Typy grup dla grupy. |
|
Jest przypisywany do roli
|
isAssignableToRole | string |
Czy można przypisać rolę do tej grupy? |
|
Poczta
|
string |
Adres e-mail grupy |
|
|
Poczta włączona
|
mailEnabled | boolean |
Czy włączono pocztę e-mail grupy? |
|
Nazwa nicka poczty
|
mailNickname | string |
Nazwa nicka e-mail grupy |
|
Reguła członkostwa
|
membershipRule | string |
Reguła używana do oceny członkostwa. |
|
Stan przetwarzania reguł członkostwa
|
membershipRuleProcessingState | string |
Stan przetwarzania reguły używanej do oceny członkostwa. |
|
OnPremises Nazwa domeny
|
onPremisesDomainName | string |
Zawiera lokalną nazwę domenyFQDN, nazywaną również nazwą dnsDomainName zsynchronizowaną z katalogu lokalnego. |
|
Data ostatniej synchronizacji w usłudze OnPremises
|
onPremisesLastSyncDateTime | string |
Godzina i data ostatniej synchronizacji dzierżawy z katalogiem lokalnym. |
|
Nazwa OnPremises NetBios
|
onPremisesNetBiosName | string |
Nazwa usługi sieciowej dla serwera lokalnego. |
|
OnPremises Sam Account Name
|
onPremisesSamAccountName | string |
Nazwa konta Sam dla katalogu lokalnego. |
|
OnPremises Security Identifier
|
onPremisesSecurityIdentifier | string |
Lokalny identyfikator zabezpieczeń. |
|
Włączono synchronizację onPremises
|
onPremisesSyncEnabled | boolean |
Wartość true, jeśli synchronizacja lokalna jest włączona dla grupy. |
|
Preferowana lokalizacja danych
|
preferredDataLocation | string |
Preferowana lokalizacja danych grupy. |
|
Preferowany język
|
preferredLanguage | string |
Preferowany język zgodnie z konfiguracją w identyfikatorze Entra firmy Microsoft. |
|
proxyAddresses
|
proxyAddresses | array of string |
Adresy proxy grupy. |
|
Odnowiona data i godzina
|
renewedDateTime | string |
Odnowiona data i godzina grupy. |
|
resourceBehaviorOptions
|
resourceBehaviorOptions | array of string |
Opcje zachowania zasobów grupy. |
|
resourceProvisioningOptions
|
resourceProvisioningOptions | array of string |
Opcje aprowizacji zasobów grupy. |
|
Włączone zabezpieczenia
|
securityEnabled | boolean |
Wskazuje, czy grupa jest włączona zabezpieczeń. |
|
Identyfikator zabezpieczeń
|
securityIdentifier | string |
Identyfikator zabezpieczeń grupy. |
|
Theme
|
theme | string |
Motyw grupy Microsoft Entra ID. |
|
Widoczność
|
visibility | string |
Widoczność grupy. |
|
onPremisesProvisioningErrors
|
onPremisesProvisioningErrors | array of string |
Lokalne błędy aprowizacji grupy. |
Wyświetlanie listy bezpośrednich członków grupy
Pobieranie bezpośrednich członków grupy z liczbą
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator obiektu grupy Microsoft Entra ID
|
group-id | True | string |
Identyfikator obiektu grupy Microsoft Entra ID |
|
Filtruj według
|
$filter | string |
Filtruj według |
|
|
Wybór punktu danych (kolumna)
|
$select | string |
Wybieranie kolumn do pobrania |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontekst Odata
|
@odata.context | string |
Link Odata.context. |
|
Liczba odata
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Typ Odata
|
value.@odata.type | string |
@odata.type |
|
Wyświetlana nazwa
|
value.displayName | string |
Imię i nazwisko członka |
|
Główna nazwa użytkownika
|
value.userPrincipalName | string |
Główna nazwa użytkownika członka |
|
identyfikator
|
value.id | string |
Identyfikator obiektu dla elementu członkowskiego |
|
Stanowisko
|
value.jobTitle | string |
tytuł stanowiska |
|
Nazwa nicka poczty
|
value.mailNickname | string |
Nazwa nicka e-mail członka |
|
Poczta
|
value.mail | string |
Adres e-mail członka |
|
Imię
|
value.givenName | string |
Imię członka |
|
Surname
|
value.surname | string |
Nazwisko członka |
|
telefony biznesowe
|
value.businessPhones | array of string |
telefony biznesowe |
|
Telefon komórkowy
|
value.mobilePhone | string |
telefon komórkowy |
|
Lokalizacja pakietu Office
|
value.officeLocation | string |
officeLocation |
|
Preferowany język
|
value.preferredLanguage | string |
Preferowany język zgodnie z konfiguracją w identyfikatorze Entra firmy Microsoft. |
Wyświetlanie listy grup według wyszukiwania nazw wyświetlanych
Pobieranie grup przez wyszukiwanie nazwy wyświetlanej grupy
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wyszukiwanie według nazwy wyświetlanej
|
$search | string |
Wyszukiwanie według słowa kluczowego w nazwie wyświetlanej grupy Identyfikator entra firmy Microsoft |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontekst Odata
|
@odata.context | string |
Link Odata.context. |
|
Liczba grup
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
identyfikator
|
value.id | string |
Identyfikator obiektu grupy |
|
Usunięto datę i godzinę
|
value.deletedDateTime | string |
Data i godzina usunięcia grupy |
|
Classification
|
value.classification | string |
Klasyfikacja grupy |
|
Utworzono datę i godzinę
|
value.createdDateTime | string |
Data i godzina utworzenia grupy |
|
creationOptions
|
value.creationOptions | array of |
Utworzone opcje grupy. |
|
Description
|
value.description | string |
Opis grupy |
|
Wyświetlana nazwa
|
value.displayName | string |
Nazwa wyświetlana grupy |
|
Data wygaśnięcia
|
value.expirationDateTime | string |
Data wygaśnięcia grupy |
|
groupTypes
|
value.groupTypes | array of string |
Typy grup dla grupy. |
|
Jest przypisywany do roli
|
value.isAssignableToRole | string |
Czy można przypisać rolę do tej grupy? |
|
Poczta
|
value.mail | string |
Adres e-mail grupy |
|
Poczta włączona
|
value.mailEnabled | boolean |
Czy włączono pocztę e-mail grupy? |
|
Nazwa nicka poczty
|
value.mailNickname | string |
Nazwa nicka e-mail grupy |
|
Reguła członkostwa
|
value.membershipRule | string |
Reguła używana do oceny członkostwa. |
|
Stan przetwarzania reguł członkostwa
|
value.membershipRuleProcessingState | string |
Stan przetwarzania reguły używanej do oceny członkostwa. |
|
OnPremises Nazwa domeny
|
value.onPremisesDomainName | string |
Zawiera lokalną nazwę domenyFQDN, nazywaną również nazwą dnsDomainName zsynchronizowaną z katalogu lokalnego. |
|
Data ostatniej synchronizacji w usłudze OnPremises
|
value.onPremisesLastSyncDateTime | string |
Godzina i data ostatniej synchronizacji dzierżawy z katalogiem lokalnym. |
|
Nazwa OnPremises NetBios
|
value.onPremisesNetBiosName | string |
Nazwa usługi sieciowej dla serwera lokalnego. |
|
OnPremises Sam Account Name
|
value.onPremisesSamAccountName | string |
Nazwa konta Sam dla katalogu lokalnego. |
|
OnPremises Security Identifier
|
value.onPremisesSecurityIdentifier | string |
Lokalny identyfikator zabezpieczeń. |
|
Włączono synchronizację onPremises
|
value.onPremisesSyncEnabled | boolean |
Wartość true, jeśli synchronizacja lokalna jest włączona dla grupy. |
|
Preferowana lokalizacja danych
|
value.preferredDataLocation | string |
Preferowana lokalizacja danych grupy. |
|
Preferowany język
|
value.preferredLanguage | string |
Preferowany język zgodnie z konfiguracją w identyfikatorze Entra firmy Microsoft. |
|
proxyAddresses
|
value.proxyAddresses | array of string |
Adresy proxy grupy. |
|
Odnowiona data i godzina
|
value.renewedDateTime | string |
Odnowiona data i godzina grupy. |
|
resourceBehaviorOptions
|
value.resourceBehaviorOptions | array of |
Opcje zachowania zasobów grupy. |
|
resourceProvisioningOptions
|
value.resourceProvisioningOptions | array of string |
Opcje aprowizacji zasobów grupy. |
|
Włączone zabezpieczenia
|
value.securityEnabled | boolean |
Wskazuje, czy grupa jest włączona zabezpieczeń. |
|
Identyfikator zabezpieczeń
|
value.securityIdentifier | string |
Identyfikator zabezpieczeń grupy. |
|
Theme
|
value.theme | string |
Motyw grupy Microsoft Entra ID. |
|
Widoczność
|
value.visibility | string |
Widoczność grupy. |
|
onPremisesProvisioningErrors
|
value.onPremisesProvisioningErrors | array of |
Lokalne błędy aprowizacji grupy. |
Wyświetlanie listy subskrybowanych jednostek SKU
Szczegóły jednostek SKU planu licencjonowania subskrybowanego w organizacji
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kontekst Odata
|
@odata.context | string |
Link Odata.context. |
|
value
|
value | array of object |
value |
|
Stan możliwości
|
value.capabilityStatus | string |
Stan możliwości jednostki SKU |
|
Zużyte jednostki
|
value.consumedUnits | integer |
Ile jednostek SKU jest już używanych? |
|
identyfikator
|
value.id | string |
id |
|
Identyfikator SKU
|
value.skuId | string |
Globalny unikatowy identyfikator jednostki SKU |
|
Numer części jednostki SKU
|
value.skuPartNumber | string |
Nazwa SKU |
|
Ma zastosowanie do
|
value.appliesTo | string |
Kto ma zastosowanie do jednostki SKU? |
|
Włączona
|
value.prepaidUnits.enabled | integer |
Włączone jednostki |
|
Zawieszony
|
value.prepaidUnits.suspended | integer |
Zawieszone jednostki |
|
Ostrzeżenie
|
value.prepaidUnits.warning | integer |
Jednostki w ostrzeżeniu |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisioningStatus (stan aprowizacji)
|
value.servicePlans.provisioningStatus | string |
provisioningStatus (stan aprowizacji) |
|
dotyczy
|
value.servicePlans.appliesTo | string |
dotyczy |
Wyświetlanie listy użytkowników
Pobieranie wszystkich użytkowników w organizacji (dzierżawa identyfikatora entra firmy Microsoft)
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
@odata.context
|
@odata.context | string |
Link Odata.context. |
|
value
|
value | array of object |
value |
|
telefony biznesowe
|
value.businessPhones | array of string |
telefony biznesowe |
|
Wyświetlana nazwa
|
value.displayName | string |
Pełna nazwa użytkownika |
|
Imię
|
value.givenName | string |
Imię użytkownika |
|
Stanowisko
|
value.jobTitle | string |
Stanowisko użytkownika |
|
Poczta
|
value.mail | string |
Adres e-mail użytkownika |
|
Telefon komórkowy
|
value.mobilePhone | string |
Telefon komórkowy użytkownika |
|
Lokalizacja pakietu Office
|
value.officeLocation | string |
Lokalizacja biura użytkownika |
|
Preferowany język
|
value.preferredLanguage | string |
Preferowany język użytkownika |
|
Surname
|
value.surname | string |
Nazwisko użytkownika |
|
Główna nazwa użytkownika
|
value.userPrincipalName | string |
Główna nazwa użytkownika |
|
identyfikator
|
value.id | string |
Identyfikator obiektu użytkownika |