New-CsCpsConfiguration
上次修改主題的時間： 2012-03-23
建立新的通話保留服務設定集合。通話保留代接是允許使用者「駐留」來電的服務。保留通話會將來電轉接到指定範圍中的號碼，並立即保留來電。任何人 (不只是原來接聽來電的人) 只要輸入正確的號碼，就可以從任何電話繼續談話。
語法
New-CsCpsConfiguration -Identity <XdsIdentity> [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
使用這個指令程式建立新的通話駐留服務組態。安裝通話保留服務時，預設會設定通用設定，可更新但無法移除 (「移除」通用設定只會將其重設為預設值)。因此這個指令程式用來只建立特定站台的設定。
通話駐留服務組態會指定駐留通話後的動作。例如，如果保留通話在一段時間內沒有回應，則可自動轉接其他人 (例如系統管理員) 或回應群組。可以設定來電在一段期間後響鈴，以確保不會忘掉來電。此外，可以設定通話駐留服務在駐留通話時，向等待的來電者播放的等候音樂。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsCpsConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsCpsConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
套用設定的站台。必須使用 site:<sitename> 的格式輸入，例如 site:Redmond。組態一律會存在於全域範圍且無法移除，如此便無法利用此指令程式重新建立通用組態。 |
CallPickupTimeoutThreshold |
選用 |
TimeSpan |
從保留通話之後到回撥原先接聽來電的電話之前所經過的時間長度。 這必須使用 hh:mm:ss 的格式輸入 (hh = 小時、mm = 分鐘、ss = 秒) 預設值：00:01:30 (90 秒)；最小值：10 秒 (00:00:10)；最大值：10 分鐘 (00:10:00) |
EnableMusicOnHold |
選用 |
布林值 |
決定保留通話時是否對來電者播放音樂。 Microsoft Lync Server 2010 隨附預設的等候音樂檔。您可以使用 Set-CsCallParkServiceMusicOnHoldFile 指令程式來變更此檔案 (進而變更在保留通話時來電者所聽到的音樂)。 預設值：True |
MaxCallPickupAttempts |
選用 |
Int32 |
在放棄保留通話並轉接至遞補統一資源識別項 (URI) 之前，回撥接聽電話的次數。遞補 URI 會以 OnTimeoutURI 參數設定。 預設值：1；最大值：1; 最大值：10 |
OnTimeoutURI |
選用 |
字串 |
未接聽的保留通話將轉接的使用者或回應群組的 SIP 位址。在超過 MaxCallPickupAttempts 參數所定義的回撥次數之後，將轉接保留通話。如果該參數設為 Null，將忽略 OnTimeoutURI，且在嘗試響鈴失敗後保留的通話將斷線。 值必須是以字串 sip: 開頭的 SIP URI。例如，sip:rgs1@litwareinc.com。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
此指令程式會建立 Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False
範例 1 所示的命令會使用 New-CsCpsConfiguration 指令程式為站台 Redmond1 建立通話駐留服務組態。這個組態將使用預設值建立 (除了 EnableMusicOnHold 以外)。這個命令將此屬性設定為 False，表示已駐留其通話的來電者在等待時不會聽到任何內容 (EnableMusicOnHold 預設為 True，假設已部署通話駐留服務)。
-------------------------- 範例 2 --------------------------
New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com
範例 2 所示的命令會使用 New-CsCpsConfiguration 指令程式為站台 Redmond1 建立通話駐留服務組態。預設不會提供 OnTimeoutURI，因此這個範例會新增該參數的值。在此例中，OnTimeoutURI 設定為 sip:kenmyer@litwareinc.com。傳遞到這個參數的值必須以字串 "sip:" 為開頭，而且應指向在指定的響鈴嘗試次數後要接到未接聽之保留通話的使用者或「回應群組」。
-------------------------- 範例 3 --------------------------
New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2
這個命令使用 New-CsCpsConfiguration 指令程式為站台 Redmond1 建立通話駐留服務組態。將這個站台的 MaxCallPickupAttempts 設定為 2，表示來電最多撥回兩次。