Partager via

Get-MsolRoleMember

  • Référence
Module:
MSOnline

Obtient les membres d’un rôle.

Syntaxe

Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

L’applet de commande Get-MsolRoleMember obtient les membres du rôle spécifié.

Exemples

Exemple 1 : Obtenir les membres d’un rôle

PS C:\> $Role = Get-MsolRole -RoleName "%Role Name%"
PS C:\> $RoleMembers = Get-MsolRoleMember -RoleObjectId $Role.ObjectId

Cette commande retourne tous les membres du rôle spécifié. La commande stocke les résultats dans la variable $RoleMembers.

Paramètres

-All

Indique que cette applet de commande retourne tous les résultats qu’elle trouve. Ne spécifiez pas ce paramètre et le paramètre MaxResults .

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

-MaxResults

Spécifie le nombre maximal de résultats retournés par cette applet de commande. La valeur par défaut est 250.

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

-MemberObjectTypes

Spécifie un tableau de types d’objets membres.

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

-RoleObjectId

Spécifie l’ID unique du rôle à partir duquel supprimer des membres.

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

-SearchString

Spécifie une chaîne. Cette applet de commande retourne des objets avec un nom d’affichage ou une adresse e-mail qui commencent par cette chaîne. Chaîne sur laquelle effectuer une recherche.

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

-TenantId

Spécifie l’ID unique du locataire sur lequel effectuer l’opération. La valeur par défaut est le locataire de l’utilisateur actuel. Ce paramètre s’applique uniquement aux utilisateurs partenaires.

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

Sorties

Microsoft.Online.Administation.RoleMember

Cette applet de commande retourne des objets membres de rôle qui contiennent les informations suivantes :

  • DisplayName. nom complet du membre du rôle.

  • Emailaddress. adresse de messagerie du membre du rôle.

  • IsLicensed. indique si l'utilisateur dispose d'une licence ou non.

  • LastDirSyncTime. date et heure de la dernière synchronisation de ce membre.

  • Objectid. ID unique du membre.

  • OverallProvisioningStatus. état de configuration actuel de cet utilisateur.

  • RoleMemberType. Type de membre de rôle. Actuellement, seul « User » est pris en charge.

  • ValidationStatus. indique si ce membre du groupe présente des erreurs.