Remove-EntraDirectoryRoleDefinition

Modul:
Microsoft.Entra.Governance Module v1.3

Löschen eines Microsoft Entra ID Directory roleDefinition-Objekts.

Syntax

Default (Standard) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Beschreibung

Löschen Eines Microsoft Entra ID Directory roleDefinition-Objekts nach ID.

Integrierte Rollen können nicht gelöscht werden. Dieses Feature erfordert eine Microsoft Entra ID P1- oder P2-Lizenz.

In delegierten Szenarien muss der angemeldete Benutzer entweder über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Die für diesen Vorgang erforderlichen Mindestrollen sind:

  • Administrator für privilegierte Rollen

Beispiele

Beispiel 1: Entfernen einer angegebenen Rollendefinition

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

In diesem Beispiel wird veranschaulicht, wie die angegebene Rollendefinition aus Microsoft Entra ID entfernt wird.

  • -UnifiedRoleDefinitionId der Parameter gibt die roleDefinition-Objekt-ID an.

Parameter

-UnifiedRoleDefinitionId

Der eindeutige Bezeichner eines Objekts in Microsoft Entra ID.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Id

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

System.String

Ausgaben

System.Object

Hinweise

Remove-EntraRoleDefinition ist ein Alias für Remove-EntraDirectoryRoleDefintion.