Microsoft Entra ロールの割り当てを一覧表示する

[アーティクル]
10/28/2023

この記事では、割り当てたロールを Microsoft Entra ID で一覧表示する方法について説明します。 Microsoft Entra ID では、ロールは、組織全体のスコープまたは単一アプリケーションのスコープで割り当てることができます。

組織全体のスコープでのロールの割り当ては、単一アプリケーションのロールの割り当ての一覧に追加され、そこで確認することができます。
単一アプリケーションのスコープでのロールの割り当ては、組織全体のスコープでの割り当ての一覧に追加されることはなく、そこで確認することもできません。

前提条件

Powershell を使用する際の Microsoft Graph PowerShell モジュール
Microsoft Graph API の Graph エクスプローラーを使用する場合の管理者の同意

詳細については、PowerShell または Graph エクスプローラーを使用するための前提条件に関するページを参照してください。

Microsoft Entra 管理センター

ヒント

この記事の手順は、開始するポータルに応じて若干異なる場合があります。

この手順では、組織全体のスコープでロールの割り当てを一覧表示する方法について説明します。

Microsoft Entra 管理センターにサインインします。
[ID]>[役割と管理者]>[役割と管理者] の順に移動します。
ロールを選択して開き、そのプロパティを表示します。
ロールの割り当てを一覧表示するには、 [割り当て] を選択します。

自分のロールの割り当てを一覧表示する

自分のアクセス許可も簡単に一覧表示することができます。 [ロールと管理者] ページの [ロール] を選択すると、現在自分に割り当てられているロールが表示されます。

List my role assignments

ロールの割り当てのダウンロード

組み込みとカスタムのロールを含むすべてのロールでアクティブなロールの割り当てをダウンロードするには、次の手順に従います (現在はプレビュー段階)。

[ロールと管理者] ページで、[すべてのロール] を選択します。
[Download assignments] (割り当てのダウンロード) を選択します。

すべてのロールのすべてのスコープでの割り当ての一覧を含む CSV ファイルがダウンロードされます。

特定のロールのすべての割り当てをダウンロードするには、次の手順に従います。

[ロールと管理者] ページでロールを選択します。
[Download assignments] (割り当てのダウンロード) を選択します。

そのロールのすべてのスコープでの割り当てを一覧表示する CSV ファイルがダウンロードされます。

単一アプリケーションのスコープでロールの割り当てを一覧表示する

このセクションでは、単一アプリケーションのスコープでロールの割り当てを一覧表示する方法について説明します。現在、この機能はパブリックプレビュー段階にあります。

Microsoft Entra 管理センターにサインインします。
[ID]>[アプリケーション]>[アプリの登録] を参照します。
アプリの登録を選択して、そのプロパティを表示します。 Microsoft Entra 組織内のアプリ登録の完全な一覧を表示するには、[すべてのアプリケーション] を選ぶ必要がある場合があります。
アプリの登録で、[ロールと管理者] を選択し、次にロールを選択してそのプロパティを表示します。
ロールの割り当てを一覧表示するには、 [割り当て] を選択します。アプリの登録内から [割り当て] ページを開くと、この Microsoft Entra リソースをスコープとしたロールの割り当てが表示されます。

PowerShell

このセクションでは、組織全体のスコープを使用してロールの割り当てを表示する方法について説明します。この記事では、Microsoft Graph PowerShell モジュールを使用します。 PowerShell を使用して単一アプリケーションのスコープを表示するには、PowerShell を使用したカスタムロールの割り当てに関するページのコマンドレットを使用できます。

Get-MgRoleManagementDirectoryRoleDefinition および Get-MgRoleManagementDirectoryRoleAssignment コマンドを使用して、ロールの割り当てをリストします。

次の例は、グループ管理者ロールに対するロールの割り当てを一覧表示する方法を示しています。

# Fetch list of all directory roles with template ID
Get-MgRoleManagementDirectoryRoleDefinition

# Fetch a specific directory role by ID
$role = Get-MgRoleManagementDirectoryRoleDefinition -UnifiedRoleDefinitionId fdd7a751-b60b-444a-984c-02652fe8fa1c

# Fetch membership for a role
Get-MgRoleManagementDirectoryRoleAssignment -Filter "roleDefinitionId eq '$($role.Id)'"

Id                                            PrincipalId                          RoleDefinitionId                     DirectoryScopeId AppScop
                                                                                                                                         eId
--                                            -----------                          ----------------                     ---------------- -------
lAPpYvVpN0KRkAEhdxReEH2Fs3EjKm1BvSKkcYVN2to-1 71b3857d-2a23-416d-bd22-a471854ddada 62e90394-69f5-4237-9190-012177145e10 /
lAPpYvVpN0KRkAEhdxReEMdXLf2tIs1ClhpzQPsutrQ-1 fd2d57c7-22ad-42cd-961a-7340fb2eb6b4 62e90394-69f5-4237-9190-012177145e10 /

次の例は、組み込みとカスタムのロールを含む、すべてのロールのすべてのアクティブなロールの割り当てを一覧表示する方法 (現在はプレビュー段階) を示しています。

$roles = Get-MgRoleManagementDirectoryRoleDefinition
foreach ($role in $roles)
{
  Get-MgRoleManagementDirectoryRoleAssignment -Filter "roleDefinitionId eq '$($role.Id)'"
}

Id                                            PrincipalId                          RoleDefinitionId                     DirectoryScopeId AppScop
                                                                                                                                         eId
--                                            -----------                          ----------------                     ---------------- -------
lAPpYvVpN0KRkAEhdxReEH2Fs3EjKm1BvSKkcYVN2to-1 71b3857d-2a23-416d-bd22-a471854ddada 62e90394-69f5-4237-9190-012177145e10 /
lAPpYvVpN0KRkAEhdxReEMdXLf2tIs1ClhpzQPsutrQ-1 fd2d57c7-22ad-42cd-961a-7340fb2eb6b4 62e90394-69f5-4237-9190-012177145e10 /
4-PYiFWPHkqVOpuYmLiHa3ibEcXLJYtFq5x3Kkj2TkA-1 c5119b78-25cb-458b-ab9c-772a48f64e40 88d8e3e3-8f55-4a1e-953a-9b9898b8876b /
4-PYiFWPHkqVOpuYmLiHa2hXf3b8iY5KsVFjHNXFN4c-1 767f5768-89fc-4a8e-b151-631cd5c53787 88d8e3e3-8f55-4a1e-953a-9b9898b8876b /
BSub0kaAukSHWB4mGC_PModww03rMgNOkpK77ePhDnI-1 4dc37087-32eb-4e03-9292-bbede3e10e72 d29b2b05-8046-44ba-8758-1e26182fcf32 /
BSub0kaAukSHWB4mGC_PMgzOWSgXj8FHusA4iaaTyaI-1 2859ce0c-8f17-47c1-bac0-3889a693c9a2 d29b2b05-8046-44ba-8758-1e26182fcf32 /

Microsoft Graph API

このセクションでは、組織全体のスコープでロールの割り当てを一覧表示する方法について説明します。 Graph API を使用して単一アプリケーションのスコープのロールの割り当てを一覧表示するには、Graph API を使用したカスタムロールの割り当てに関するページの操作を使用できます。

特定のロールの定義に対するロールの割り当てを取得するには、List unifiedRoleAssignments API を使用します。次の例は、ID が 3671d40a-1aac-426c-a0c1-a3821ebd8218 である特定のロール定義に対するロールの割り当てを一覧表示する方法を示しています。

GET https://graph.microsoft.com/v1.0/roleManagement/directory/roleAssignments?$filter=roleDefinitionId eq ‘<template-id-of-role-definition>’

Response

HTTP/1.1 200 OK
{
    "id": "CtRxNqwabEKgwaOCHr2CGJIiSDKQoTVJrLE9etXyrY0-1",
    "principalId": "ab2e1023-bddc-4038-9ac1-ad4843e7e539",
    "roleDefinitionId": "3671d40a-1aac-426c-a0c1-a3821ebd8218",
    "directoryScopeId": "/"
}

次のステップ

Microsoft Entra 管理ロールフォーラムでお気軽にご意見をお寄せください。
ロールのアクセス許可の詳細については、「Microsoft Entra 組み込みロール」を参照してください。
既定のユーザーアクセス許可については、既定のゲストとメンバーユーザーのアクセス許可の比較を参照してください。