Get-ManagementRole
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Get-ManagementRole cmdlet 可以查看组织内已创建的管理角色。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
GetChildren
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-GetChildren]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Recurse
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-Recurse]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Identity
Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Cmdlet <String>]
[-CmdletParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Script
Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Script <String>]
[-ScriptParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
说明
您可以通过多种方式查看管理角色，包括列出组织中的所有角色、仅列出指定父角色的子角色等。 还可以查看特定角色的详细信息，方法是通过管道将 Get-ManagementRole cmdlet 的输出传递给 Format-List cmdlet。
有关管理角色的详细信息，请参阅了解管理角色。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-ManagementRole
本示例列出了在组织中创建的所有角色。
示例 2
Get-ManagementRole "Mail Recipients" -Recurse
本示例列出了“邮件收件人”管理角色的所有子角色。 此命令将对指定父角色的所有子角色执行递归查询。 此递归查询将查找每一个子角色，从父角色的直接子角色到层次结构中的最后一个子角色。 在递归列表中，还将返回父角色。
示例 3
Get-ManagementRole -CmdletParameters Identity, Database
本示例列出了同时包含 Identity 和 Database 参数的所有角色。 不返回仅包含其中一个参数的角色。
示例 4
Get-ManagementRole -RoleType UnScopedTopLevel
本示例列出了类型为 UnScopedTopLevel 的所有角色。 这些角色包含自定义脚本或非 Exchange cmdlet。
示例 5
Get-ManagementRole "Transport Rules" | Format-List Name, RoleType
本示例仅检索“传输规则”角色，并将 Get-ManagementRole cmdlet 的输出传递给 Format-List cmdlet。 随后，Format-List cmdlet 将只显示“传输规则”角色的 Name 和 RoleType 属性。 有关管道和 Format-List cmdlet 的详细信息，请参阅 关于管道 和 使用命令输出。
示例 6
Get-ManagementRole "Mail Recipients" -GetChildren
本示例列出了“邮件收件人”角色的直接子角色。 仅返回将“邮件收件人”角色作为其父角色的子角色。 不在列表中返回“邮件收件人”角色。
参数
-Cmdlet
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
Cmdlet 参数返回包含指定 cmdlet 的所有角色的列表。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CmdletParameters
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
CmdletParameters 参数返回包括指定参数的所有角色列表。 可以用逗号分隔每个参数来指定多个参数。 如果指定多个参数，则仅返回包括所有指定参数的角色。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-GetChildren
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
GetChildren 参数检索根据 Identity 参数中指定的父角色创建的所有角色列表。 不必为此开关指定值。
结果中仅包含父角色的直接子角色。
只能将此开关与 Identity 和 RoleType 参数一起使用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
GetChildren
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
Identity 参数指定要查看的角色。 如果要查看的角色中包含空格，则使用引号 (") 将该名称括起来。 可以使用通配符 (*) 和部分角色名称来匹配多个角色。
参数属性
| 类型: | RoleIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
GetChildren
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
Recurse
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
Identity
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
Script
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Recurse
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
Recurse 参数检索根据 Identity 参数中指定的父角色创建的所有角色列表。 不必为此开关指定值。
返回在 Identity 参数中指定的角色、其子角色及子角色的子角色。
只能将此开关与 Identity 和 RoleType 参数一起使用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Recurse
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RoleType
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
RoleType 参数返回与指定的角色类型匹配的角色列表。 有关有效角色类型的列表，请参阅 了解管理角色。
参数属性
| 类型: | RoleType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Script
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
Script 参数返回包含指定脚本的所有角色的列表。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Script
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ScriptParameters
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
ScriptParameters 参数返回包括指定参数的所有角色列表。 可以用逗号分隔每个参数来指定多个参数。 如果指定多个参数，则仅返回包括所有指定参数的角色。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Script
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。