Remove-EntraDirectoryRoleDefinition

Moduł:
Microsoft.Entra.Governance Module v1.3

Usuń obiekt role Microsoft Entra ID DirectoryDefinition.

Składnia

Default (domyślnie) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Opis

Usuń obiekt role Microsoft Entra ID DirectoryDefinition według identyfikatora.

Nie można usunąć wbudowanych ról. Ta funkcja wymaga licencji Microsoft Entra ID P1 lub P2.

W scenariuszach delegowanych zalogowany użytkownik musi mieć obsługiwaną rolę Microsoft Entra lub rolę niestandardową z niezbędnymi uprawnieniami. Minimalne role wymagane dla tej operacji to:

  • Administrator ról uprzywilejowanych

Przykłady

Przykład 1. Usuwanie określonej definicji roli

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

W tym przykładzie pokazano, jak usunąć określoną definicję roli z Microsoft Entra ID.

  • -UnifiedRoleDefinitionId parametr określa identyfikator obiektu roleDefinition.

Parametry

-UnifiedRoleDefinitionId

Unikatowy identyfikator obiektu w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Id

Zestawy parametrów

(All)
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

System.String

Dane wyjściowe

System.Object

Notatki

Remove-EntraRoleDefinition to alias dla elementu Remove-EntraDirectoryRoleDefintion.