Partager via


Select-AzureADGroupIdsUserIsMemberOf

Sélectionne les groupes dont un utilisateur est membre.

Syntaxe

Select-AzureADGroupIdsUserIsMemberOf
      -ObjectId <String>
      -GroupIdsForMembershipCheck <GroupIdsForMembershipCheck>
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

Description

L’applet de commande Select-AzureADGroupIdsUserIsMemberOf sélectionne les groupes dont un utilisateur est membre dans Azure Actve Directory (AD).

Exemples

Exemple 1 : Obtenir l’appartenance à un groupe d’un groupe pour un utilisateur

PS C:\> $Groups = New-Object Microsoft.Open.AzureAD.Model.GroupIdsForMembershipCheck
PS C:\> $Groups.GroupIds = (Get-AzureADGroup -Top 1).ObjectId
PS C:\> $UserID = (Get-AzureADUser -Top 1).ObjectId
PS C:\> Select-AzureADGroupIdsUserIsMemberOf  -ObjectId $UserId -GroupIdsForMembershipCheck $Groups

OdataMetadata                                                                                   Value
-------------                                                                                   -----
https://graph.windows.net/85b5ff1e-0402-400c-9e3c-0f9e965325d1/$metadata#Collection(Edm.String) {093fc0e2-1d6e-4a1b-9bf8-effa0196f1f7}

La première commande crée un objet GroupIdsForMembershipCheck, puis le stocke dans la variable $Groups.

La deuxième commande obtient un ID pour un groupe à l’aide de l’applet de commande Get-AzureADGroup (./Get-AzureADGroup.md), puis la stocke en tant que propriété de $Groups.

La troisième commande obtient l’ID d’un utilisateur à l’aide de l’applet de commande Get-AzureADUser (./Get-AzureADUser.md), puis la stocke dans la variable $UserId.

La commande finale obtient l’appartenance au groupe d’un groupe pour un utilisateur identifié par $UserId. Cette applet de commande retourne un objet oData. Pour rechercher les groupes dont cet utilisateur est membre, effectuez une itération au sein de l’attribut Value des objets oData retournés.

Paramètres

-GroupIdsForMembershipCheck

Spécifie un tableau d’ID d’objet de groupe.

Type:GroupIdsForMembershipCheck
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’informations. Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Inquire
  • SilentlyContinue
  • Arrêter
  • Interrompre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Alias:iv
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ObjectId

Spécifie l’ID d’un utilisateur (en tant qu’UPN ou ObjectId) dans Azure AD.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False