Groupes et utilisateurs MS Graph
Le connecteur Groupes et utilisateurs MS Graph permet de récupérer les groupes d’ID Microsoft Entra, les membres (utilisateurs) et les détails de la licence
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Jay Jani, Microsoft |
| Messagerie électronique | jayjani@microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Jay Jani |
| Site internet | https://graph.microsoft.com |
| Politique de confidentialité | https://privacy.microsoft.com/en-us/privacystatement |
| Catégories | Opérations informatiques ; Données |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Obtenir des groupes de membres |
Appartenances de groupe pour un utilisateur (membre) |
| Obtenir les détails de la licence membre |
Récupérer les détails de la licence du membre du groupe (utilisateur) |
| Obtenir les propriétés du groupe |
Récupérer les propriétés et les relations d’un groupe d’ID Microsoft Entra |
| Répertorier les groupes par recherche de noms complets |
Récupérer des groupes en recherchant le nom d’affichage du groupe |
| Répertorier les membres du groupe direct |
Récupérer des membres directs d’un groupe avec le nombre |
| Répertorier les références SKU abonnées |
Détails des références SKU du plan de licence abonné de l’organisation |
| Répertorier les utilisateurs |
Récupérer tous les utilisateurs de l’organisation (locataire Microsoft Entra ID) |
Obtenir des groupes de membres
Appartenances de groupe pour un utilisateur (membre)
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’objet du membre Microsoft Entra ID(utilisateur)
|
member-id | True | string |
ID d’objet du membre Microsoft Entra ID(utilisateur) |
|
Sécurité activée uniquement (true/false)
|
securityEnabledOnly | True | boolean |
Voulez-vous récupérer uniquement les groupes activés pour la sécurité ? |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Contexte Odata
|
@odata.context | string |
Lien Odata.context. |
|
value
|
value | array of string |
value |
Obtenir les détails de la licence membre
Récupérer les détails de la licence du membre du groupe (utilisateur)
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’objet du membre Microsoft Entra ID(utilisateur)
|
id | True | string |
ID d’objet du membre Microsoft Entra ID(utilisateur) |
|
Sélection de points de données(colonnes)
|
$select | string |
Sélection de points de données(colonnes) |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Contexte Odata
|
@odata.context | string |
Lien Odata.context. |
|
value
|
value | array of object |
value |
|
ID
|
value.id | string |
pièce d'identité |
|
ID de l’UGS
|
value.skuId | string |
ID de la référence SKU. |
|
Numéro de partie de référence SKU
|
value.skuPartNumber | string |
Nom du SKU |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisionnementÉtat
|
value.servicePlans.provisioningStatus | string |
provisionnementÉtat |
|
s’appliqueÀ
|
value.servicePlans.appliesTo | string |
s’appliqueÀ |
Obtenir les propriétés du groupe
Récupérer les propriétés et les relations d’un groupe d’ID Microsoft Entra
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’objet du groupe Microsoft Entra ID
|
group-id | True | string |
ID d’objet du groupe Microsoft Entra ID |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Contexte Odata
|
@odata.context | string |
Lien Odata.context. |
|
ID
|
id | string |
ID d’objet du groupe |
|
Heure de la date supprimée
|
deletedDateTime | string |
Date de suppression du groupe |
|
Classification
|
classification | string |
classification |
|
Date de création
|
createdDateTime | string |
Heure de création du groupe |
|
creationOptions
|
creationOptions | array of string |
Options créées du groupe. |
|
Descriptif
|
description | string |
descriptif |
|
Nom d’affichage
|
displayName | string |
Nom complet du groupe |
|
Date d’expiration heure
|
expirationDateTime | string |
Heure d’expiration du groupe |
|
groupTypes
|
groupTypes | array of string |
Types de groupe pour le groupe. |
|
Est assignable au rôle
|
isAssignableToRole | string |
Un rôle peut-il être affecté à ce groupe ? |
|
Mail
|
string |
E-mail du groupe |
|
|
Courrier activé
|
mailEnabled | boolean |
La messagerie de groupe est-elle activée ? |
|
Mail Nick Name
|
mailNickname | string |
Nom de l’adresse e-mail du groupe |
|
Règle d’appartenance
|
membershipRule | string |
Règle utilisée pour l’évaluation de l’appartenance. |
|
État de traitement des règles d’appartenance
|
membershipRuleProcessingState | string |
État de traitement de la règle utilisée pour l’évaluation de l’appartenance. |
|
Nom de domaine OnPremises
|
onPremisesDomainName | string |
Contient le nom de domaineFQDN local, également appelé dnsDomainName synchronisé à partir du répertoire local. |
|
Heure de la date de la dernière synchronisation onPremises
|
onPremisesLastSyncDateTime | string |
Heure et date à laquelle le locataire a été synchronisé pour la dernière fois avec le répertoire local. |
|
Nom OnPremises NetBios
|
onPremisesNetBiosName | string |
Nom du service de mise en réseau pour le serveur local. |
|
Nom du compte OnPremises Sam
|
onPremisesSamAccountName | string |
Nom du compte Sam pour l’annuaire local. |
|
Identificateur de sécurité OnPremises
|
onPremisesSecurityIdentifier | string |
Identificateur de sécurité local. |
|
OnPremises Sync Enabled
|
onPremisesSyncEnabled | boolean |
True si la synchronisation locale est activée pour le groupe. |
|
Emplacement de données préféré
|
preferredDataLocation | string |
Emplacement de données préféré du groupe. |
|
Langue préférée
|
preferredLanguage | string |
Langage préféré tel qu’il est configuré dans l’ID Microsoft Entra. |
|
proxyAddresses
|
proxyAddresses | array of string |
Adresses proxy du groupe. |
|
Heure de renouvellement de la date
|
renewedDateTime | string |
Date renouvelée du groupe. |
|
resourceBehaviorOptions
|
resourceBehaviorOptions | array of string |
Options de comportement des ressources du groupe. |
|
resourceProvisioningOptions
|
resourceProvisioningOptions | array of string |
Options d’approvisionnement des ressources du groupe. |
|
Sécurité activée
|
securityEnabled | boolean |
Indique si le groupe est activé pour la sécurité. |
|
Identificateur de sécurité
|
securityIdentifier | string |
Identificateur de sécurité du groupe. |
|
Thème
|
theme | string |
Thème du groupe Microsoft Entra ID. |
|
Visibilité
|
visibility | string |
Visibilité du groupe. |
|
onPremisesProvisioningErrors
|
onPremisesProvisioningErrors | array of string |
Erreurs d’approvisionnement locales du groupe. |
Répertorier les groupes par recherche de noms complets
Récupérer des groupes en recherchant le nom d’affichage du groupe
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Rechercher par nom complet
|
$search | string |
Rechercher par mot clé dans le nom complet du groupe Microsoft Entra ID |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Contexte Odata
|
@odata.context | string |
Lien Odata.context. |
|
Nombre de groupes
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
ID
|
value.id | string |
ID d’objet du groupe |
|
Heure de la date supprimée
|
value.deletedDateTime | string |
Date et heure de la suppression de groupe |
|
Classification
|
value.classification | string |
Classification du groupe |
|
Date de création
|
value.createdDateTime | string |
Date et heure de la création du groupe |
|
creationOptions
|
value.creationOptions | array of |
Options créées du groupe. |
|
Descriptif
|
value.description | string |
Description du groupe |
|
Nom d’affichage
|
value.displayName | string |
Nom complet du groupe |
|
Date d’expiration heure
|
value.expirationDateTime | string |
Heure d’expiration du groupe |
|
groupTypes
|
value.groupTypes | array of string |
Types de groupe pour le groupe. |
|
Est assignable au rôle
|
value.isAssignableToRole | string |
Un rôle peut-il être affecté à ce groupe ? |
|
Mail
|
value.mail | string |
E-mail du groupe |
|
Courrier activé
|
value.mailEnabled | boolean |
La messagerie de groupe est-elle activée ? |
|
Mail Nick Name
|
value.mailNickname | string |
Nom de l’adresse e-mail du groupe |
|
Règle d’appartenance
|
value.membershipRule | string |
Règle utilisée pour l’évaluation de l’appartenance. |
|
État de traitement des règles d’appartenance
|
value.membershipRuleProcessingState | string |
État de traitement de la règle utilisée pour l’évaluation de l’appartenance. |
|
Nom de domaine OnPremises
|
value.onPremisesDomainName | string |
Contient le nom de domaineFQDN local, également appelé dnsDomainName synchronisé à partir du répertoire local. |
|
Heure de la date de la dernière synchronisation onPremises
|
value.onPremisesLastSyncDateTime | string |
Heure et date à laquelle le locataire a été synchronisé pour la dernière fois avec le répertoire local. |
|
Nom OnPremises NetBios
|
value.onPremisesNetBiosName | string |
Nom du service de mise en réseau pour le serveur local. |
|
Nom du compte OnPremises Sam
|
value.onPremisesSamAccountName | string |
Nom du compte Sam pour l’annuaire local. |
|
Identificateur de sécurité OnPremises
|
value.onPremisesSecurityIdentifier | string |
Identificateur de sécurité local. |
|
OnPremises Sync Enabled
|
value.onPremisesSyncEnabled | boolean |
True si la synchronisation locale est activée pour le groupe. |
|
Emplacement de données préféré
|
value.preferredDataLocation | string |
Emplacement de données préféré du groupe. |
|
Langue préférée
|
value.preferredLanguage | string |
Langage préféré tel qu’il est configuré dans l’ID Microsoft Entra. |
|
proxyAddresses
|
value.proxyAddresses | array of string |
Adresses proxy du groupe. |
|
Heure de renouvellement de la date
|
value.renewedDateTime | string |
Date renouvelée du groupe. |
|
resourceBehaviorOptions
|
value.resourceBehaviorOptions | array of |
Options de comportement des ressources du groupe. |
|
resourceProvisioningOptions
|
value.resourceProvisioningOptions | array of string |
Options d’approvisionnement des ressources du groupe. |
|
Sécurité activée
|
value.securityEnabled | boolean |
Indique si le groupe est activé pour la sécurité. |
|
Identificateur de sécurité
|
value.securityIdentifier | string |
Identificateur de sécurité du groupe. |
|
Thème
|
value.theme | string |
Thème du groupe Microsoft Entra ID. |
|
Visibilité
|
value.visibility | string |
Visibilité du groupe. |
|
onPremisesProvisioningErrors
|
value.onPremisesProvisioningErrors | array of |
Erreurs d’approvisionnement locales du groupe. |
Répertorier les membres du groupe direct
Récupérer des membres directs d’un groupe avec le nombre
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’objet du groupe Microsoft Entra ID
|
group-id | True | string |
ID d’objet du groupe Microsoft Entra ID |
|
Filtrer par
|
$filter | string |
Filtrer par |
|
|
Sélection de point de données (colonne)
|
$select | string |
Sélectionner les colonnes à récupérer |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Contexte Odata
|
@odata.context | string |
Lien Odata.context. |
|
Nombre Odata
|
@odata.count | integer |
@odata.count |
|
value
|
value | array of object |
value |
|
Odata Type
|
value.@odata.type | string |
@odata.type |
|
Nom d’affichage
|
value.displayName | string |
Nom complet du membre |
|
Nom d’utilisateur principal
|
value.userPrincipalName | string |
Nom d’utilisateur principal du membre |
|
ID
|
value.id | string |
ID d’objet du membre |
|
Poste
|
value.jobTitle | string |
Intitulé du poste |
|
Mail Nick Name
|
value.mailNickname | string |
Nom du nick de l’e-mail du membre |
|
Mail
|
value.mail | string |
E-mail du membre |
|
Prénom
|
value.givenName | string |
Prénom du membre |
|
Surname
|
value.surname | string |
Nom du membre |
|
businessPhones
|
value.businessPhones | array of string |
businessPhones |
|
Téléphone mobile
|
value.mobilePhone | string |
mobilePhone |
|
Emplacement du bureau
|
value.officeLocation | string |
officeLocation |
|
Langue préférée
|
value.preferredLanguage | string |
Langage préféré tel qu’il est configuré dans l’ID Microsoft Entra. |
Répertorier les références SKU abonnées
Détails des références SKU du plan de licence abonné de l’organisation
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Contexte Odata
|
@odata.context | string |
Lien Odata.context. |
|
value
|
value | array of object |
value |
|
État de la fonctionnalité
|
value.capabilityStatus | string |
État des capacités de la référence SKU |
|
Unités consommées
|
value.consumedUnits | integer |
Combien d’unités de référence SKU sont déjà consommées ? |
|
ID
|
value.id | string |
pièce d'identité |
|
ID de l’UGS
|
value.skuId | string |
Identificateur unique global de la référence SKU |
|
Numéro de partie de référence SKU
|
value.skuPartNumber | string |
Nom du SKU |
|
S’applique à
|
value.appliesTo | string |
À qui la référence SKU s’applique-t-elle ? |
|
Enabled
|
value.prepaidUnits.enabled | integer |
Unités activées |
|
Interrompu
|
value.prepaidUnits.suspended | integer |
Unités suspendues |
|
Avertissement
|
value.prepaidUnits.warning | integer |
Unités dans l’avertissement |
|
servicePlans
|
value.servicePlans | array of object |
servicePlans |
|
servicePlanId
|
value.servicePlans.servicePlanId | string |
servicePlanId |
|
servicePlanName
|
value.servicePlans.servicePlanName | string |
servicePlanName |
|
provisionnementÉtat
|
value.servicePlans.provisioningStatus | string |
provisionnementÉtat |
|
s’appliqueÀ
|
value.servicePlans.appliesTo | string |
s’appliqueÀ |
Répertorier les utilisateurs
Récupérer tous les utilisateurs de l’organisation (locataire Microsoft Entra ID)
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
@odata.context
|
@odata.context | string |
Lien Odata.context. |
|
value
|
value | array of object |
value |
|
businessPhones
|
value.businessPhones | array of string |
businessPhones |
|
Nom d’affichage
|
value.displayName | string |
Nom complet de l’utilisateur |
|
Prénom
|
value.givenName | string |
Prénom de l’utilisateur |
|
Poste
|
value.jobTitle | string |
Titre du travail de l’utilisateur |
|
Mail
|
value.mail | string |
E-mail de l’utilisateur |
|
Téléphone mobile
|
value.mobilePhone | string |
Téléphone mobile de l’utilisateur |
|
Emplacement du bureau
|
value.officeLocation | string |
Emplacement du bureau de l’utilisateur |
|
Langue préférée
|
value.preferredLanguage | string |
Langue préférée de l’utilisateur |
|
Surname
|
value.surname | string |
Nom de l’utilisateur |
|
Nom d’utilisateur principal
|
value.userPrincipalName | string |
Nom principal de l’utilisateur |
|
ID
|
value.id | string |
ID d’objet de l’utilisateur |