Remove-EntraDirectoryRoleDefinition

模組:
Microsoft.Entra.Governance Module v1.3

刪除 Microsoft Entra ID Directory roleDefinition 物件。

語法

Default (預設值) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

Description

依 ID 刪除 Microsoft Entra ID Directory roleDefinition 物件。

你無法刪除內建的角色。 此功能需取得 Microsoft Entra ID P1 或 P2 授權。

在委派情境中，登入使用者必須擁有支援的 Microsoft Entra 角色或具備必要權限的自訂角色。 此作業所需的最低角色包括：

  • 特殊權限角色管理員

範例

範例 1：移除指定的角色定義

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

此範例示範如何從 Microsoft Entra ID 中移除指定的角色定義。

  • -UnifiedRoleDefinitionId 參數指定 roleDefinition 物件 ID。

參數

-UnifiedRoleDefinitionId

Microsoft Entra ID 中物件的唯一識別碼。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:Id

參數集

(All)
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

System.String

輸出

System.Object

備註

Remove-EntraRoleDefinition 是 Remove-EntraDirectoryRoleDefintion 的別名。