Set-CsRgsAgentGroup
上一次修改主题： 2012-03-23
修改现有的响应组代理组。代理组是分配给某个响应组队列的代理的集合。代理是分配为应答定向到特定队列的呼叫的用户。
语法
Set-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
当有人呼叫与响应组应用程序关联的电话号码时，该服务将首先确定与被叫号码对应的工作流。基于该工作流的配置，可能会将该呼叫路由至一组互动语音响应问题 (IVR)（向呼叫者提出诸如“此问题是关于硬件支持还是软件支持？”等一个或多个问题）。或者，也可能将该呼叫置于响应组队列中；此时呼叫者将被置于呼叫等待状态，直到指定的人员可以应答呼叫。指定应答呼叫的人员称为代理，而代理集合在一起构成的组则称为响应组代理组。代理组与工作流相关联，并进一步与类似的工作职责相关联：技术支持人员可能组成 Help Desk 代理组，而客户支持代理则组成 Customer Support 代理组。
新代理组是使用 New-CsRgsAgentGroup cmdlet 创建的。创建代理组后，如果需要对其做出更改，请使用 Set-RgsAgentGroup cmdlet，该 cmdlet 的功能之一是向组中添加和从组中删除单个代理。请注意，Set-CsRgsAgentGroup 不会直接修改代理组的属性。如果需要修改组，必须首先创建对该组的对象引用；这可以通过调用 Get-CsRgsAgentGroup 检索该组，然后将返回的对象存储在变量中来实现。创建对象引用后，可以在内存中更改组属性。完成修改后，必须调用 Set-CsRgsAgentGroup 将更改写入实际的响应组代理组。如果不调用 Set-CsRgsAgentGroup，所做的更改将仅存在于内存中，并将在您关闭 Windows PowerShell 或删除对象引用变量后立即消失。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsRgsAgentGroup cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRgsAgentGroup"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Instance |
必需 |
AgentGroup 对象 |
要修改的响应组代理组的对象引用。通常通过使用 Get-CsRgsAgentGroup cmdlet 并将返回值分配给变量来检索对象引用；例如，以下命令可返回对 Help Desk 代理组的对象引用，并将该对象引用存储在名为 $x 的变量中： $x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk " |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup 对象。Set-CsRgsAgentGroup 接受通过管道传递的响应组代理组对象的实例。
返回类型
Set-CsRgsAgentGroup 不会返回任何对象或值。此 cmdlet 会修改 Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.RoutingMethod = "RoundRobin"
Set-CsRgsAgentGroup -Instance $x
示例 1 中显示的命令修改位于 ApplicationServer:atl-cs-001.litwareinc.com 服务上的响应组代理组 Help Desk 的 RoutingMethod 属性。为执行此任务，该命令首先使用 Get-CsRgsAgentGroup cmdlet 从 ApplicationServer:atl-cs-001.litwareinc.com 检索 Help Desk 代理组 (-Name "Help Desk")。完成检索后，将代理组对象存储在名为 $x 的变量中。
示例中的命令 2 会修改 RoutingMethod 属性的值。在此示例的最后一个命令中，使用 Set-CsRgsAgentGroup cmdlet 将这些更改写入实际的 Help Desk 代理组。
-------------------------- 示例 2 --------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.DistributionGroupAddress = "helpdesk@litwareinc.com"
Set-CsRgsAgentGroup -Instance $x
示例 2 说明如何更改分配给响应组代理组的通讯组。为执行此操作，首先使用 Get-CsRgsAgentGroup 以返回要修改的代理组；在此示例中，该代理组是 ApplicationServer:atl-cs-001.litwareinc.com 服务上的 Help Desk 组 (-Name "Help Desk")。Get-CsRgsAgentGroup 返回该组后，将生成的对象存储在名为 $x 的变量中。
此示例中的第二个命令为 DistributionGroupAddress 属性分配新值 (helpdesk@litwareinc.com)。分配新值后，使用 Set-CsRgsAgentGroup 将更改写入 ApplicationServer:atl-cs-001.litwareinc.com 上的 Help Desk 代理组。
-------------------------- 示例 3 --------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Add("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
示例 3 中显示的命令向响应组代理组 Help Desk 添加新代理。为执行此操作，该示例首先使用 Get-CsRgsAgentGroup 从 ApplicationServer:atl-cs-001.litwareinc.com 服务返回 Help Desk 组 (-Name "Help Desk")。将检索到的对象存储在名为 $x 的变量中。
在第二个命令中，使用 Add 方法向 AgentsByUri 属性添加新代理；这是通过指定新代理的 SIP 地址（“sip:kenmyer@litwareinc.com”）来实现的。在第 3 个命令中，使用 Set-CsRgsAgentGroup 将更改（即添加新代理）写入 Help Desk 组。请注意，如果不调用 Set-CsRgsAgentGroup，更改将仅在内存中进行，并且不会应用于实际的代理组。
-------------------------- 示例 4 --------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Remove("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
在示例 4 中，从 ApplicationServer:atl-cs-001.litwareinc.com 服务上的响应组代理组 Help Desk 删除了一个代理。为执行此操作，此示例首先使用 Get-CsRgsAgentGroup 从 ApplicationServer:atl-cs-001.litwareinc.com 返回 Help Desk 组 (-Name "Help Desk")。将检索到的代理组对象存储在名为 $x 的变量中。
检索到代理组后，使用 Remove 方法从组中删除一个代理（SIP 地址为“sip:kenmyer@litwareinc.com”的代理）。在第 3 个命令中，调用 Set-CsRgsAgentGroup 写入对组所做的更改（即删除代理）。如果不调用 Set-CsRgsAgentGroup，更改将仅在内存中进行，并且不会应用于实际的代理组；只有调用 Set-CsRgsAgentGroup，才会删除代理。