Add-EntraDirectoryRoleMember

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Ajoute un membre à un rôle d’annuaire.

Syntaxe

Default (Par défaut) 

Add-EntraDirectoryRoleMember

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

Description

L’applet Add-EntraDirectoryRoleMember de commande ajoute un membre à un rôle Microsoft Entra ID.

Dans les scénarios délégués, l’utilisateur connecté doit avoir un rôle de Microsoft Entra pris en charge ou un rôle personnalisé avec les autorisations nécessaires. Les rôles minimaux requis pour cette opération sont les suivants :

  • Administrateur de rôle privilégié

Exemples

Exemple 1 : Ajouter un membre à un rôle Microsoft Entra ID

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "DisplayName eq 'Helpdesk Administrator'"
$user = Get-EntraUser -UserId 'SawyerM@Contoso.com'
Add-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id -MemberId $user.Id

Cet exemple montre comment ajouter un membre à un rôle d’annuaire.

  • DirectoryRoleId spécifie l’ID du rôle d’annuaire auquel le membre est ajouté. Utilisez la commande Get-EntraDirectoryRole pour récupérer les détails du rôle d’annuaire.
  • MemberIdspécifie l’ID de l’objet Microsoft Entra ID à affecter en tant que propriétaire/responsable/membre.

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

-MemberId

Spécifie l’ID de l’objet Microsoft Entra ID à attribuer en tant que propriétaire/responsable/membre.

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:RefObjectId

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

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.