Get-CsRgsAgentGroup
上一次修改主题： 2012-03-23
返回有关配置为在组织中使用的响应组代理组的信息。代理组是分配给某个响应组队列的代理的集合。代理是分配为应答定向到某个队列的呼叫的用户。
语法
Get-CsRgsAgentGroup [-Identity <RgsIdentity>] [-Name <String>]
详细说明
当有人呼叫与响应组应用程序关联的电话号码时，该应用程序将首先确定与被叫号码对应的工作流。基于该工作流的配置，可能会将该呼叫路由至一组互动语音响应问题 (IVR)（向呼叫者提出诸如“此问题是关于硬件支持还是软件支持？”等一个或多个问题）。或者，也可能将该呼叫置于响应组队列中；此时呼叫者将被置于呼叫等待状态，直到指定的人员可以应答呼叫。指定应答呼叫的人员称为代理，而集合在一起构成的代理组则称为响应组代理组。代理组与工作流相关联，并进一步与类似的工作职责相关联：技术支持人员可能组成 Help Desk 代理组，而客户支持代理则组成 Customer Support 代理组。
Get-CsRgsAgentGroup cmdlet 提供了一种返回有关组织中当前正在使用的响应组代理组的信息（其中包括有关已分配至每个代理组的用户的信息）的方法。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsRgsAgentGroup cmdlet：RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsAgentGroup"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Rgs 标识 |
代表托管响应组代理组的服务的 Identity 或代理组本身的完整 Identity。如果指定服务 Identity（例如，service:ApplicationServer:atl-cs-001.litwareinc.com），则将返回该服务托管的所有代理组。如果指定组的 Identity，则仅返回指定的代理组。请注意，代理组的 Identity 是由服务 Identity 后跟全局唯一标识符 (GUID) 组成的，例如：service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. 另一种返回单个组的方法是指定服务 Identity，然后包含 Name 参数和代理组的名称。这使您可以检索特定的代理组，而无需知道分配给该组的 GUID。 如果调用不带任何参数的 Get-CsRgsAgentGroup，则将返回配置为在组织中使用的所有代理组的集合。 |
Name |
可选 |
字符串 |
创建代理组时赋予该组的唯一名称。 |
输入类型
字符串。Get-CsRgsAgentGroup 接受一个字符串值，代表响应组代理组的标识。
返回类型
Get-CsRgsAgentGroup 返回 Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsRgsAgentGroup
示例 1 返回配置为在组织中使用的所有响应组代理组。这是通过调用不带任何参数的 Get-CsRgsAgentGroup 实现的。
-------------------------- 示例 2 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
上述命令返回配置为在 ApplicationServer:atl-cs-001.litwareinc.com 服务上使用的所有响应组代理组。
-------------------------- 示例 3 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
示例 3 中显示的命令返回单个响应组代理组：ApplicationServer:atl-cs-001.litwareinc.com 服务上名为 Help Desk 的组。
-------------------------- 示例 4 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -eq "RoundRobin"}
在示例 4 中，返回 ApplicationServer:atl-cs-001.litwareinc.com 服务上所有响应组代理组的信息（假设这些组都使用循环路由方法）。为执行此操作，该命令首先使用 Get-CsRgsAgentGroup 以返回 ApplicationServer:atl-cs-001.litwareinc.com 上所有代理组的集合。然后将该集合通过管道传递到 Where-Object cmdlet，后者将仅选择 RoutingMethod 属性等于“RoundRobin”的组。
-------------------------- 示例 5 --------------------------
Get-CsRgsAgentGroup -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"}
示例 5 中使用的命令是示例 4 中所使用命令的变体，但在此示例中，返回 ApplicationServer:atl-cs-001.litwareinc.com 服务上未使用循环路由方法的所有响应组代理组的信息。为执行此操作，该命令首先调用 Get-CsRgsAgentGroup 以返回 ApplicationServer:atl-cs-001.litwareinc.com 上所有代理组的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者将仅选择 RoutingMethod 属性不等于“RoundRobin”的代理组。