New-CsRgsQueue
上次修改主題的時間： 2012-03-23
建立新的回應群組佇列。透過 回應群組應用程式，來電會被放置在佇列中並保留，直到回應群組專員可接聽來電。
語法
New-CsRgsQueue -Parent <RgsIdentity> -Name <String> [-AgentGroupIDList <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-OverflowAction <CallAction>] [-OverflowCandidate <NewestCall | OldestCall>] [-OverflowThreshold <Nullable>] [-TimeoutAction <CallAction>] [-TimeoutThreshold <Nullable>] [-WhatIf [<SwitchParameter>]]
詳細描述
如果某人撥打與 回應群組應用程式 相關聯的電話號碼，通常會發生下列兩件事的其中之一：來電會被轉接至一個問題，而來電者必須回答才能繼續 (例如，「硬體支援請按 1；軟體支援請按 2」)，或來電會被放置在佇列中，直到專員可接聽來電。
回應群組應用程式 可讓您建立與不同工作流程和不同回應群組專員群組相關聯的多個佇列，而不是所有來電者都使用單一佇列。這表示佇列可以分別回應事件，例如佇列會同時保留指定數目的來電，或回應已保留了指定時間的來電者。
New-CsRgsQueue 指令程式可讓系統管理員輕鬆建立新的回應群組佇列。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsRgsQueue Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsQueue"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Parent |
必要 |
Rgs 識別 |
主控新佇列的服務。例如：-Parent "service:ApplicationServer:atl-cs-001.litwareinc.com"。 |
Name |
必要 |
字串 |
指派給佇列的唯一名稱。Parent 屬性和 Name 屬性的組合可讓您唯一識別營業回應群組佇列，而不必參考佇列的全域唯一識別碼 (GUID)。 |
AgentGroupIdList |
選用 |
AgentGroup 集合 |
要新增到佇列的回應群組專員群組的 Identity。使用 Get-CsRgsAgentGroup 指令程式可以擷取專員群組的 Identity。如需詳細資料，請參閱本主題中的＜範例＞區段。 如果來電轉送到未指派專員群組的佇列 (或僅指派沒有任何專員的專員群組)，則會自動切斷來電。 |
Description |
選用 |
字串 |
讓系統管理員能夠提供有關回應群組佇列的其他資訊。 |
OverflowAction |
選用 |
CallAction 物件 |
如果到達溢位臨界值時採取的動作。OverflowAction 必須使用 New-CsRgsCallAction 指令程式建立。 |
OverflowCandidate |
選用 |
PS 清單修改程式 |
指出如果已達溢位臨界值時應對來電採取的動作。OverflowCandidate 屬性必須設為以下兩個值之一： NewestCall OldestCall 預設值為 NewestCall。 |
OverflowThreshold |
選用 |
整數 |
任何一個時間可同時在佇列中的來電數目，超過此數目即觸發溢位動作。OverflowThreshold 可以是介於 0 和 1000 (含) 之間的任何整數值。預設值是 Null，表示在任何指定的時間中可在佇列中的來電數目沒有限制。 |
TimeoutAction |
選用 |
CallAction 物件 |
如果到達逾時臨界值時採取的動作。TimeoutAction 必須使用 New-CsRgsCallAction 指令程式建立。 |
TimeoutThreshold |
選用 |
整數 |
來電可保留在佇列中的時間 (單位為秒)，來電過了這段時間後便算逾時。到時候系統便會採取由 TimeoutAction 參數指定的動作。 逾時臨界值可由任何介於 10 到 65535 秒 (含) (約 18 個小時) 的整數；預設值為 Null，這表示佇列永不逾時。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
輸入類型
無。New-CsRgsQueue 不接受管線傳送的輸入。
傳回類型
New-CsRgsQueue 會建立 Microsoft.Rtc.Rgs.Management.WritableSettings.Queue 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
$x = New-CsRgsCallAction -Action TransferToVoicemailUri -Uri "sip:+14255551298@litwareinc.com"
New-CsRgsQueue -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -OverflowCandidate "OldestCall" -OverflowAction $x -OverflowThreshold 25
範例 1 會為 ApplicationServer:atl-cs-001.litwareinc.com 服務建立新的回應群組佇列。範例中的第一個命令使用 New-CsRgsCallAction Cmdlet 建立佇列的來電動作；在此範例中，只要超過溢位臨界值，來電就會自動轉接到語音信箱。這是透過將 Action 參數設為 TransferToVoicemailUri，並將 URI 內容設為語音信箱 SIP URI "sip:+14255551298@litwareinc.com" 來設定。
設定來電動作之後 (並儲存在變數 $x)，New-CsRgsQueue 便用來建立名為 Help Desk 的新佇列。除了指定 OverflowAction，此命令也設定 OverflowCandidate 和 OverflowThreshold 內容的值。