Get-ManagementRoleAssignment
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-ManagementRoleAssignment cmdlet 检索管理角色分配。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Get-ManagementRoleAssignment
[[-Identity] <RoleAssignmentIdParameter>]
[-ConfigWriteScope <ConfigWriteScopeType>]
[-CustomConfigWriteScope <ManagementScopeIdParameter>]
[-CustomRecipientWriteScope <ManagementScopeIdParameter>]
[-Delegating <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Exclusive <Boolean>]
[-ExclusiveConfigWriteScope <ManagementScopeIdParameter>]
[-ExclusiveRecipientWriteScope <ManagementScopeIdParameter>]
[-GetEffectiveUsers]
[-RecipientAdministrativeUnitScope <AdministrativeUnitIdParameter>]
[-RecipientGroupScope <GroupIdParameter>]
[-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
[-RecipientWriteScope <RecipientWriteScopeType>]
[-RoleAssigneeType <RoleAssigneeType>]
[-WritableDatabase <DatabaseIdParameter>]
[-WritableRecipient <GeneralRecipientIdParameter>]
[-WritableServer <ServerIdParameter>]
[<CommonParameters>] Get-ManagementRoleAssignment
[-AssignmentMethod <AssignmentMethod[]>]
[-Role <RoleIdParameter>]
[-ConfigWriteScope <ConfigWriteScopeType>]
[-CustomConfigWriteScope <ManagementScopeIdParameter>]
[-CustomRecipientWriteScope <ManagementScopeIdParameter>]
[-Delegating <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Exclusive <Boolean>]
[-ExclusiveConfigWriteScope <ManagementScopeIdParameter>]
[-ExclusiveRecipientWriteScope <ManagementScopeIdParameter>]
[-GetEffectiveUsers]
[-RecipientAdministrativeUnitScope <AdministrativeUnitIdParameter>]
[-RecipientGroupScope <GroupIdParameter>]
[-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
[-RecipientWriteScope <RecipientWriteScopeType>]
[-RoleAssignee <RoleAssigneeIdParameter>]
[-RoleAssigneeType <RoleAssigneeType>]
[-WritableDatabase <DatabaseIdParameter>]
[-WritableRecipient <GeneralRecipientIdParameter>]
[-WritableServer <ServerIdParameter>]
[<CommonParameters>] 说明
可以通过多种方式检索角色分配，包括按分配类型、范围类型或名称以及是启用或禁用分配。 还可以查看角色分配列表，这些角色分配提供对指定收件人、服务器或数据库的访问权限。
有关管理角色分配的详细信息，请参阅了解管理角色分配。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-ManagementRoleAssignment "Denver Help Desk" | Format-List此示例使用 Get-ManagementRoleAssignment cmdlet 检索丹佛技术支持角色分配，并通过管道将输出传递给 Format-List cmdlet。 有关 Format-List cmdlet 的详细信息，请参阅 使用命令输出。
示例 2
Get-ManagementRoleAssignment -Enabled $true -Delegating $true此示例检索已启用且已指定为委派角色分配的所有角色分配。
示例 3
Get-ManagementRoleAssignment -RecipientWriteScope MyGAL此示例检索包含基于 MyGAL 收件人的范围限制类型的所有角色分配。
示例 4
Get-ManagementRoleAssignment -Role "Mail Recipients"此示例检索与邮件收件人管理角色关联的所有角色分配。
示例 5
Get-ManagementRoleAssignment -WritableRecipient Bob -GetEffectiveUsers此示例检索可修改收件人 Bob 的所有用户和角色分配的列表。
示例 6
Get-ManagementRoleAssignment -ExclusiveConfigWriteScope "Redmond Executive Servers" -GetEffectiveUsers此示例检索可以修改与 Redmond Executive Servers 匹配的服务器对象的所有独占作用域的列表。 该命令还列出了通过角色组或 USG 有效分配角色分配的用户。
示例 7
Get-ManagementRoleAssignment -WritableDatabase "Contoso Sales"此示例检索可以修改数据库 Contoso Sales 的所有角色分配。
参数
-AssignmentMethod
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
AssignmentMethod 参数指定要包含在 cmdlet 返回的结果中的角色分配类型。 可以指定以下一个或多个值：
- 直接
- SecurityGroup
- RoleGroup
- RoleAssignmentPolicy
如果提供多个值，请用逗号分隔每个值。
如果使用 AssignmentMethod 参数，则必须使用 RoleAssignee 参数指定值。
| 类型: | AssignmentMethod[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ConfigWriteScope
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
ConfigWriteScope 参数指定要包含在 cmdlet 返回的结果中的管理配置作用域的类型。 有效值为 None、OrganizationConfig、CustomConfigScope 和 ExclusiveConfigScope。
| 类型: | ConfigWriteScopeType |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CustomConfigWriteScope
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
CustomConfigWriteScope 参数仅返回包含指定基于配置的常规作用域的常规角色分配。
此参数只能用于检索基于配置的常规范围。 若要检索基于独占配置的作用域的列表，请改用 ExclusiveConfigWriteScope 参数。
如果范围名称包含空格，请用引号 (“) 括起来。
| 类型: | ManagementScopeIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CustomRecipientWriteScope
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
CustomRecipientWriteScope 参数仅返回包含指定基于收件人的常规作用域的常规角色分配。
此参数只能用于检索基于收件人的常规范围。 若要检索基于收件人的独占范围列表，请改用 ExclusiveRecipientWriteScope 参数。
如果范围名称包含空格，请用引号 (“) 括起来。
| 类型: | ManagementScopeIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Delegating
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Delegating 参数指定是应返回委派角色分配还是常规角色分配。
默认情况下，同时返回委派范围和常规范围。 若要仅返回委派角色分配，请将 值指定为 $true。 若要仅返回常规角色分配，请指定值 $false。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DomainController
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| 类型: | Fqdn |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Enabled
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Enabled 参数指定应返回启用或禁用的角色分配。 若要返回启用的角色分配，请指定值 $true。 若要返回禁用的角色分配，请将值指定为 $false。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Exclusive
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Exclusive 参数指定是应返回独占角色分配还是常规角色分配。
默认情况下，将返回独占范围和常规范围。 若要仅返回排他角色分配，请指定值 $true。 若要仅返回常规角色分配，请指定值 $false。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ExclusiveConfigWriteScope
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
ExclusiveConfigWriteScope 参数仅返回包含指定基于配置的独占作用域的独占角色分配。
此参数只能用于检索基于配置的独占范围。 若要检索常规基于配置的范围列表，请改用 CustomConfigWriteScope 参数。
如果范围名称包含空格，请用引号 (“) 括起来。
| 类型: | ManagementScopeIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ExclusiveRecipientWriteScope
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
ExclusiveRecipientWriteScope 参数仅返回包含指定基于收件人的独占范围的独占角色分配。
此参数只能用于检索基于收件人的独占范围。 若要检索基于收件人的常规范围列表，请改用 CustomRecipientWriteScope 参数。
如果范围名称包含空格，请用引号 (“) 括起来。
| 类型: | ManagementScopeIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-GetEffectiveUsers
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
GetEffectiveUsers 开关指定命令应显示与角色分配关联的角色组、角色分配策略或 USG 中的用户列表。 不必为此开关指定值。
实际上，用户通过其角色组、角色分配策略或 USG 成员身份与角色分配相关联。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Identity
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Identity 参数指定要检索的角色分配的名称。 如果角色分配的名称包含空格，请将它括在引号 (“) 。 如果使用 RoleAssignee 参数，则不能使用 Identity 参数。
| 类型: | RoleAssignmentIdParameter |
| Position: | 1 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-RecipientAdministrativeUnitScope
适用：Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
此参数仅在基于云的服务中有效。
RecipientAdministrativeUnitScope 参数仅返回包含指定管理单元的角色分配。
管理单元是资源容器Microsoft Entra。 可以使用 Get-AdministrativeUnit cmdlet 查看可用的管理单元。
| 类型: | AdministrativeUnitIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RecipientGroupScope
适用：Exchange Online、Exchange Online Protection
此参数仅在基于云的服务中可用。
RecipientGroupScope 参数仅返回作用域为组的角色分配。 可以使用唯一标识组的任何值：Name、DistinguishedName、GUID、DisplayName。
| 类型: | GroupIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RecipientOrganizationalUnitScope
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
RecipientOrganizationalUnitScope 参数仅返回包含指定组织单位的角色分配 (OU) 。 如果 OU 树包含空格，请用引号 (“) 括起来。
| 类型: | OrganizationalUnitIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RecipientWriteScope
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
RecipientWriteScope 参数仅返回与指定的收件人范围限制类型关联的角色分配。 有效值为 None、MyGAL、Self、OU、CustomRecipientScope、MyDistributionGroups 和 ExclusiveRecipientScope。
| 类型: | RecipientWriteScopeType |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Role
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Role 参数仅返回与指定管理角色关联的角色分配。 如果角色的名称包含空格，请用引号 (“) 括起来。
| 类型: | RoleIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-RoleAssignee
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
RoleAssignee 参数指定要查看其角色分配的角色组、分配策略、用户或通用安全组 (USG) 。 如果使用 RoleAssignee 参数，则不能使用 Identity 参数。
默认情况下，命令将直接角色分配返回给角色被分配者，以及通过角色组或分配策略授予角色被分配者的间接角色分配。
如果用户或 USG 的名称包含空格，请用引号 (“) 括起来。
| 类型: | RoleAssigneeIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RoleAssigneeType
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
RoleAssigneeType 参数指定要返回的角色代理人的类型。 有效值为 User、SecurityGroup、RoleAssignmentPolicy、ForeignSecurityPrincipal、RoleGroup、LinkedRoleGroup 和 Computer。
| 类型: | RoleAssigneeType |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WritableDatabase
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
WritableDatabase 参数指定要测试的数据库对象，以确定哪些角色分配允许修改该对象。 该命令考虑了与每个角色分配关联的角色和范围。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
如果将此参数与 GetEffectiveUsers 开关一起使用，则还会返回可以通过角色组和 USG 间接修改数据库对象的所有用户。 如果没有 GetEffectiveUsers 开关，则仅返回直接分配角色分配的角色组、用户和 USG。
| 类型: | DatabaseIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WritableRecipient
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
WritableRecipient 参数指定要测试的收件人对象，以确定哪些角色分配允许修改该对象。 该命令考虑了与每个角色分配关联的角色和范围。 如果收件人姓名包含空格，请用引号 (“) 括起来。
如果此参数与 GetEffectiveUsers 开关一起使用，则还会返回所有可以通过角色组和 USG 间接修改收件人对象的用户。 如果没有 GetEffectiveUsers 开关，则仅返回直接分配角色分配的角色组、用户和 USG。
| 类型: | GeneralRecipientIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WritableServer
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
WritableServer 参数指定要测试的服务器对象，以确定哪些角色分配允许修改它。 该命令考虑了与每个角色分配关联的角色和范围。
可以使用唯一标识该服务器的任何值。 例如：
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
如果此参数与 GetEffectiveUsers 开关一起使用，则还会返回可以通过角色组和 USG 间接修改服务器对象的所有用户。 如果没有 GetEffectiveUsers 开关，则仅返回直接分配角色分配的角色组、用户和 USG。
| 类型: | ServerIdParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。