Remove-EntraDirectoryRoleDefinition

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

Exclua um objeto roleDefinition do Microsoft Entra ID Directory.

Sintaxe

Default (Default) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Description

Exclua um objeto roleDefinition do Microsoft Entra ID Directory por ID.

Não pode eliminar funções incorporadas. Esta funcionalidade requer uma licença P1 ou P2 Microsoft Entra ID.

Em cenários delegados, o usuário conectado deve ter uma função de Microsoft Entra com suporte ou uma função personalizada com as permissões necessárias. As funções mínimas necessárias para esta operação são:

  • Administrador de Função Privilégiada

Exemplos

Exemplo 1: remover uma definição de função especificada

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$role = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Contoso Custom Role Definition'"
Remove-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $role.Id

Este exemplo demonstra como remover a definição de função especificada de Microsoft Entra ID.

  • -UnifiedRoleDefinitionId o parâmetro especifica a ID do objeto roleDefinition.

Parâmetros

-UnifiedRoleDefinitionId

O identificador exclusivo de um objeto em Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ID

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Entradas

System.String

Saídas

System.Object

Observações

Remove-EntraRoleDefinition é um alias para Remove-EntraDirectoryRoleDefintion.