Wyświetlanie listy przypisań ról w usłudze Microsoft Entra

W tym artykule opisano sposób wyświetlania listy ról przypisanych w usłudze Microsoft Entra ID. W usłudze Microsoft Entra ID role można przypisywać w zakresie całej organizacji lub z zakresem pojedynczej aplikacji.

• Przypisania ról w zakresie całej organizacji są dodawane do i można je zobaczyć na liście przypisań ról pojedynczej aplikacji.
• Przypisania ról w zakresie pojedynczej aplikacji nie są dodawane do i nie można ich zobaczyć na liście przypisań obejmujących całą organizację.

Wymagania wstępne

• Moduł programu PowerShell programu Microsoft Graph podczas korzystania z programu PowerShell
• Zgoda administratora podczas korzystania z eksploratora programu Graph dla interfejsu Microsoft Graph API

Aby uzyskać więcej informacji, zobacz Wymagania wstępne dotyczące używania programu PowerShell lub Eksploratora programu Graph.

Centrum administracyjne Microsoft Entra

Napiwek

Kroki opisane w tym artykule mogą się nieznacznie różnić w zależności od portalu, od którego zaczynasz.

W tej procedurze opisano sposób wyświetlania listy przypisań ról z zakresem całej organizacji.

1. Zaloguj się do centrum administracyjnego usługi Microsoft Entra.

2. Przejdź do pozycji Role tożsamości>i administratorzy Role i administratorzy.>

3. Wybierz rolę, aby ją otworzyć i wyświetlić jej właściwości.

4. Wybierz pozycję Przypisania , aby wyświetlić listę przypisań ról.

   

Wyświetlanie listy przypisań ról

Można również łatwo wyświetlić własne uprawnienia. Wybierz swoją rolę na stronie Role i administratorzy , aby wyświetlić role, które są aktualnie przypisane do Ciebie.

Pobieranie przypisań ról

Aby pobrać wszystkie aktywne przypisania ról we wszystkich rolach, w tym wbudowane i niestandardowe role, wykonaj następujące kroki (obecnie w wersji zapoznawczej).

1. Na stronie Role i administratorzy wybierz pozycję Wszystkie role.

2. Wybierz pozycję Pobierz przypisania.

   Pobierany jest plik CSV, który zawiera listę przypisań we wszystkich zakresach dla wszystkich ról.

   

Aby pobrać wszystkie przypisania dla określonej roli, wykonaj następujące kroki.

1. Na stronie Role i administratorzy wybierz rolę.

2. Wybierz pozycję Pobierz przypisania.

   Plik CSV, który zawiera listę przypisań we wszystkich zakresach dla tej roli, jest pobierany.

   

Wyświetlanie listy przypisań ról z zakresem pojedynczej aplikacji

W tej sekcji opisano sposób wyświetlania listy przypisań ról z zakresem pojedynczej aplikacji. Ta funkcja jest obecnie w publicznej wersji zapoznawczej.

1. Zaloguj się do centrum administracyjnego usługi Microsoft Entra.

2. Przejdź do aplikacji tożsamości>> Rejestracje aplikacji.

3. Wybierz rejestrację aplikacji, aby wyświetlić jej właściwości. Może być konieczne wybranie pozycji Wszystkie aplikacje , aby wyświetlić pełną listę rejestracji aplikacji w organizacji firmy Microsoft Entra.

   

4. W rejestracji aplikacji wybierz pozycję Role i administratorzy, a następnie wybierz rolę, aby wyświetlić jej właściwości.

   

5. Wybierz pozycję Przypisania , aby wyświetlić listę przypisań ról. Otwarcie strony przypisania z poziomu rejestracji aplikacji pokazuje przypisania ról, które są ograniczone do tego zasobu Firmy Microsoft Entra.

   

PowerShell

W tej sekcji opisano wyświetlanie przypisań roli z zakresem całej organizacji. W tym artykule jest używany moduł Programu PowerShell programu Microsoft Graph. Aby wyświetlić przypisania zakresu pojedynczej aplikacji przy użyciu programu PowerShell, możesz użyć poleceń cmdlet w temacie Przypisywanie ról niestandardowych za pomocą programu PowerShell.

Użyj poleceń Get-MgRoleManagementDirectoryRoleDefinition i Get-MgRoleManagementDirectoryRoleAssignment, aby wyświetlić listę przypisań ról.

W poniższym przykładzie pokazano, jak wyświetlić listę przypisań ról dla roli Administrator grup.

# 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 aaaaaaaa-bbbb-cccc-1111-222222222222 62e90394-69f5-4237-9190-012177145e10 /
lAPpYvVpN0KRkAEhdxReEMdXLf2tIs1ClhpzQPsutrQ-1 bbbbbbbb-cccc-dddd-2222-333333333333 62e90394-69f5-4237-9190-012177145e10 /

W poniższym przykładzie pokazano, jak wyświetlić listę wszystkich aktywnych przypisań ról we wszystkich rolach, w tym wbudowanych i niestandardowych (obecnie w wersji zapoznawczej).

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

Id                                            PrincipalId                          RoleDefinitionId                     DirectoryScopeId AppScop
                                                                                                                                         eId
--                                            -----------                          ----------------                     ---------------- -------
lAPpYvVpN0KRkAEhdxReEH2Fs3EjKm1BvSKkcYVN2to-1 aaaaaaaa-bbbb-cccc-1111-222222222222 62e90394-69f5-4237-9190-012177145e10 /
lAPpYvVpN0KRkAEhdxReEMdXLf2tIs1ClhpzQPsutrQ-1 bbbbbbbb-cccc-dddd-2222-333333333333 62e90394-69f5-4237-9190-012177145e10 /
4-PYiFWPHkqVOpuYmLiHa3ibEcXLJYtFq5x3Kkj2TkA-1 cccccccc-dddd-eeee-3333-444444444444 88d8e3e3-8f55-4a1e-953a-9b9898b8876b /
4-PYiFWPHkqVOpuYmLiHa2hXf3b8iY5KsVFjHNXFN4c-1 dddddddd-eeee-ffff-4444-555555555555 88d8e3e3-8f55-4a1e-953a-9b9898b8876b /
BSub0kaAukSHWB4mGC_PModww03rMgNOkpK77ePhDnI-1 eeeeeeee-ffff-aaaa-5555-666666666666 d29b2b05-8046-44ba-8758-1e26182fcf32 /
BSub0kaAukSHWB4mGC_PMgzOWSgXj8FHusA4iaaTyaI-1 ffffffff-aaaa-bbbb-6666-777777777777 d29b2b05-8046-44ba-8758-1e26182fcf32 /

Interfejsu API programu Microsoft Graph

W tej sekcji opisano sposób wyświetlania listy przypisań ról z zakresem całej organizacji. Aby wyświetlić listę przypisań ról w zakresie pojedynczej aplikacji przy użyciu interfejsu API programu Graph, możesz użyć operacji w temacie Przypisywanie ról niestandardowych za pomocą interfejsu API programu Graph.

Użyj interfejsu API List unifiedRoleAssignments , aby uzyskać przypisania ról dla określonej definicji roli. W poniższym przykładzie pokazano, jak wyświetlić listę przypisań ról dla określonej definicji roli o identyfikatorze 00000000-0000-0000-0000-000000000000.

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": "C2dE3fH4iJ5kL6mN7oP8qR9sT0uV1wIiSDKQoTVJrLE9etXyrY0-1",
    "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
    "roleDefinitionId": "00000000-0000-0000-0000-000000000000",
    "directoryScopeId": "/"
}

Następne kroki

• Możesz się z nami podzielić na forum ról administracyjnych firmy Microsoft Entra.
• Aby uzyskać więcej informacji na temat uprawnień ról, zobacz Wbudowane role firmy Microsoft.
• Aby uzyskać domyślne uprawnienia użytkownika, zobacz porównanie domyślnych uprawnień gościa i użytkownika członkowskiego.