Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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:
- Konto użytkownika Microsoft Entra. Jeśli jeszcze go nie masz, możesz założyć konto za darmo.
- Następująca rola służy do znajdowania definicji ról i przypisań: Czytelnicy katalogu
- Rola Administrator ról uprzywilejowanych służy do tworzenia, przypisywania i usuwania ról.
- Zainstalowano moduł programu PowerShell Microsoft Entra. Postępuj zgodnie z przewodnikiem Instalowanie modułu Microsoft Entra programu PowerShell, aby zainstalować moduł.
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
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
-UserIdokreś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.comGet-EntraDirectoryRoleDefinitionUż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'"Użyj polecenia ,
New-EntraDirectoryRoleAssignmentaby 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
-RoleDefinitionIdokreśla identyfikator definicji roli, którą chcesz przypisać. Definicje ról opisują uprawnienia przyznane użytkownikom lub grupom przez rolę. To jest identyfikator elementuunifiedRoleDefinition, którego dotyczy przypisanie.Parametr
-PrincipalIdokreśla identyfikator podmiotu zabezpieczeń (użytkownika, grupy lub jednostki usługi), któremu przypisywana jest rola.Parametr
-DirectoryScopeIdokreś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.
Utwórz grupę z możliwością przypisania roli przy użyciu parametru
IsAssignableToRole. Ten parametr jest ustawiony naTrue, 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 @paramsDisplayName Id MailNickname Description GroupTypes ----------- -- ------------ ----------- ---------- HelpDesk admin group2 vvvvvvvv-8888-9999-0000-jjjjjjjjjjjj helpDeskAdminGroup Group assignable to role {}Pobierz identyfikator roli (
RoleDefinitionId), który chcesz przypisać przy użyciuGet-EntraDirectoryRoleDefinitionpolecenia .Connect-Entra -Scopes 'RoleManagement.Read.Directory' $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Helpdesk Administrator'"Utwórz przypisanie roli za pomocą polecenia
New-EntraDirectoryRoleAssignment, gdziePrincipalIdto 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.
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 ApplicationPobierz identyfikator roli, który chcesz przypisać.
Connect-Entra -Scopes 'RoleManagement.Read.Directory' $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Directory Readers'"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.
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'"Pobierz definicję roli.
Connect-Entra -Scopes 'RoleManagement.Read.Directory' $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'User Administrator'"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 $directoryScopeIdId 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.
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'"Pobierz definicję roli.
Connect-Entra -Scopes 'RoleManagement.Read.Directory' $directoryRole = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Application Administrator'"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 $directoryScopeIdId 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
RolePermissionsokreśla uprawnienia definicji roli. - Parametr
IsEnabledokreśla, czy definicja roli jest włączona. - Parametr
DisplayNameokreś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