Remove-EntraDirectoryRoleDefinition

Modul:
Microsoft.Entra.Governance Module v1.3

Ta bort ett Microsoft Entra ID Directory roleDefinition-objekt.

Syntax

Default (Standard) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Description

Ta bort ett Microsoft Entra ID Directory roleDefinition-objekt efter ID.

Du kan inte ta bort inbyggda roller. Den här funktionen kräver en Microsoft Entra ID P1- eller P2-licens.

I delegerade scenarier måste den inloggade användaren ha antingen en Microsoft Entra roll som stöds eller en anpassad roll med nödvändiga behörigheter. De minsta roller som krävs för den här åtgärden är:

  • Privilegierad rolladministratör

Exempel

Exempel 1: Ta bort en angiven rolldefinition

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

Det här exemplet visar hur du tar bort den angivna rolldefinitionen från Microsoft Entra ID.

  • -UnifiedRoleDefinitionId parameter anger roleDefinition-objekt-ID.

Parametrar

-UnifiedRoleDefinitionId

Den unika identifieraren för ett objekt i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Id

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

System.String

Utdata

System.Object

Kommentarer

Remove-EntraRoleDefinition är ett alias för Remove-EntraDirectoryRoleDefintion.