Get-EntraDirectoryRoleMember

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Obtient les membres d’un rôle d’annuaire.

Syntaxe

Default (Par défaut) 

Get-EntraDirectoryRoleMember

    -DirectoryRoleId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Description

L’applet Get-EntraDirectoryRoleMember de commande récupère les membres d’un rôle d’annuaire dans Microsoft Entra ID. Pour obtenir les membres d’un rôle d’annuaire spécifique, spécifiez le DirectoryRoleId. Utilisez l’applet Get-EntraDirectoryRole de commande pour obtenir la DirectoryRoleId valeur.

Dans les scénarios délégués avec des comptes professionnels ou scolaires, l’utilisateur connecté doit disposer d’un rôle de Microsoft Entra pris en charge ou d’un rôle personnalisé avec les autorisations nécessaires. Les rôles les moins privilégiés suivants sont pris en charge pour cette opération :

  • Administrateur d’utilisateurs
  • Administrateur du support technique
  • Administrateur de support de service
  • Administrateur de facturation
  • Lecteurs d’annuaire
  • Rédacteurs d'annuaires
  • Administrateur d’application
  • Lecteur de sécurité
  • Administrateur de la sécurité
  • Administrateur de rôle privilégié
  • Administrateur d’applications cloud

Exemples

Exemple 1 : Obtenir des membres par ID de rôle

Connect-Entra -Scopes 'RoleManagement.Read.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "displayName eq 'Helpdesk Administrator'"
Get-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id | Select Id, DisplayName, '@odata.type', CreatedDateTime

id                                   displayName     @odata.type            createdDateTime
--                                   -----------     -----------            ---------------
bbbbbbbb-7777-8888-9999-cccccccccccc Debra Berger    #microsoft.graph.user  10/7/2024 12:31:57 AM
cccccccc-2222-3333-4444-dddddddddddd Contoso Group   #microsoft.graph.group 11/12/2024 9:59:43 AM

Cet exemple récupère les membres du rôle spécifié.

  • -DirectoryRoleId spécifie l’ID de rôle d’annuaire.

Paramètres

-DirectoryRoleId

Spécifie l’ID d’un rôle d’annuaire dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId)

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Property

Spécifie les propriétés à retourner.

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Sélectionnez

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.