Remove-EntraDirectoryRoleDefinition

モジュール:
Microsoft.Entra.Governance Module v1.3

Microsoft Entra ID Directory roleDefinition オブジェクトを削除します。

構文

Default (既定) 

Remove-EntraDirectoryRoleDefinition

    -UnifiedRoleDefinitionId <String>
    [<CommonParameters>]

説明

Microsoft Entra ID Directory roleDefinition オブジェクトを ID で削除します。

組み込みのロールを削除することはできません。 この機能には、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
DontShow:False
Aliases:Id

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

System.String

出力

System.Object

メモ

Remove-EntraRoleDefinition は Remove-EntraDirectoryRoleDefintion の別名です。