Get-RoleGroup
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Get-RoleGroup cmdlet 可以检索管理角色组的列表。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
Get-RoleGroup
[[-Identity] <RoleGroupIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-ShowPartnerLinked]
[-SortBy <String>]
[<CommonParameters>]
说明
有关角色组的详细信息，请参阅了解管理角色组。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-RoleGroup
本示例检索角色组的列表。
示例 2
Get-RoleGroup "Recipient Administrators" | Format-List
本示例检索 Recipient Administrators 角色组的详细信息。
示例 3
Get-RoleGroup -ReadFromDomainController
本示例检索由最靠近用户的域控制器所看见的角色组的列表。
示例 4
Get-RoleGroup -Filter "RoleGroupType -eq 'Linked'" | Format-Table Name, LinkedGroup
此示例检索链接到每个组 (USG) 的所有链接角色组和 Active Directory 安全标识符 (SID) 的列表。 然后可以使用 SID 查找 USG，以便可以修改其成员。
参数
-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 |
-Filter
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
Filter 参数使用 OPATH 语法按指定的属性和值筛选结果。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"。
- 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (，例如
$true、$false或$null) ，请改用单引号 ' 。 虽然此参数是 (不是系统块) 的字符串，但也可以使用大括号 { }，但前提是筛选器不包含变量。 - 属性是可筛选的属性。
- ComparisonOperator 是一个 OPATH 比较运算符， (例如
-eq用于等于和-like字符串比较) 。 有关比较运算符的详细信息，请参阅 about_Comparison_Operators。 - Value 是要搜索的属性值。 将文本值和变量括在单引号 (
'Value'或'$Variable') 。 如果变量值包含单引号，则需要识别 (转义) 单引号才能正确展开变量。 例如，使用'$($User -Replace "'","''")'而不是'$User'。 不要将整数或系统值括在引号 (例如，改用500、$true、$false或$null) 。
可以使用逻辑运算符 -and 和 -or将多个搜索条件链接在一起。 例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。
有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。
可以按下列属性进行筛选：
- LinkedGroup
- ManagedBy
- Members
- 名称
- RoleGroupType (可用值为Standard和链接)
- DisplayName
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | 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 参数指定要检索的角色组。 如果角色组名称中包含空格，则必须使用引号 (") 括住名称。
如果不指定 Identity 参数，则返回所有角色组。
参数属性
| 类型: | RoleGroupIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ReadFromDomainController
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
ReadFromDomainController 开关指定从用户域中的域控制器读取的信息。 不必为此开关指定值。
命令： Set-AdServerSettings -ViewEntireForest $true 若要包含林中的所有对象，需要 ReadFromDomainController 开关。 否则，命令可能会使用包含过时信息的全局编录。 此外，可能需要使用 ReadFromDomainController 开关运行命令的多个迭代才能获取信息。
默认情况下，收件人范围设置为托管 Exchange 服务器的域。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ResultSize
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 1000。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ShowPartnerLinked
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
此参数仅在基于云的服务中有效。
此 ShowPartnerLinked 开关指定是否返回类型为 PartnerRoleGroup 的内置角色组。 不必为此开关指定值。
这种类型的角色组在基于云的服务中使用，以允许合作伙伴服务提供商管理其客户组织。 无法编辑这些类型的角色组，并且默认情况下不会显示。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SortBy
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全 & 合规性、Exchange Online Protection
SortBy 参数指定用作结果排序依据的属性。 每次只能按一个属性进行排序。 结果将按升序进行排序。
如果默认视图不包括要排序依据的属性，则可以使用 | Format-Table -Auto Property1,Property2,...PropertyX追加命令。 创建包含要查看的所有属性的新视图。 支持在属性名称中使用通配符 (*)。
可以按下列属性排序：
- 名称
- DisplayName
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| 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 不返回任何数据。