New-CsRgsAgentGroup
上一次修改主题： 2012-03-23
创建新的响应组代理组。代理组是分配给某个响应组队列的代理的集合。代理是分配为应答定向到特定队列的呼叫的用户。
语法
New-CsRgsAgentGroup -Parent <RgsIdentity> -Name <String> [-AgentAlertTime <Int16>] [-AgentsByUri <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DistributionGroupAddress <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-ParticipationPolicy <Informal | Formal>] [-RoutingMethod <LongestIdle | Serial | Parallel | RoundRobin | Attendant>] [-WhatIf [<SwitchParameter>]]
详细说明
当有人呼叫与响应组应用程序关联的电话号码时，该应用程序将首先确定与被叫号码对应的工作流。基于该工作流的配置，可能会将该呼叫路由至一组互动语音响应问题 (IVR)（向呼叫者提出诸如“此问题是关于硬件支持还是软件支持？”等一个或多个问题）。或者，也可能将该呼叫置于响应组队列中；此时呼叫者将被置于呼叫等待状态，直到指定的人员可以应答呼叫。指定应答呼叫的人员称为代理，而代理集合在一起构成的组则称为响应组代理组。代理组与队列相关联，并进一步与类似的工作职责相关联：技术支持人员可能组成 Help Desk 代理组，而客户支持代理则组成 Customer Support 代理组。
如果为某队列分配了多个组，响应组应用程序将首先对分配给该队列的第一组中的所有可用代理响铃。如果这些代理均无应答，则该应用程序将开始对分配给队列的下一组中的所有可用代理响铃。
新代理组是使用 New-CsRgsAgentGroup cmdlet 创建的。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsRgsAgentGroup cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "New-CsRgsAgentGroup"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Name |
必需 |
字符串 |
要分配给代理组的唯一名称。通过组合 Parent 属性和 Name 属性，您可以唯一标识组队列，而无需参考队列的 GUID（全局唯一标识符）。 |
Parent |
必需 |
Rgs 标识 |
将托管新代理组的服务。例如：-Parent "service:ApplicationServer:atl-cs-001.litwareinc.com"。 |
AgentAlertTime |
可选 |
整数 |
代表呼叫在被自动路由到下一个代理之前，可以保持未应答状态的时间（以秒为单位）。AgentAlertTime 可设置为 10 到 600 秒（10 分钟）之间（包含边界值）的任意整数值。默认值为 20 秒。注意：代理警报时间设置不能超过 180 秒，否则客户端应用程序会因为 SIP 事务计时器达到其最大等待时间而拒绝呼叫。若要避免出现此情况，请将警告时间值设置为小于 180 秒的值。 |
AgentsByUri |
可选 |
代理收集 |
使您可以向代理组逐个添加代理。使用 SIP 地址标识新代理。 |
Description |
可选 |
字符串 |
使管理员可以提供有关代理组的其他说明信息。例如，Description 中可能包含在组未接收到预期电话呼叫时可与其联系的联系人的信息。 |
DistributionGroupAddress |
可选 |
字符串 |
使您可以向代理组添加通讯组的所有成员。 |
ParticipationPolicy |
可选 |
PS 列表修饰符 |
指示是否要求代理正式登录系统才能接收向组发出的电话呼叫。如果 ParticipationPolicy 设置为 Informal（默认值），则不要求登录。如果 ParticipationPolicy 设置为 Formal，则要求登录。 |
RoutingMethod |
可选 |
PS 列表修饰符 |
指定用于将新呼叫路由至代理的方法。RoutingMethod 必须设置为下列值之一： LongestIdle – 将呼叫路由至空闲（即不在 Microsoft Lync 2010 活动中）时间最长的代理。 RoundRobin – 将呼叫路由至列表中的下一个代理。 Serial – 始终将呼叫路由至列表中的第一个代理，且仅当该代理不可用或未在限定的时间内应答时才路由至其他代理。 Parallel – 将呼叫同时路由至所有代理（状态指示正在通话中或因其他原因而不可用的代理除外）。 Attendant – 将呼叫同时路由至所有代理（即使代理的状态指示其正在通话中或因其他原因而不可用）。当代理将其状态设置为“请勿打扰”时，将会出现唯一的例外情况。 默认的路由方法为 Parallel。 |
Force |
可选 |
GUID |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
输入类型
无。New-CsRgsAgentGroup 不接受通过管道传递的输入。
返回类型
New-CsRgsAgentGroup 创建 Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsRgsAgentGroup -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Group"
示例 1 中显示的命令创建名为 Help Desk Group 的新响应组代理组；该新组位于 ApplicationServer:atl-cs-001.litwareinc.com 服务上。为创建此组，该命令调用了带有 Parent 参数和 Name 参数的 New-CsRgsAgentGroup。在此示例中，未指定其他任何组参数，这意味着该组将使用所有默认属性值。由于没有为此组分配代理，路由至新代理组的任何呼叫都将会自动断开连接。
-------------------------- 示例 2 --------------------------
New-CsRgsAgentGroup -Parent service: ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Group" -AgentsByUri "sip:kenmyer@litwareinc.com","sip:pilarackerman@litwareinc.com"
在示例 2 中，创建了新的响应组代理组，同时为该组分配了一对代理。为执行此操作，该命令调用了带有 Parent 参数和 Name 参数的 New-CsRgsAgentGroup。此外，此示例还包含 AgentsByUri 参数，并附带参数值 "sip:kenmyer@litwareinc.com","sip:pilarackerman@litwareinc.com"。该值是一个由要添加到代理组的 SIP 地址组成的逗号分隔列表。