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.