MS Graph-csoportok és -felhasználók
Az MS Graph Groups and Users összekötő segít lekérni a Microsoft Entra-azonosító csoportokat, tagokat (felhasználókat) és licencadatokat
Ez az összekötő a következő termékekben és régiókban érhető el:
| Service | Class | Régiók |
|---|---|---|
| Copilot Studio | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Logikai alkalmazások | Standard | Az összes Logic Apps-régió , kivéve a következőket: - Azure Government-régiók - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD) |
| Power Alkalmazások | prémium | Az összes Power Apps-régió , kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Power Automate | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Érintkezés | |
|---|---|
| Név | Jay Jani, Microsoft |
| jayjani@microsoft.com |
| Összekötő metaadatai | |
|---|---|
| Kiadó | Jay Jani |
| Webhely | https://graph.microsoft.com |
| Adatvédelmi irányelvek | https://privacy.microsoft.com/en-us/privacystatement |
| Kategóriák | IT-műveletek; Adat |
Kapcsolat létrehozása
Az összekötő a következő hitelesítési típusokat támogatja:
| Alapértelmezett | A kapcsolat létrehozásának paraméterei. | Minden régió | Nem osztható meg |
Alapértelmezett
Alkalmazható: Minden régió
A kapcsolat létrehozásának paraméterei.
Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.
Szabályozási korlátok
| Name | Hívások | Megújítási időszak |
|---|---|---|
| API-hívások kapcsolatonként | 100 | 60 másodperc |
Műveletek
| Csoportok listázása névkeresés megjelenítése alapján |
Csoportok lekérése a csoport megjelenítendő nevének keresésével |
| Csoporttulajdonságok lekérése |
Microsoft Entra ID-csoport tulajdonságainak és kapcsolatainak lekérése |
| Előfizetett termékváltozatok listázása |
A szervezet előfizetett licenccsomagjának termékváltozatai |
| Felhasználók listázása |
A szervezet összes felhasználójának lekérése (Microsoft Entra ID-bérlő) |
| Közvetlen csoporttagok listázása |
Egy számmal rendelkező csoport közvetlen tagjainak lekérése |
| Tagcsoportok lekérése |
Csoporttagságok egy felhasználóhoz (taghoz) |
| Taglicencek adatainak lekérése |
Csoporttag(felhasználó) licencadatainak lekérése |
Csoportok listázása névkeresés megjelenítése alapján
Csoportok lekérése a csoport megjelenítendő nevének keresésével
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Keresés megjelenítendő név alapján
|
$search | string |
Keresés kulcsszó alapján a Microsoft Entra ID csoport megjelenítendő nevére |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Odata-környezet
|
@odata.context | string |
Az Odata.context hivatkozás. |
|
Csoportok száma
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
azonosító
|
value.id | string |
A csoport objektumazonosítója |
|
Törölt dátum időpontja
|
value.deletedDateTime | string |
A csoport törlésének dátuma és időpontja |
|
Classification
|
value.classification | string |
A csoport besorolása |
|
Létrehozás dátuma
|
value.createdDateTime | string |
Csoportlétrehozás dátuma és időpontja |
|
creationOptions
|
value.creationOptions | array of |
A csoport beállításainak létrehozása. |
|
Description
|
value.description | string |
A csoport leírása |
|
Megjelenítendő név
|
value.displayName | string |
Csoport megjelenítendő neve |
|
Lejárati dátum időpontja
|
value.expirationDateTime | string |
Csoport lejárati dátuma |
|
groupTypes
|
value.groupTypes | array of string |
Csoporttípusok a csoporthoz. |
|
Szerepkörhöz rendelhető
|
value.isAssignableToRole | string |
Hozzárendelhető egy szerepkör ehhez a csoporthoz? |
|
Levél
|
value.mail | string |
Csoport e-mail-címe |
|
Levelezés engedélyezve
|
value.mailEnabled | boolean |
Engedélyezve van a csoportos e-mail-cím? |
|
Levelezési nick neve
|
value.mailNickname | string |
Csoport e-mail-neve |
|
Tagsági szabály
|
value.membershipRule | string |
A tagság kiértékelésére használt szabály. |
|
Tagsági szabály feldolgozási állapota
|
value.membershipRuleProcessingState | string |
A tagság kiértékelésére használt szabály feldolgozási állapota. |
|
OnPremises tartománynév
|
value.onPremisesDomainName | string |
A helyszíni tartományFQDN-t, más néven dnsDomainName-t tartalmazza, amely a helyszíni címtárból van szinkronizálva. |
|
OnPremises Last Sync Date Time
|
value.onPremisesLastSyncDateTime | string |
Az az időpont és dátum, amikor a bérlő utoljára szinkronizálva lett a helyszíni címtárral. |
|
OnPremises NetBios Name
|
value.onPremisesNetBiosName | string |
A helyszíni kiszolgáló hálózati szolgáltatásának neve. |
|
OnPremises Sam-fiók neve
|
value.onPremisesSamAccountName | string |
Sam-fiók neve a helyszíni címtárhoz. |
|
OnPremises biztonsági azonosító
|
value.onPremisesSecurityIdentifier | string |
A helyszíni biztonsági azonosító. |
|
OnPremises Sync Enabled
|
value.onPremisesSyncEnabled | boolean |
Igaz, ha a helyszíni szinkronizálás engedélyezve van a csoport számára. |
|
Előnyben részesített adathely
|
value.preferredDataLocation | string |
A csoport elsődleges adathelye. |
|
Előnyben részesített nyelv
|
value.preferredLanguage | string |
Előnyben részesített nyelv a Microsoft Entra-azonosítóban konfigurált módon. |
|
proxi címek
|
value.proxyAddresses | array of string |
A csoport proxycímei. |
|
Megújított dátum időpontja
|
value.renewedDateTime | string |
A csoport megújított dátumideje. |
|
resourceBehaviorOptions
|
value.resourceBehaviorOptions | array of |
A csoport erőforrás-viselkedési beállításai. |
|
resourceProvisioningOptions
|
value.resourceProvisioningOptions | array of string |
A csoport erőforrás-kiépítési beállításai. |
|
A biztonság engedélyezve
|
value.securityEnabled | boolean |
Azt jelzi, hogy a csoport engedélyezve van-e. |
|
Biztonsági azonosító
|
value.securityIdentifier | string |
A csoport biztonsági azonosítója. |
|
Theme
|
value.theme | string |
A Microsoft Entra ID csoport témája. |
|
Láthatóság
|
value.visibility | string |
A csoport láthatósága. |
|
onPremisesProvisioningErrors
|
value.onPremisesProvisioningErrors | array of |
A csoport helyszíni kiépítési hibái. |
Csoporttulajdonságok lekérése
Microsoft Entra ID-csoport tulajdonságainak és kapcsolatainak lekérése
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
A Microsoft Entra ID csoport objektumazonosítója
|
group-id | True | string |
A Microsoft Entra ID csoport objektumazonosítója |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Odata-környezet
|
@odata.context | string |
Az Odata.context hivatkozás. |
|
azonosító
|
id | string |
A csoport objektumazonosítója |
|
Törölt dátum időpontja
|
deletedDateTime | string |
Csoport törlési dátuma |
|
Classification
|
classification | string |
osztályozás |
|
Létrehozás dátuma
|
createdDateTime | string |
A csoport létrehozási dátuma |
|
creationOptions
|
creationOptions | array of string |
A csoport beállításainak létrehozása. |
|
Description
|
description | string |
leírás |
|
Megjelenítendő név
|
displayName | string |
Csoport megjelenítendő neve |
|
Lejárati dátum időpontja
|
expirationDateTime | string |
Csoport lejárati dátuma |
|
groupTypes
|
groupTypes | array of string |
Csoporttípusok a csoporthoz. |
|
Szerepkörhöz rendelhető
|
isAssignableToRole | string |
Hozzárendelhető egy szerepkör ehhez a csoporthoz? |
|
Levél
|
string |
Csoport e-mail-címe |
|
|
Levelezés engedélyezve
|
mailEnabled | boolean |
Engedélyezve van a csoportos e-mail-cím? |
|
Levelezési nick neve
|
mailNickname | string |
Csoport e-mail-neve |
|
Tagsági szabály
|
membershipRule | string |
A tagság kiértékelésére használt szabály. |
|
Tagsági szabály feldolgozási állapota
|
membershipRuleProcessingState | string |
A tagság kiértékelésére használt szabály feldolgozási állapota. |
|
OnPremises tartománynév
|
onPremisesDomainName | string |
A helyszíni tartományFQDN-t, más néven dnsDomainName-t tartalmazza, amely a helyszíni címtárból van szinkronizálva. |
|
OnPremises Last Sync Date Time
|
onPremisesLastSyncDateTime | string |
Az az időpont és dátum, amikor a bérlő utoljára szinkronizálva lett a helyszíni címtárral. |
|
OnPremises NetBios Name
|
onPremisesNetBiosName | string |
A helyszíni kiszolgáló hálózati szolgáltatásának neve. |
|
OnPremises Sam-fiók neve
|
onPremisesSamAccountName | string |
Sam-fiók neve a helyszíni címtárhoz. |
|
OnPremises biztonsági azonosító
|
onPremisesSecurityIdentifier | string |
A helyszíni biztonsági azonosító. |
|
OnPremises Sync Enabled
|
onPremisesSyncEnabled | boolean |
Igaz, ha a helyszíni szinkronizálás engedélyezve van a csoport számára. |
|
Előnyben részesített adathely
|
preferredDataLocation | string |
A csoport elsődleges adathelye. |
|
Előnyben részesített nyelv
|
preferredLanguage | string |
Előnyben részesített nyelv a Microsoft Entra-azonosítóban konfigurált módon. |
|
proxi címek
|
proxyAddresses | array of string |
A csoport proxycímei. |
|
Megújított dátum időpontja
|
renewedDateTime | string |
A csoport megújított dátumideje. |
|
resourceBehaviorOptions
|
resourceBehaviorOptions | array of string |
A csoport erőforrás-viselkedési beállításai. |
|
resourceProvisioningOptions
|
resourceProvisioningOptions | array of string |
A csoport erőforrás-kiépítési beállításai. |
|
A biztonság engedélyezve
|
securityEnabled | boolean |
Azt jelzi, hogy a csoport engedélyezve van-e. |
|
Biztonsági azonosító
|
securityIdentifier | string |
A csoport biztonsági azonosítója. |
|
Theme
|
theme | string |
A Microsoft Entra ID csoport témája. |
|
Láthatóság
|
visibility | string |
A csoport láthatósága. |
|
onPremisesProvisioningErrors
|
onPremisesProvisioningErrors | array of string |
A csoport helyszíni kiépítési hibái. |
Előfizetett termékváltozatok listázása
A szervezet előfizetett licenccsomagjának termékváltozatai
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Odata-környezet
|
@odata.context | string |
Az Odata.context hivatkozás. |
|
value
|
value | array of object |
value |
|
Képesség állapota
|
value.capabilityStatus | string |
Termékváltozat képességállapota |
|
Felhasznált egységek
|
value.consumedUnits | integer |
Hány termékváltozatot használ már fel a rendszer? |
|
azonosító
|
value.id | string |
azonosító |
|
Termékváltozat azonosítója
|
value.skuId | string |
Termékváltozat globális egyedi azonosítója |
|
Termékváltozat cikkszáma
|
value.skuPartNumber | string |
A termékváltozat neve |
|
A következőkre vonatkozik:
|
value.appliesTo | string |
Kire vonatkozik a termékváltozat? |
|
Enabled
|
value.prepaidUnits.enabled | integer |
Engedélyezett egységek |
|
Felfüggesztett
|
value.prepaidUnits.suspended | integer |
Felfüggesztett egységek |
|
Figyelmeztetés
|
value.prepaidUnits.warning | integer |
Egységek figyelmeztetésben |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
előfizetési állapot
|
value.servicePlans.provisioningStatus | string |
előfizetési állapot |
|
vonatkozik
|
value.servicePlans.appliesTo | string |
vonatkozik |
Felhasználók listázása
A szervezet összes felhasználójának lekérése (Microsoft Entra ID-bérlő)
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
@odata.context
|
@odata.context | string |
Az Odata.context hivatkozás. |
|
value
|
value | array of object |
value |
|
businessPhone-ok
|
value.businessPhones | array of string |
businessPhone-ok |
|
Megjelenítendő név
|
value.displayName | string |
A felhasználó teljes neve |
|
Utónév
|
value.givenName | string |
Felhasználó utóneve |
|
Beosztás
|
value.jobTitle | string |
A felhasználó beosztása |
|
Levél
|
value.mail | string |
Felhasználó e-mail-címe |
|
Mobiltelefonszám
|
value.mobilePhone | string |
Felhasználó mobiltelefonja |
|
Az Office helye
|
value.officeLocation | string |
A felhasználó irodájának helye |
|
Előnyben részesített nyelv
|
value.preferredLanguage | string |
A felhasználó által előnyben részesített nyelv |
|
Surname
|
value.surname | string |
Felhasználó vezetékneve |
|
Felhasználói főnév
|
value.userPrincipalName | string |
A felhasználó egyszerű neve |
|
azonosító
|
value.id | string |
A felhasználó objektumazonosítója |
Közvetlen csoporttagok listázása
Egy számmal rendelkező csoport közvetlen tagjainak lekérése
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
A Microsoft Entra ID csoport objektumazonosítója
|
group-id | True | string |
A Microsoft Entra ID csoport objektumazonosítója |
|
Szűrés a következő szerint:
|
$filter | string |
Szűrés a következő szerint: |
|
|
Adatpont (oszlop) kiválasztása
|
$select | string |
Válassza ki a lekérni kívánt oszlopokat |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Odata-környezet
|
@odata.context | string |
Az Odata.context hivatkozás. |
|
Odata darabszáma
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Odata típusa
|
value.@odata.type | string |
@odata.type |
|
Megjelenítendő név
|
value.displayName | string |
A tag teljes neve |
|
Felhasználói főnév
|
value.userPrincipalName | string |
A tag felhasználóneve |
|
azonosító
|
value.id | string |
A tag objektumazonosítója |
|
Beosztás
|
value.jobTitle | string |
munkakör megnevezése |
|
Levelezési nick neve
|
value.mailNickname | string |
A tag e-mail-címe |
|
Levél
|
value.mail | string |
A tag e-mail-címe |
|
Utónév
|
value.givenName | string |
Tag utóneve |
|
Surname
|
value.surname | string |
A tag vezetékneve |
|
businessPhone-ok
|
value.businessPhones | array of string |
businessPhone-ok |
|
Mobiltelefonszám
|
value.mobilePhone | string |
mobiltelefon |
|
Az Office helye
|
value.officeLocation | string |
officeLocation |
|
Előnyben részesített nyelv
|
value.preferredLanguage | string |
Előnyben részesített nyelv a Microsoft Entra-azonosítóban konfigurált módon. |
Tagcsoportok lekérése
Csoporttagságok egy felhasználóhoz (taghoz)
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
A Microsoft Entra ID-tag(felhasználó) objektumazonosítója
|
member-id | True | string |
A Microsoft Entra ID-tag(felhasználó) objektumazonosítója |
|
Csak a biztonság engedélyezett (igaz/hamis)
|
securityEnabledOnly | True | boolean |
Csak a biztonsági csoportokat szeretné lekérni? |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Odata-környezet
|
@odata.context | string |
Az Odata.context hivatkozás. |
|
value
|
value | array of string |
value |
Taglicencek adatainak lekérése
Csoporttag(felhasználó) licencadatainak lekérése
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
A Microsoft Entra ID-tag(felhasználó) objektumazonosítója
|
id | True | string |
A Microsoft Entra ID-tag(felhasználó) objektumazonosítója |
|
Adatpontok(oszlopok) kiválasztása
|
$select | string |
Adatpontok(oszlopok) kiválasztása |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Odata-környezet
|
@odata.context | string |
Az Odata.context hivatkozás. |
|
value
|
value | array of object |
value |
|
azonosító
|
value.id | string |
azonosító |
|
Termékváltozat azonosítója
|
value.skuId | string |
Az termékváltozat azonosítója. |
|
Termékváltozat cikkszáma
|
value.skuPartNumber | string |
A termékváltozat neve |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
előfizetési állapot
|
value.servicePlans.provisioningStatus | string |
előfizetési állapot |
|
vonatkozik
|
value.servicePlans.appliesTo | string |
vonatkozik |