Remove-EntraDirectoryRoleDefinition

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

Eliminar um objeto roleDefinition do diretório Microsoft Entra ID.

Sintaxe

Default (Predefinição) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Descrição

Eliminar um objeto roleDefinition do diretório Microsoft Entra ID por ID.

Não é possível eliminar funções predefinidas. Esta funcionalidade requer uma licença Microsoft Entra ID P1 ou P2.

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 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 do Microsoft Entra ID.

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

Parâmetros

-UnifiedRoleDefinitionId

O identificador único de um objeto no Microsoft Entra ID.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

(All)
Posto:0
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.

Entradas

System.String

Saídas

System.Object

Notas

Remove-EntraRoleDefinition é um alias para Remove-EntraDirectoryRoleDefintion.