Get-CsRgsAgentGroup
上次修改主題的時間： 2012-03-23
傳回設定用於組織的回應群組專員群組相關資訊。專員群組是指派給回應群組佇列的專員集合。專員是被指派接聽導向到佇列來電的使用者。
語法
Get-CsRgsAgentGroup [-Identity <RgsIdentity>] [-Name <String>]
詳細描述
當某人撥打與 回應群組應用程式 相關聯的電話號碼時，應用程式會先判斷所撥號碼對應的工作流程。系統會根據該工作流程組態，將來電路由傳送至一組互動語音回應 (IVR) 問題 (語音會詢問來電者一或多個類似「此問題是有關硬體支援或軟體支援？」等問題)。或者，來電可能會被放置在回應群組佇列中；來電者會被保留，直到指定的人員可接聽來電。被指定要接聽來電的人員就是所謂的專員，而一組集中的專員就是回應群組專員群組。專員群組與工作流程相關聯，甚至和類似的工作職責相關聯：服務台人員會分至 Help Desk 專員群組，客戶支援專員則會分至 Customer Support 專員群組。
Get-CsRgsAgentGroup 指令程式能讓您傳回目前用於組織之回應群組專員群組的相關資訊，這包括已指派給每個專員群組的使用者相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsRgsAgentGroup Cmdlet：RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsAgentGroup"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Rgs 識別 |
表示主控回應群組專員群組的服務 Identity，或是專員群組本身的完整 Identity。如果您有指定服務識別 (例如 service:ApplicationServer:atl-cs-001.litwareinc.com)，則該服務主控的所有專員群組都會被擷取。如果您有指定群組的識別，則只會傳回所指定的專員群組。請注意，專員群組的 Identity 是由服務 Identity 後面加上全域唯一識別碼 (GUID) 所組成，例如：service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. 還有另一種方法可傳回單一群組，就是指定服務 Identity，然後再包含後面加上專員群組名稱的 Name 參數。這可讓您不必知道指派給群組的 GUID 為何，就能擷取特定的專員群組。 如果不使用任何參數呼叫，Get-CsRgsAgentGroup 會傳回設定用於組織的所有專員群組。 |
Name |
選用 |
字串 |
建立群組時給予專員群組的唯一名稱。 |
輸入類型
字串。Get-CsRgsAgentGroup 會接受代表回應群組專員群組之 Identity 的字串值。
傳回類型
Get-CsRgsAgentGroup 會傳回 Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsRgsAgentGroup
範例 1 會傳回所有針對在組織中使用而設定的回應群組專員群組。作法是呼叫 Get-CsRgsAgentGroup 且不搭配任何參數。
-------------------------- 範例 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
上述命令會傳回所有設定用於 ApplicationServer:atl-cs-001.litwareinc.com 服務的回應群組專員群組。
-------------------------- 範例 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
範例 3 所示的命令會傳回單一回應群組專員群組：在 ApplicationServer:atl-cs-001.litwareinc.com 服務上找到之名為 Help Desk 的群組。
-------------------------- 範例 4 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -eq "RoundRobin"}
範例 4 中，如果 ApplicationServer:atl-cs-001.litwareinc.com 服務所有的回應群組專員群組，使用的是循環配置資源路由方法，則會傳回該服務上這些專員群組的資訊。為了完成這項工作，命令會先使用 Get-CsRgsAgentGroup 傳回 ApplicationServer:atl-cs-001.litwareinc.com 上所有專員群組的集合。此集合便會被傳送到 Where-Object 指令程式，這樣只會選取 RoutingMethod 屬性等於 "RoundRobin" 的群組。
-------------------------- 範例 5 ------------------------
Get-CsRgsAgentGroup -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"}
範例 5 中使用的命令是範例 3 中所用之命令的變化，但在此狀況下會傳回 ApplicationServer:atl-cs-001.litwareinc.com 服務不使用循環配置資源路由方法的所有回應群組專員群組的資訊。如果要執行這項作業，命令一開始會呼叫 Get-CsRgsAgentGroup 傳回 ApplicationServer:atl-cs-001.litwareinc.com 所有專員群組的集合。此集合便會被傳送到 Where-Object 指令程式，該指令程式只會選取 RoutingMethod 屬性等於 "RoundRobin" 的專員群組。