Remove-CsRgsAgentGroup
上一次修改主题： 2012-05-21
删除现有响应组代理组。代理组是分配给某个响应组队列的代理的集合。代理是分配为应答定向到特定队列的呼叫的用户。
语法
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
当有人呼叫与响应组应用程序关联的电话号码时，该服务将首先确定与被叫号码对应的工作流。基于该工作流的配置，可能会将该呼叫路由至一组互动语音响应问题 (IVR)（向呼叫者提出诸如“此问题是关于硬件支持还是软件支持？”等一个或多个问题）。或者，该呼叫也可能被置于响应组队列中；在有人可以接听该电话之前，呼叫者将一直处于呼叫等待状态。指定应答呼叫的人员称为代理，而代理集合在一起构成的组则称为响应组代理组。代理组与工作流相关联，进而与工作职责之类的内容相关联；例如，技术支持人员可能会被划分到 Help Desk 代理组，而客户支持代理可能会被划分到 Customer Support 代理组。
新代理组是使用 New-CsRgsAgentGroup cmdlet 创建的。如果需要删除代理组，可以通过调用 Remove-CsRgsAgentGroup cmdlet 完成该操作。请注意，此 cmdlet 会删除整个组以及组中的所有代理。如果只想删除组中的单个代理，请改用 Set-CsRgsAgentGroup cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsRgsAgentGroup cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsAgentGroup"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Instance |
必需 |
代理组对象 |
指向要删除的代理组的对象引用。通过管道将工作流对象传递到 Remove-CsRgsAgentGroup 时，可以省略 Instance 参数。 要使用 Instance 参数，请使用类似如下的命令： $x = Get-CsRgsAgentGroup –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsAgentGroup –Instance $x 请注意，使用 Instance 参数时一次只能删除一个代理组。这意味着，对象引用 ($x) 不能包含多个代理组对象。 |
Force |
可选 |
开关参数 |
强制删除代理组。如果存在此参数，将在没有任何警告的情况下删除代理组，即使该代理组正被活动的工作流使用也是如此。如果不存在此参数，则删除当前正被活动工作流使用的任何代理组时，系统会要求您确认。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup 对象。Remove-CsRgsAgentGroup 接受通过管道传递的响应组代理组对象的实例。
返回类型
Remove-CsRgsAgentGroup 删除 Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsAgentGroup
上述命令删除配置为在服务 ApplicationServer:atl-cs-001.litwareinc.com 上使用的所有响应组代理组。为执行此操作，该命令首先使用 Get-CsRgsAgentGroup 返回 ApplicationServer:atl-cs-001.litwareinc.com 的所有代理组。然后将这些组通过管道传递到 Remove-CsRgsAgentGroup cmdlet，并由其删除。
-------------------------- 示例 2 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" | Remove-CsRgsAgentGroup
在示例 2 中，删除了一个响应组代理组：名为 Help Desk 的组。为执行此任务，首先使用 Get-CsRgsAgentGroup 从 ApplicationServer:atl-cs-001.litwareinc.com 返回 Help Desk 代理组 (-Name "Help Desk")。然后，将此组通过管道传递到 Remove-CsRgsAgentGroup，后者会将该组从服务中删除。
-------------------------- 示例 3 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"} | Remove-CsRgsAgentGroup
示例 3 删除 ApplicationServer:atl-cs-001.litwareinc.com 上不使用循环路由方法的所有响应组代理组。为执行此操作，首先调用 Get-CsRgsAgentGroup 以返回在服务 ApplicationServer:atl-cs-001.litwareinc.com 上找到的所有代理组的集合。然后将该集合通过管道传递到 Where-Object cmdlet，后者将仅挑选出 RoutingMethod 属性不等于 (-ne) RoundRobin 的组。然后，将筛选出的集合通过管道传递到 Remove-CsRgsAgentGroup，后者将删除此集合中的每一项。