Set-CsRgsAgentGroup
上次修改主題的時間： 2012-03-23
修改現有的回應群組專員群組。專員群組是指派給回應群組佇列的專員集合。專員是被指派接聽導向到特定佇列來電的使用者。
語法
Set-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
當某人撥打與回應群組應用程式相關聯的電話號碼時，服務會先判斷哪一個工作流程對應至所撥的號碼。系統會根據該工作流程組態，將來電路由傳送至一組互動語音回應 (IVR) 問題 (語音會詢問來電者一或多個類似「此問題是有關硬體支援或軟體支援？」等問題)。或者，來電可能會被放置在回應群組佇列中；來電者會被保留，直到指定的人員可接聽來電。被指定要接聽來電的人員就是所謂的專員，而一組集中的專員就是回應群組專員群組。專員群組與工作流程相關聯，而且會進一步和工作職責相關聯：服務台人員會分至 Help Desk 專員群組，客戶支援專員則會分至 Customer Support 專員群組。
使用 New-CsRgsAgentGroup 指令程式可建立新的專員群組。如果您必須在專員群組建立之後變更，請使用 Set-RgsAgentGroup 指令程式；此外，這個指令程式可用來新增和移除群組的個別專員。請注意，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 指令程式來擷取，並將傳回的值指派至變數；例如，此命令會將物件參考傳回至佇列 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 不會傳回任何物件或值。反而是由指令程式修改 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 所示的命令會修改回應群組專員群組 Help Desk (可在 ApplicationServer:atl-cs-001.litwareinc.com 服務上找到) 的 RoutingMethod 屬性。為了執行這項工作，命令會先使用 Get-CsRgsAgentGroup 指令程式，從 ApplicationServer:atl-cs-001.litwareinc.com 擷取 Help Desk 專員群組 (-Name "Help Desk")。擷取之後，專員群組物件會儲存在名為 $x 的變數中。
範例中的命令 2 會修改 RoutingMethod 內容的值。在範例的最後一個命令中，Set-CsRgsAgentGroup 指令程式可用來將這些變更寫入實際的 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 的變數中。
範例的第二個命令會將新值 (helpdesk@litwareinc.com) 指派給 DistributionGroupAddress 屬性。指派新值之後，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 的變數中。
第二個命令會使用新增方法將新專員加入 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 的變數中。
擷取專員群組之後，您可以使用移除方法移除群組的專員 (含有 SIP 位址 "sip:kenmyer@litwareinc.com" 的專員)。接著命令 3 會呼叫 Set-CsRgsAgentGroup，以從群組寫入變更 (亦即移除專員)。如果您沒有呼叫 Set-CsRgsAgentGroup，則變更只會在記憶體中進行，而不會套用到實際的專員群組；只有呼叫 Set-CsRgsAgentGroup，才會移除專員。