Remove-CsRgsAgentGroup
上次修改主題的時間： 2012-05-21
移除現有的回應群組專員群組。專員群組是指派給回應群組佇列的專員集合。專員是被指派接聽導向到特定佇列來電的使用者。
語法
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
當某人撥打與回應群組應用程式相關聯的電話號碼時，服務會先判斷哪一個工作流程對應至所撥的號碼。系統會根據該工作流程組態，將來電路由傳送至一組互動語音回應 (IVR) 問題 (語音會詢問來電者一或多個類似「此問題是有關硬體支援或軟體支援？」等問題)。或者，來電可能會被放置在回應群組佇列中；來電者會被保留，直到有人員接聽來電。被指定要接聽來電的人員就是所謂的專員，而一組集中的專員就是回應群組專員群組。專員群組與工作流程相關聯，並進一步與類似的工作責任產生關聯；例如，服務台人員會分組到 Help Desk 專員群組，客戶支援專員則會分組到 Customer Support 專員群組。
使用 New-CsRgsAgentGroup 指令程式可建立新的專員群組。如果您必須刪除專員群組，只能透過呼叫 Remove-CsRgsAgentGroup 指令程式來完成。請注意，此指令程式會刪除整個群組，以及該群組中所有的專員。如果您只要移除群組中的單一專員，請改用 Set-CsRgsAgentGroup 指令程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsRgsAgentGroup Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsAgentGroup"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Instance |
必要 |
AgentGroup 物件 |
指向要移除之代理群組的物件參考。將工作流程物件傳送到 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 指令程式，並由此指令程式移除。
-------------------------- 範例 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，如此即可刪除該集合中的各個項目。