Set-CsCpsConfiguration
上次修改主題的時間： 2012-03-26
修改現有的通話駐留服務設定集合。通話保留代接是允許使用者「駐留」來電的服務。駐留通話會將通話轉接至指定範圍的號碼，然後立即保留通話。任何人 (不只是原來接聽電話的人) 只要輸入正確的號碼，就可以從任何電話恢復通話。
語法
Set-CsCpsConfiguration [-Identity <XdsIdentity>] [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]
Set-CsCpsConfiguration [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式可用來修改現有的通話駐留服務組態。通話駐留服務組態會指定駐留通話後的動作。例如，如果駐留通話在一段時間內沒有回應，則可自動轉接其他人 (例如系統管理員) 或回應群組。可以設定來電在一段期間後響鈴，以確保不會忘掉來電。此外，可以設定通話駐留服務在駐留通話時，向等待的來電者播放的等候音樂。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsCpsConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCpsConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
字串 |
您要修改之設定的唯一識別碼。Identity 會指定套用設定的範圍，為通用或特定網站 (格式為 site:<網站名稱>，例如 site:Redmond)。 |
Instance |
選用 |
通話駐留服務設定 |
通話駐留服務組態物件的物件參考，類型為 Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 類型。呼叫 Get-CsCpsConfiguration 指令程式可以擷取此物件。接著可以變更此物件，而將物件傳回至此參數中的 Set-CsCpsConfiguration 即可儲存變更。 |
CallPickupTimeoutThreshold |
選用 |
時間範圍 |
從駐留通話之後到回撥原先接聽來電的電話之前所經過的時間長度。 這必須使用 hh:mm:ss 的格式輸入 (hh = 小時、mm = 分鐘、ss = 秒) 最小值：10 秒 (00:00:10)；最大值：10 分鐘 (00:10:00) |
EnableMusicOnHold |
選用 |
布林值 |
決定駐留通話時是否對來電者播放音樂。 Microsoft Lync Server 2010 隨附預設的等候音樂檔。您可以使用 Set-CsCallParkServiceMusicOnHoldFile 指令程式來變更此檔案 (進而變更在駐留通話時來電者所聽到的音樂)。 |
MaxCallPickupAttempts |
選用 |
Int32 |
在放棄駐留通話並轉接至遞補統一資源識別項 (URI) 之前，回撥接聽電話的次數。遞補 URI 會以 OnTimeoutURI 參數設定。 最小值：1; 最大值：10 |
OnTimeoutURI |
選用 |
字串 |
未接聽的駐留通話將轉接的使用者或回應群組的 SIP 位址。在超過 MaxCallPickupAttempts 參數所定義的回撥次數之後，將轉接駐留通話。如果該參數設為 Null，則會忽略 OnTimeoutURI，而駐留的通話會在回電嘗試不成功後中斷。 值必須是以字串 sip: 開頭的 SIP URI。例如，sip:rgs1@litwareinc.com。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 物件。接受管線傳送的通話保留服務組態物件輸入。
傳回類型
修改 Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2
範例 1 所示的命令會修改 Identity 為 site:Redmond1 的通話保留服務組態，方法是將保留的通話將回撥給接聽電話的次數上限設為 2。作法是加入 MaxCallPickupAttempts 參數，並將該參數值設為 2。
-------------------------- 範例 2 --------------------------
Get-CsCpsConfiguration | Set-CsCpsConfiguration -MaxCallPickupAttempts 2
範例 2 是範例 1 所示的命令變化；不過在此例中，所有 (並非僅限一個) 通話保留服務組態都將 MaxCallPickupAttempts 內容值設為 2。為達成此目的，請使用 Get-CsCpsConfiguration 擷取組織使用中的所有通話保留服務設定集合。然後，將此集合傳送至 Set-CsCpsConfiguration 指令程式，由此 cmdlet 取得集合中的每一個個別項目，並將 MaxCallPickupAttempts 屬性的值設為 2。
-------------------------- 範例 3 --------------------------
Set-CsCpsConfiguration -Identity site:Redmond1 -CallPickupTimeoutThreshold 00:00:45
此範例修改 Redmond 1 站台的通話駐留組態，方法是將駐留通話在回撥之前所經過的時間長度 (包含在 CallPickupTimeoutThreshold 屬性中) 設為 45 秒。