Zarządzanie rolami

Z tego artykułu dowiesz się, jak zarządzać rolami przy użyciu programu Microsoft Entra PowerShell. Rola w Microsoft Entra definiuje uprawnienia kontrolujące dostęp do zasobów, takich jak użytkownicy, grupy i aplikacje. Role są przypisywane do użytkowników, grup lub jednostek usługi w celu udzielenia uprawnień potrzebnych do wykonywania określonych zadań. Można również ograniczyć zakres każdego przypisania do całego katalogu, jednostki administracyjnej lub konkretnej rejestracji aplikacji, dzięki czemu rola ma zastosowanie tylko tam, gdzie jest potrzebna.

Prerequisites

Aby zarządzać rolami za pomocą programu Microsoft Entra PowerShell, potrzebne są następujące elementy:

Znajdowanie definicji ról

Definicja roli to kolekcja uprawnień, które można wykonać, takich jak odczyt, zapis i usuwanie. Zwykle nazywa się to rolą. Microsoft Entra ID ma ponad 60 wbudowanych ról i możesz utworzyć własne role niestandardowe. Aby zrozumieć, co robi każda rola, możesz wyświetlić szczegółową listę jej uprawnień.

Aby uzyskać wszystkie definicje ról, uruchom następujące polecenie Get-EntraDirectoryRoleDefinition z co najmniej rolą Czytelnicy katalogu .

Connect-Entra -Scopes 'RoleManagement.Read.Directory'
Get-EntraDirectoryRoleDefinition
DisplayName                                   Id                                   TemplateId                           Description
-----------                                   --                                   ----------                           -----------
Guest User                                    10dae51f-b6af-4016-8d66-8c2a99b929b3 10dae51f-b6af-4016-8d66-8c2a99b929b3 Default role for guest users. Can read a limited set of directory information.
Restricted Guest User                         2af84b1e-32c8-42b7-82bc-daa82404023b 2af84b1e-32c8-42b7-82bc-daa82404023b Restricted role for guest users. Can read a limited set of directory information.

Znajdź przypisania ról

W tej sekcji opisano sposób wyświetlania listy ról przypisanych w Microsoft Entra ID. Aby uzyskać wszystkie przypisania ról, uruchom polecenie Get-EntraDirectoryRoleAssignment z co najmniej rolą Czytelnicy katalogu.

Connect-Entra -Scopes 'RoleManagement.Read.Directory'
Get-EntraDirectoryRoleAssignment -All 
Id                                            PrincipalId                           RoleDefinitionId                      DirectoryScopeId AppScopeId
--                                            -----------                           ----------------                      ---------------- ----------
00001111-aaaa-2222-bbbb-3333cccc4444          aaaaaaaa-bbbb-cccc-1111-222222222222  a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1  /                
11112222-bbbb-3333-cccc-4444dddd5555          bbbbbbbb-cccc-dddd-2222-333333333333  a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1  /                
22223333-cccc-4444-dddd-5555eeee6666          cccccccc-dddd-eeee-3333-444444444444  a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1  /                
33334444-dddd-5555-eeee-6666ffff7777          dddddddd-eeee-ffff-4444-555555555555  a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1  /                
44445555-eeee-6666-ffff-7777aaaa8888          eeeeeeee-ffff-aaaa-5555-666666666666  a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1  /                 

Określa PrincipalId konto, do którym jest przypisana rola, i RoleDefinitionId określa rolę przypisaną do konta.

Znajdowanie przypisań ról dla określonego użytkownika

Aby przeprowadzić inspekcję ról przypisanych do określonego użytkownika, przefiltruj przypisania ról według identyfikatora obiektu użytkownika.

Connect-Entra -Scopes 'RoleManagement.Read.Directory', 'User.Read.All'
$user = Get-EntraUser -UserId 'markus@contoso.com'
Get-EntraDirectoryRoleAssignment -All | Where-Object { $_.PrincipalId -eq $user.Id }
Id                                   PrincipalId                          RoleDefinitionId                     DirectoryScopeId AppScopeId
--                                   -----------                          ----------------                     ---------------- ----------
00001111-aaaa-2222-bbbb-3333cccc4444 bbbbbbbb-1111-2222-3333-cccccccccccc a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 /

Dane wyjściowe zawierają identyfikatory przypisań ról, ale nie zawierają wyświetlanych nazw ról. Aby rozpoznać nazwy ról z każdego RoleDefinitionIdelementu , należy przekazać im przydziały za pomocą metody Get-EntraDirectoryRoleDefinition.

$assignments = Get-EntraDirectoryRoleAssignment -All | Where-Object { $_.PrincipalId -eq $user.Id }
foreach ($assignment in $assignments) {
    $roleDef = Get-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $assignment.RoleDefinitionId
    [PSCustomObject]@{
        RoleName = $roleDef.DisplayName
        Scope    = $assignment.DirectoryScopeId
    }
}
RoleName               Scope
--------               -----
Helpdesk Administrator /
User Administrator     /administrativeUnits/aaaaaaaa-bbbb-cccc-1111-222222222222

Przypisywanie ról

Aby udzielić dostępu użytkownikom w Microsoft Entra ID, przypisz role Microsoft Entra. W tej sekcji opisano sposób przypisywania ról Microsoft Entra do użytkowników i grup. Aby wykonać następujące zadania, musisz mieć co najmniej rolę Administrator ról uprzywilejowanych .

Przypisywanie ról do użytkowników

  1. Użyj polecenia Get-EntraUser , aby pobrać użytkownika do przypisania roli.

    Connect-Entra -Scopes 'User.Read.All'
    $user = Get-EntraUser -UserId 'markus@contoso.com'
    

    Parametr -UserId określa identyfikator jako nazwę UPN użytkownika lub ObjectId.

    DisplayName Id                                   Mail                                 UserPrincipalName
    ----------- --                                   ----                                 -----------------
    Markus Long bbbbbbbb-1111-2222-3333-cccccccccccc markus@contoso.com                   markus@contoso.onmicrosoft.com
    
  2. Get-EntraDirectoryRoleDefinition Użyj polecenia , aby uzyskać identyfikator roli (RoleDefinitionId), który chcesz przypisać.

    Connect-Entra -Scopes 'RoleManagement.Read.Directory', 'EntitlementManagement.Read.All'
    $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Helpdesk Administrator'"
    
  3. Użyj polecenia , New-EntraDirectoryRoleAssignment aby przypisać rolę.

    Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
    New-EntraDirectoryRoleAssignment -RoleDefinitionId $directoryRole.Id -PrincipalId $user.Id -DirectoryScopeId '/'
    
    Id                                       PrincipalId                          RoleDefinitionId                     DirectoryScopeId AppScopeId
    --                                       -----------                          ----------------                     ---------------- ----------
    00001111-aaaa-2222-bbbb-3333cccc4444     aaaaaaaa-bbbb-cccc-1111-222222222222 a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 /
    

To polecenie tworzy nowe przypisanie roli w Microsoft Entra ID.

  • Parametr -RoleDefinitionId określa identyfikator definicji roli, którą chcesz przypisać. Definicje ról opisują uprawnienia przyznane użytkownikom lub grupom przez rolę. To jest identyfikator elementu unifiedRoleDefinition, którego dotyczy przypisanie.

  • Parametr -PrincipalId określa identyfikator podmiotu zabezpieczeń (użytkownika, grupy lub jednostki usługi), któremu przypisywana jest rola.

  • Parametr-DirectoryScopeId określa zakres katalogu, w którym przypisanie roli jest skuteczne. Wartość / zazwyczaj reprezentuje zakres główny, co oznacza, że przypisanie roli ma zastosowanie w całym katalogu.

Note

Kroki opisane w tej sekcji umożliwiają utworzenie trwałego (aktywnego) przypisania roli. Aby przyznać użytkownikowi dostęp ograniczony czasowo lub dostęp na żądanie za pomocą usługi Privileged Identity Management (PIM), zobacz polecenia cmdlet programu Microsoft Entra PowerShell dla usługi Privileged Identity Management.

Przypisywanie ról do grup

Aby uprościć zarządzanie rolami, można przypisać Microsoft Entra role do grupy zamiast osób. Dzięki temu można zarządzać przypisaniami ról dla wielu użytkowników jednocześnie.

  1. Utwórz grupę z możliwością przypisania roli przy użyciu parametru IsAssignableToRole . Ten parametr jest ustawiony na True, aby wskazać, że grupa może zostać przypisana do roli.

    Connect-Entra -Scopes 'Group.ReadWrite.All'
    $params = @{
        DisplayName = 'HelpDesk admin group2'
        Description = 'Group assignable to role'
        MailEnabled = $False
        MailNickname = 'helpDeskAdminGroup'
        SecurityEnabled = $True
        IsAssignableToRole = $True
    }
    $group = New-EntraGroup @params
    
    DisplayName           Id                                   MailNickname       Description              GroupTypes
    -----------           --                                   ------------       -----------              ----------
    HelpDesk admin group2 vvvvvvvv-8888-9999-0000-jjjjjjjjjjjj helpDeskAdminGroup Group assignable to role {}
    
  2. Pobierz identyfikator roli (RoleDefinitionId), który chcesz przypisać przy użyciu Get-EntraDirectoryRoleDefinition polecenia .

    Connect-Entra -Scopes 'RoleManagement.Read.Directory'
    $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Helpdesk Administrator'"
    
  3. Utwórz przypisanie roli za pomocą polecenia New-EntraDirectoryRoleAssignment, gdzie PrincipalId to identyfikator grupy.

    Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
    New-EntraDirectoryRoleAssignment -RoleDefinitionId $directoryRole.Id -PrincipalId $group.Id -DirectoryScopeId '/'
    

Przypisywanie ról do jednostek usługi

Role platformy Microsoft Entra można przypisać do jednostki usługi, w tym do tożsamości zarządzanej, aby aplikacja mogła wykonywać zadania związane z katalogiem we własnym imieniu bez udziału zalogowanego użytkownika.

  1. Użyj polecenia Get-EntraServicePrincipal, aby pobrać nazwę główną usługi.

    Connect-Entra -Scopes 'Application.Read.All'
    $servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'My Application'"
    
    DisplayName    Id                                   AppId                                SignInAudience ServicePrincipalType
    -----------    --                                   -----                                -------------- --------------------
    My Application cccccccc-dddd-eeee-3333-444444444444 44445555-eeee-6666-ffff-7777aaaa8888 AzureADMyOrg   Application
    
  2. Pobierz identyfikator roli, który chcesz przypisać.

    Connect-Entra -Scopes 'RoleManagement.Read.Directory'
    $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Directory Readers'"
    
  3. Przypisz rolę do jednostki usługi głównej.

    Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
    New-EntraDirectoryRoleAssignment -RoleDefinitionId $directoryRole.Id -PrincipalId $servicePrincipal.Id -DirectoryScopeId '/'
    
    Id                                       PrincipalId                          RoleDefinitionId                     DirectoryScopeId AppScopeId
    --                                       -----------                          ----------------                     ---------------- ----------
    A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u          cccccccc-dddd-eeee-3333-444444444444 a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 /
    

Przypisywanie ról z zakresem jednostki administracyjnej

Można ograniczyć przypisanie roli do określonej jednostki administracyjnej zamiast do całego katalogu. Następnie uprawnienia roli mają zastosowanie tylko do użytkowników, grup lub urządzeń należących do tej jednostki administracyjnej, co pomaga przestrzegać zasady najniższych uprawnień. Aby dowiedzieć się więcej na temat jednostek administracyjnych, zobacz Jednostki administracyjne w Microsoft Entra ID.

  1. Pobierz jednostkę główną (użytkownika, grupę lub jednostkę usługi) i jednostkę administracyjną.

    Connect-Entra -Scopes 'User.Read.All', 'AdministrativeUnit.Read.All'
    $user = Get-EntraUser -UserId 'markus@contoso.com'
    $adminUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Seattle Admin Unit'"
    
  2. Pobierz definicję roli.

    Connect-Entra -Scopes 'RoleManagement.Read.Directory'
    $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'User Administrator'"
    
  3. Przypisz rolę z zakresem jednostki administracyjnej.

    Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
    $directoryScopeId = '/administrativeUnits/' + $adminUnit.Id
    New-EntraDirectoryRoleAssignment -RoleDefinitionId $directoryRole.Id -PrincipalId $user.Id -DirectoryScopeId $directoryScopeId
    
    Id                                       PrincipalId                          RoleDefinitionId                     DirectoryScopeId                                          AppScopeId
    --                                       -----------                          ----------------                     ----------------                                          ----------
    A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u          bbbbbbbb-1111-2222-3333-cccccccccccc a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 /administrativeUnits/aaaaaaaa-bbbb-cccc-1111-222222222222
    

Użytkownik ma teraz rolę Administrator użytkowników tylko w ramach określonej jednostki administracyjnej.

Przypisywanie ról z zakresem aplikacji

Można ograniczyć zakres przypisania roli do jednej rejestracji aplikacji, aby podmiot zabezpieczeń mógł zarządzać tylko tą aplikacją. Użyj tego zakresu, jeśli na przykład chcesz, aby deweloper samodzielnie zarządzał rejestracją swojej aplikacji bez przyznawania mu uprawnień Application Administrator w całej dzierżawie.

  1. Pobierz użytkownika i rejestrację aplikacji.

    Connect-Entra -Scopes 'User.Read.All', 'Application.Read.All'
    $user = Get-EntraUser -UserId 'markus@contoso.com'
    $application = Get-EntraApplication -Filter "DisplayName eq 'My Web App'"
    
  2. Pobierz definicję roli.

    Connect-Entra -Scopes 'RoleManagement.Read.Directory'
    $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Application Administrator'"
    
  3. Przypisz rolę o określonym zakresie do aplikacji.

    Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
    $directoryScopeId = '/' + $application.Id
    New-EntraDirectoryRoleAssignment -RoleDefinitionId $directoryRole.Id -PrincipalId $user.Id -DirectoryScopeId $directoryScopeId
    
    Id                                       PrincipalId                          RoleDefinitionId                     DirectoryScopeId                      AppScopeId
    --                                       -----------                          ----------------                     ----------------                      ----------
    A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u          bbbbbbbb-1111-2222-3333-cccccccccccc a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 /dddddddd-eeee-ffff-4444-555555555555
    

Użytkownik ma teraz rolę Administrator aplikacji tylko dla określonej rejestracji aplikacji.

Note

Dwa formaty zakresu mają różne semantyki. Zakres /{id} (używany dla zakresu aplikacji) oznacza, że podmiot zabezpieczeń może zarządzać samym obiektem. Zakres /administrativeUnits/{id} oznacza, że podmiot może zarządzać członkami jednostki administracyjnej (na podstawie przypisanej roli), a nie samą jednostką administracyjną. Aby uzyskać więcej informacji, zobacz Przypisywanie ról Microsoft Entra w różnych zakresach.

Tworzenie roli niestandardowej

W tej sekcji opisano sposób tworzenia nowych ról niestandardowych w programie Microsoft Entra ID przy użyciu programu Microsoft Entra PowerShell. Aby wykonać następujące zadanie, musisz mieć co najmniej rolę Administrator ról uprzywilejowanych .

Aby utworzyć nową rolę, użyj polecenia New-EntraDirectoryRoleDefinition cmdlet.

  • Parametr RolePermissions określa uprawnienia definicji roli.
  • Parametr IsEnabled określa, czy definicja roli jest włączona.
  • Parametr DisplayName określa nazwę wyświetlaną definicji roli.
Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$rolePermissions = New-object Microsoft.Open.MSGraph.Model.RolePermission
$rolePermissions.AllowedResourceActions =  @("microsoft.directory/applications/basic/read")
New-EntraDirectoryRoleDefinition -RolePermissions $rolePermissions -IsEnabled $true -DisplayName 'Custom Application Read'

DisplayName             Id                                   TemplateId                           Description IsBuiltIn IsEnabled
-----------             --                                   ----------                           ----------- --------- ---------
Custom Application Read a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 f5f5f5f5-aaaa-bbbb-cccc-d6d6d6d6d6d6             False     True

Aby znaleźć więcej opcji definiowania podczas tworzenia roli niestandardowej, zobacz artykuł New-EntraDirectoryRoleDefinition.

Po utworzeniu roli możesz przypisać ją do użytkowników lub grup.

Uprzątnij zasoby

W tej sekcji wyjaśniono, jak usuwać role w Microsoft Entra ID za pomocą programu Microsoft Entra PowerShell. Aby wykonać następujące zadania, musisz mieć co najmniej rolę Administrator ról uprzywilejowanych .

Usuń przypisania ról

Użyj polecenia , Remove-EntraDirectoryRoleAssignment aby usunąć przypisanie roli. Jeśli musisz znaleźć identyfikator przypisania roli, o którym mowa w parametrze -Id, najpierw uruchom polecenie Get-EntraDirectoryRoleAssignment.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk admin group2'"
$directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Helpdesk Administrator'"
Get-EntraDirectoryRoleAssignment | Where-Object {$_.PrincipalId -eq $group.Id -and $_.RoleDefinitionId -eq $directoryRole.Id} | Remove-EntraDirectoryRoleAssignment

W tym przykładzie usunięto określone przypisanie roli z Microsoft Entra ID.

Usuwanie ról

Nie można usunąć wbudowanych ról. Użyj polecenia , Remove-EntraDirectoryRoleDefinition aby usunąć rolę niestandardową. Parametr DisplayName odnosi się do nazwy wyświetlanej roli niestandardowej.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Custom Application Read'" | Remove-EntraDirectoryRoleDefinition