Remove-EntraUserAppRoleAssignment

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

ユーザー アプリケーション ロールの割り当てを削除します。

構文

Default (既定) 

Remove-EntraUserAppRoleAssignment

    -AppRoleAssignmentId <String>
    -UserId <String>
    [<CommonParameters>]

説明

Remove-EntraUserAppRoleAssignment コマンドレットは、Microsoft Entra IDでユーザー アプリケーション ロールの割り当てを削除します。

職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールを持っている必要があります。 サポートされるロールは次のとおりです。

  • ディレクトリ同期アカウント (Entra Connect とクラウド同期用)
  • ディレクトリ ライター
  • ハイブリッド ID の管理者
  • アイデンティティガバナンス管理者
  • 特権ロール管理者
  • ユーザー管理者
  • アプリケーション管理者
  • クラウド アプリケーション管理者

例

例 1: ユーザー アプリ ロールの割り当てを削除する

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$assignment = Get-EntraUserAppRoleAssignment -UserId 'SawyerM@Contoso.com' |
Where-Object { $_.ResourceDisplayName -eq 'Helpdesk Application' -and $_.PrincipalType -eq 'User' }
Remove-EntraUserAppRoleAssignment -UserId 'SawyerM@Contoso.com' -AppRoleAssignmentId $assignment.Id

この例では、Microsoft Entra IDでユーザー アプリ ロールの割り当てを削除する方法を示します。

  • -UserId パラメーターはユーザー ID を指定します。
  • -AppRoleAssignmentId パラメーターは、アプリケーション ロールの割り当て ID を指定します。

Get-EntraUserAppRoleAssignment コマンドレットを使用して、AppRoleAssignmentIdの詳細を取得します。

パラメーター

-AppRoleAssignmentId

アプリケーション ロールの割り当ての ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

-UserId

Microsoft Entra IDのユーザーの ID (UserPrincipleName または ObjectId) を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子, UPN, アイデンティティ, ユーザープリンシパルネーム

パラメーター セット

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

CommonParameters

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