Remove-EntraDirectoryRoleMember

Modulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Rimuove un membro di un ruolo della directory.

Sintassi

Default (Impostazione predefinita) 

Remove-EntraDirectoryRoleMember

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

Descrizione

Il Remove-EntraDirectoryRoleMember cmdlet rimuove un membro da un ruolo della directory in Microsoft Entra ID.

Negli scenari delegati, l'utente connesso deve avere un ruolo di Microsoft Entra supportato o un ruolo personalizzato con le autorizzazioni necessarie. I ruoli minimi necessari per questa operazione sono:

  • Amministratore di ruolo privilegiato

Esempio

Esempio 1: Rimuovere un membro da un ruolo della directory

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 questo esempio viene rimosso il membro specificato dal ruolo specificato.

  • -DirectoryRoleId : specifica l'identificatore univoco (ObjectId) del ruolo della directory da cui verrà rimosso il membro.

  • -MemberId : specifica l'identificatore univoco (MemberId) del membro (utente, gruppo o entità servizio) che deve essere rimosso dal ruolo della directory specificato.

Parametri

-DirectoryRoleId

Specifica l'ID oggetto di un ruolo della directory in Microsoft Entra ID.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ObjectId

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-MemberId

Specifica l'ID oggetto di un membro del ruolo.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.