Remove-EntraDirectoryRoleDefinition

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

Elimine un objeto Microsoft Entra ID Directory roleDefinition.

Sintaxis

Default (valor predeterminado) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Description

Elimine un objeto Microsoft Entra ID Directory roleDefinition por identificador.

No puede eliminar roles integrados. Esta característica requiere una licencia Microsoft Entra ID P1 o P2.

En escenarios delegados, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Los roles mínimos necesarios para esta operación son:

  • Administrador de roles con privilegios

Ejemplos

Ejemplo 1: Quitar una definición de rol especificada

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

En este ejemplo se muestra cómo quitar la definición de rol especificada de Microsoft Entra ID.

  • -UnifiedRoleDefinitionId parameter especifica el identificador de objeto roleDefinition.

Parámetros

-UnifiedRoleDefinitionId

Identificador único de un objeto en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Id

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

System.String

Salidas

System.Object

Notas

Remove-EntraRoleDefinition es un alias de Remove-EntraDirectoryRoleDefintion.