Remove-EntraDirectoryRoleMember

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Supprime un membre d’un rôle d’annuaire.

Syntaxe

Default (Par défaut) 

Remove-EntraDirectoryRoleMember

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

Description

L’applet Remove-EntraDirectoryRoleMember de commande supprime un membre d’un rôle d’annuaire dans 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 : Supprimer un membre d’un rôle d’annuaire

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "displayName eq 'Helpdesk Administrator'"
$member = Get-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id | Select Id, DisplayName, '@odata.type' | Where-Object {$_.DisplayName -eq 'Sawyer Miller'}
Remove-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id -MemberId $member.Id

Cet exemple supprime le membre spécifié du rôle spécifié.

  • -DirectoryRoleId : spécifie l’identificateur unique (ObjectId) du rôle d’annuaire à partir duquel le membre sera supprimé.

  • -MemberId : spécifie l’identificateur unique (MemberId) du membre (utilisateur, groupe ou principal de service) à supprimer du rôle d’annuaire spécifié.

Paramètres

-DirectoryRoleId

Spécifie l’ID d’objet 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 d’objet d’un membre de rôle.

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

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.