New-AzureADMSRoleAssignment

この記事では、New-AzureADMSRoleAssignment コマンドから Microsoft Graph PowerShell への移行の詳細について説明します。

まとめ

アクセス許可

ディレクトリ (Microsoft Entra ID) プロバイダーの場合

アクセス許可の種類 アクセス許可 (最小権限から最大権限まで)
委任済み (職場または学校アカウント) RoleManagement.ReadWrite.Directory
委任済み (個人用 Microsoft アカウント) サポートされていません。
Application RoleManagement.ReadWrite.Directory

エンタイトルメント管理プロバイダーの場合

アクセス許可の種類 アクセス許可 (最小権限から最大権限まで)
委任済み (職場または学校アカウント) EntitlementManagement.ReadWrite.All
委任済み (個人用 Microsoft アカウント) サポートされていません。
Application EntitlementManagement.ReadWrite.All

プロパティ マッピング

Azure AD 名 Microsoft Graph 名
DirectoryScopeId DirectoryScopeId
PrincipalId PrincipalId
RoleDefinitionId RoleDefinitionId

注意

unifiedRoleAssignment を作成するときに、次のプロパティを指定できます。

プロパティ Type 説明
appScopeId String 必須。 割り当てスコープがアプリ固有の場合のアプリ固有のスコープの識別子。 割り当てのスコープによって、プリンシパルにアクセス権が付与されているリソースのセットが決まります。 アプリ スコープは、リソース アプリケーションによってのみ定義および理解されるスコープです。

エンタイトルメント管理プロバイダーの場合は、このプロパティを使用してカタログ (例: /AccessPackageCatalog/beedadfe-01d5-4025-910b-84abb9369997) を指定します。

appScopeId または directoryScopeId を指定する必要があります。
directoryScopeId String 必須。 割り当てのスコープを表す ディレクトリ オブジェクト の識別子。 割り当てのスコープによって、プリンシパルにアクセス権が付与されているリソースのセットが決まります。 ディレクトリ スコープは、リソース アプリケーションのみが定義して理解するアプリ スコープとは異なり、複数のアプリケーションで認識されるディレクトリに格納されている共有スコープです。

ディレクトリ (Microsoft Entra ID) プロバイダーの場合、このプロパティは次の形式をサポートします。
  • / テナント全体のスコープの場合
  • /administrativeUnits/{administrativeunit-ID} 管理単位にスコープを設定する
  • /{application-objectID} リソース アプリケーションにスコープを設定する

    エンタイトルメント管理プロバイダーの場合は、 / テナント全体のスコープです。 アクセス パッケージ カタログのスコープを設定するには、 appScopeId プロパティを使用します。

    appScopeId または directoryScopeId を指定する必要があります。
  • principalId String 必須。 割り当てが付与されるプリンシパルの識別子。
    roleDefinitionId 文字列 割り当てが対象の unifiedRoleDefinition の識別子。 読み取り専用です。 (eqin) をサポートします$filter