Remove-EntraDirectoryRoleMember

Moduł:
Microsoft.Entra.DirectoryManagement Module v1.3

Usuwa członka roli katalogu.

Składnia

Default (domyślnie) 

Remove-EntraDirectoryRoleMember

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

Opis

Polecenie Remove-EntraDirectoryRoleMember cmdlet usuwa element członkowski z roli katalogu w Microsoft Entra ID.

W scenariuszach delegowanych zalogowany użytkownik musi mieć obsługiwaną rolę Microsoft Entra lub rolę niestandardową z niezbędnymi uprawnieniami. Minimalne role wymagane dla tej operacji to:

  • Administrator ról uprzywilejowanych

Przykłady

Przykład 1. Usuwanie elementu członkowskiego z roli katalogu

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

W tym przykładzie określony element członkowski zostanie usunięty z określonej roli.

  • -DirectoryRoleId - określa unikatowy identyfikator (ObjectId) roli katalogu, z której element członkowski zostanie usunięty.

  • -MemberId - określa unikatowy identyfikator (MemberId) elementu członkowskiego (użytkownika, grupy lub jednostki usługi), który ma zostać usunięty z określonej roli katalogu.

Parametry

-DirectoryRoleId

Określa identyfikator obiektu roli katalogu w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-MemberId

Określa identyfikator obiektu elementu członkowskiego roli.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.