Remove-EntraDirectoryRoleMember

Hiermee verwijdert u een lid van een directoryrol.

Syntax

Default (Standaard)

Remove-EntraDirectoryRoleMember

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

Description

De Remove-EntraDirectoryRoleMember cmdlet verwijdert een lid uit een maprol in Microsoft Entra ID.

In gedelegeerde scenario's moet de aangemelde gebruiker beschikken over een ondersteunde Microsoft Entra rol of een aangepaste rol met de benodigde machtigingen. De minimale rollen die vereist zijn voor deze bewerking zijn:

  • Bevoorrechte Rollenbeheerder

Voorbeelden

Voorbeeld 1: Een lid verwijderen uit een directoryrol

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

In dit voorbeeld wordt het opgegeven lid uit de opgegeven rol verwijderd.

  • -DirectoryRoleId - hiermee geeft u de unieke id (ObjectId) van de maprol van waaruit het lid wordt verwijderd.

  • -MemberId - geeft de unieke id (MemberId) op van het lid (gebruiker, groep of service-principal) dat moet worden verwijderd uit de opgegeven directoryrol.

Parameters

-DirectoryRoleId

Hiermee geeft u de object-id van een maprol in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-MemberId

Hiermee geeft u de object-id van een rollid.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.