Remove-EntraDirectoryRoleMember

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Remove um membro de um papel de diretório.

Sintaxe

Default (Predefinição) 

Remove-EntraDirectoryRoleMember

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

Descrição

O Remove-EntraDirectoryRoleMember cmdlet remove um membro de um papel de diretório no Microsoft Entra ID.

Em cenários delegados, o utilizador iniciado deve ter um papel Microsoft Entra suportado ou um papel personalizado com as permissões necessárias. Os papéis mínimos exigidos para esta operação são:

  • Administrador de Função Privilegiada

Exemplos

Exemplo 1: Remover um membro de uma função de diretório

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

Este exemplo remove o membro especificado do papel especificado.

  • -DirectoryRoleId - especifica o identificador único (ObjectId) do papel de diretório do qual o membro será removido.

  • -MemberId - especifica o identificador único (MemberId) do membro (utilizador, grupo ou principal de serviço) que deve ser removido do papel de diretório especificado.

Parâmetros

-DirectoryRoleId

Especifica o ID de objeto de um papel de diretório no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-MemberId

Especifica o ID do objeto de um membro do papel.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.