分配 Microsoft Entra 角色

1. 至少以特权角色管理员身份登录到 Microsoft Entra 管理中心。

2. 浏览到“标识”>“角色和管理员”>“角色和管理员”。

   

3. 选择角色名称以打开该角色。 不要勾选该角色。

   

4. 选择 添加任务，然后选择要分配给此角色的用户或组。

   只会显示可分配角色的组。 如果未列出组，则需要创建可分配角色的组。

   如果您的体验不同于以下的屏幕截图，可能是因为您有 Microsoft Entra ID P2 和 PIM。 有关详细信息，请参阅在 Privileged Identity Management 中分配 Microsoft Entra 角色。

   

5. 选择“”，再选择“”以分配角色。

按照以下步骤使用 PowerShell 分配 Microsoft Entra 角色。

1. 打开 PowerShell 窗口。 如有必要，使用 Install-Module 安装 Microsoft Graph PowerShell。 有关详细信息，请参阅使用 PowerShell 的先决条件。

   Install-Module Microsoft.Graph -Scope CurrentUser
   

2. 在 PowerShell 窗口中，使用 Connect-MgGraph 登录到你的租户。

   Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "RoleManagement.ReadWrite.Directory"
   

3. 使用 Get-MgUser 获取用户。

   $user = Get-MgUser -Filter "userPrincipalName eq 'alice@contoso.com'"
   

   使用 Get-MgGroup 获取可分配角色的组。

   $group = Get-MgGroup -Filter "DisplayName eq 'Contoso Helpdesk'"
   

4. 使用 Get-MgRoleManagementDirectoryRoleDefinition 获取要分配的角色。

   若要查看所有内置角色的角色定义 ID 列表，请参阅 Microsoft Entra 内置角色。

   $roleDefinition = Get-MgRoleManagementDirectoryRoleDefinition -Filter "displayName eq 'Billing Administrator'"
   

5. 将租户设置为角色分配的作用域。

   $directoryScope = '/'
   

6. 使用 New-MgRoleManagementDirectoryRoleAssignment 分配角色。

   $roleAssignment = New-MgRoleManagementDirectoryRoleAssignment `
      -DirectoryScopeId $directoryScope -PrincipalId $user.Id `
      -RoleDefinitionId $roleDefinition.Id
   

   $roleAssignment = New-MgRoleManagementDirectoryRoleAssignment `
       -DirectoryScopeId $directoryScope -PrincipalId $group.Id `
       -RoleDefinitionId $roleDefinition.Id
   

   下面是另一种方法来分配角色。

   $params = @{
      "directoryScopeId" = "/" 
      "principalId" = $group.Id
      "roleDefinitionId" = $roleDefinition.Id
   }
   $roleAssignment = New-MgRoleManagementDirectoryRoleAssignment -BodyParameter $params
   

默认情况下在租户范围内分配内置角色和自定义角色，以授予对组织中所有应用注册的访问权限。 此外，还可以在单个Microsoft Entra 资源的范围内分配自定义角色和一些相关的内置角色（具体取决于Microsoft Entra 资源的类型）。 这样，用户就有权更新单个应用的凭据和基本属性，而无需创建第二个自定义角色。

本部分介绍如何在应用程序注册范围内分配角色。

1. 请至少以 应用程序开发人员的身份登录到 Microsoft Entra 管理中心。

2. 浏览到“标识”“应用程序”>“应用注册”>。

3. 选择应用程序。 可以使用搜索框查找所需的应用。

   可能需要选择 所有应用程序 才能查看租户中应用注册的完整列表。

   

4. 从左侧导航菜单中选择 角色和管理员，以查看可通过应用注册分配的所有角色的列表。

   

5. 选择所需的角色。

   提示

   此处看不到Microsoft Entra 内置角色或自定义角色的完整列表。 这是预期的。 我们显示了与仅管理应用注册相关的权限的角色。

6. 选择“添加分配”，然后选择要向其分配此角色的用户或组。

   

7. 选择“添加”分配以应用注册为作用域的角色。

按照以下步骤使用 PowerShell 在应用程序范围内分配 Microsoft Entra 角色。

1. 打开 PowerShell 窗口。 如有必要，使用 Install-Module 安装 Microsoft Graph PowerShell。 有关详细信息，请参阅使用 PowerShell 的先决条件。

   Install-Module Microsoft.Graph -Scope CurrentUser
   

2. 在 PowerShell 窗口中，使用 Connect-MgGraph 登录到你的租户。

   Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "Application.Read.All","RoleManagement.Read.Directory","User.Read.All","RoleManagement.ReadWrite.Directory"
   

3. 使用 Get-MgUser 获取用户。

   $user = Get-MgUser -Filter "userPrincipalName eq 'alice@contoso.com'"
   

   若要将角色分配给服务主体而不是用户，请使用 Get-MgServicePrincipal 命令。

4. 使用 Get-MgRoleManagementDirectoryRoleDefinition 获取要分配的角色。

   $roleDefinition = Get-MgRoleManagementDirectoryRoleDefinition `
      -Filter "displayName eq 'Application Administrator'"
   

5. 使用 Get-MgApplication 获取要将角色分配的作用域限定到的应用注册。

   $appRegistration = Get-MgApplication -Filter "displayName eq 'f/128 Filter Photos'"
   $directoryScope = '/' + $appRegistration.Id
   

6. 使用 New-MgRoleManagementDirectoryRoleAssignment 分配角色。

   $roleAssignment = New-MgRoleManagementDirectoryRoleAssignment `
      -DirectoryScopeId $directoryScope -PrincipalId $user.Id `
      -RoleDefinitionId $roleDefinition.Id 
   

在Microsoft Entra ID 中，若要进行更精细的管理控制，可以分配一个Microsoft Entra 角色，该角色的范围限制为一个或多个 管理单元。 在管理单元范围内分配Microsoft Entra 角色时，角色权限仅适用于管理单元本身的成员，并且不适用于租户范围的设置或配置。

例如，在管理单元范围内分配组管理员角色的管理员可以管理属于管理单元成员的组，但他们不能管理租户中的其他组。 它们也不能管理与组相关的租户级别设置，例如过期策略或组命名策略。

本部分介绍如何分配管理单元范围的 Microsoft Entra 角色。

• 每个管理单元管理员需要配备 Microsoft Entra ID P1 或 P2 许可证。
• Microsoft Entra ID 免费许可证适用于管理单元成员
• 特权角色管理员
• 使用 PowerShell 时的 Microsoft Graph PowerShell 模块

有关详细信息，请参阅使用 PowerShell 的先决条件。

可为以下 Microsoft Entra 角色分配管理单元范围。 此外，只要自定义角色的权限至少包含一个与用户、组或设备相关的权限，就可以将任何 自定义角色 分配在管理单元范围内。

当与管理单元范围一起分配时，某些角色权限仅适用于非管理员用户。 换言之，仅当用户没有管理员角色时，管理单元范围的支持管理员才能在管理单元中重置这些用户的密码。 当操作的目标是另一个管理员时，以下权限列表受到限制：

• 读取和修改用户身份验证方法，或重置用户密码
• 修改敏感用户属性，如电话号码、备用电子邮件地址或打开授权（OAuth）密钥
• 删除或还原用户帐户

可以将以下安全主体分配给具有管理单元范围的角色：

• 用户
• Microsoft Entra 可分配角色的组
• 服务主体

服务主体和来宾用户将无法使用范围为管理单元的角色分配，除非他们还被分配了读取对象的相应权限。 这是因为服务主体和来宾用户默认情况下不会收到目录读取权限，这是执行管理操作所必需的。 若要使服务主体或来宾用户能够使用作用域为管理单元的角色分配，必须分配租户范围内的目录读取者角色（或其他角色，该角色包括读取权限）。

目前无法将目录读取权限分配给特定的管理单元。 有关用户的默认权限的详细信息，请参阅 默认用户权限。

本部分介绍如何在管理单元范围内分配角色。

1. 至少以特权角色管理员身份登录到 Microsoft Entra 管理中心。

2. 浏览到“标识”“角色和管理员”>“管理单元”>。

3. 选择一个管理单元。

   Microsoft Entra ID 中管理单元的

4. 从左侧导航菜单中选择 角色和管理员，以查看可在管理单元上分配的所有角色的列表。

   

5. 选择所需的角色。

   提示

   此处看不到Microsoft Entra 内置角色或自定义角色的完整列表。 这是预期的。 我们展示了哪些角色具有与管理单元中支持的对象相关的权限。 若要查看管理单元中支持的对象列表，请参阅Microsoft Entra ID中的 管理单元。

6. 选择“添加分配”，然后选择要向其分配此角色的用户或组。

7. 选择“添加”分配以管理单元为作用域的角色。

按照以下步骤使用 PowerShell 在管理单元范围内分配 Microsoft Entra 角色。

1. 打开 PowerShell 窗口。 如有必要，使用 Install-Module 安装 Microsoft Graph PowerShell。 有关详细信息，请参阅使用 PowerShell 的先决条件。

   Install-Module Microsoft.Graph -Scope CurrentUser
   

2. 在 PowerShell 窗口中，使用 Connect-MgGraph 登录到你的租户。

   Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "Directory.Read.All","RoleManagement.Read.Directory","User.Read.All","RoleManagement.ReadWrite.Directory"
   

3. 使用 Get-MgUser 获取用户。

   $user = Get-MgUser -Filter "userPrincipalName eq 'alice@contoso.com'"
   

4. 使用 Get-MgRoleManagementDirectoryRoleDefinition 获取要分配的角色。

   $roleDefinition = Get-MgRoleManagementDirectoryRoleDefinition `
      -Filter "displayName eq 'User Administrator'"
   

5. 使用 Get-MgDirectoryAdministrativeUnit 获取要将角色分配的作用域限定到的管理单元。

   $adminUnit = Get-MgDirectoryAdministrativeUnit -Filter "displayName eq 'Seattle Admin Unit'"
   $directoryScope = '/administrativeUnits/' + $adminUnit.Id
   

6. 使用 New-MgRoleManagementDirectoryRoleAssignment 分配角色。

   $roleAssignment = New-MgRoleManagementDirectoryRoleAssignment `
      -DirectoryScopeId $directoryScope -PrincipalId $user.Id `
      -RoleDefinitionId $roleDefinition.Id
   

• 列出 Microsoft Entra 角色分配
• 在 Privileged Identity Management 中分配 Microsoft Entra 角色
• 使用Microsoft Entra 组管理角色分配
• 排查分配给组的 Microsoft Entra 角色的问题