Get-CsRgsQueue
上次修改主題的時間： 2012-03-23
擷取用於組織的回應群組佇列資訊。透過 回應群組應用程式，來電會被放置在佇列中並保留，直到專員可接聽來電。
語法
Get-CsRgsQueue [-Identity <RgsIdentity>] [-Name <String>]
詳細描述
如果某人撥打與 回應群組應用程式 相關聯的電話號碼，通常會發生下列兩件事的其中之一：來電會被轉接至一個問題，而來電者必須回答才能繼續 (例如，「硬體支援請按 1；軟體支援請按 2」)，或來電會被放置在佇列中，直到回應群組專員可接聽來電。
回應群組應用程式 可讓您建立與不同工作流程和不同回應群組專員群組相關聯的多個佇列，而不是所有來電者都使用單一佇列。依序表示佇列可分別回應事件，例如指定的來電號碼被同步保留在佇列中，或以指定的秒數保留來電者。
Get-CsRgsQueue 指令程式提供您傳回用於組織的回應群組佇列資訊的方法。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsRgsQueue Cmdlet：RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsQueue"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Rgs 識別 |
代表主控回應群組佇列的服務識別，或佇列本身的完整識別。如果您有指定服務識別 (例如 service:ApplicationServer:atl-cs-001.litwareinc.com)，則該服務主控的所有回應群組佇列都會被傳回。如果您指定佇列的識別，則只有指定的回應群組佇列會被傳回。請注意，佇列的識別由服務識別後面加上全域唯一識別碼 (GUID) 所組成，例如：service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83。 還有另一種方法可傳回單一回應群組佇列，就是指定服務識別，然後再加上 Name 參數和佇列名稱。這可讓您不必知道指派給佇列的 GUID 為何，就能擷取特定的回應群組佇列。 如果不含任何參數呼叫，Get-CsRgsQueue 會傳回設定用於組織的所有回應群組佇列。 |
Name |
選用 |
字串 |
建立佇列時給予回應群組佇列的唯一名稱。 |
輸入類型
字串。Get-CsRgsQueue 接受字串值，代表回應群組佇列的 Identity。
傳回類型
Get-CsRgsQueue 會傳回 Microsoft.Rtc.Rgs.Management.WritableSettings.Queue 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
上述命令傳回已設定在組織中使用的所有回應群組佇列的相關資訊。您可以藉由呼叫沒有任何參數的 Get-CsRgsQueue 來完成。
-------------------------- 範例 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
範例 2 所示的命令會傳回位於 ApplicationServer:atl-cs-001.litwareinc.com 服務的所有回應群組佇列。
-------------------------- 範例 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
範例 3 會傳回單一回應群組佇列的資訊：位於 ApplicationServer:atl-cs-001.litwareinc.com 服務上，名為 "Help Desk" 的佇列。
-------------------------- 範例 4 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty TimeoutAction
範例 4 所示的命令會顯示在 ApplicationServer:atl-cs-001.litwareinc.com 服務上找到的每一個回應群組佇列的 TimeoutAction 屬性詳細資訊。為了完成這項工作，先使用 Get-CsRgsQueue 傳回在 ApplicationServer:atl-cs-001.litwareinc.com 上找到的所有佇列資訊。接著，此資訊傳送至 Select-Object 指令程式，此指令程式會「展開」TimeoutAction 內容中儲存的值。當您展開 TimeoutAction 內容時，您會看到內嵌物件中構成內容值的個別內容：Prompt、TargetQuestion、Target、TargetQueueID 與 TargetUri。
-------------------------- 範例 5 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"}
上述命令會傳回在 ApplicationServer:atl-cs-001.litwareinc.com 上，OverflowCandidate 屬性設定為 NewestCall 的所有回應群組佇列相關資訊。為了完成這項工作，命令會先使用 Get-CsRgsQueue 傳回在指定服務上找到之所有回應群組佇列的集合。然後，該集合便會被傳送到 Where-Object 指令程式，該指令程式只會選取 OverflowCandidate 屬性等於 "NewestCall" 的佇列。