Remove-CsCpsConfiguration
上次修改主題的時間： 2012-03-27
移除現有的通話駐留服務組態。通話保留代接是允許使用者「駐留」來電的服務。保留通話會將來電轉接到指定範圍內的號碼，然後立即保留此來電不掛斷。任何人 (不只是原來接聽電話的人) 只要輸入正確的號碼，就可以從任何電話恢復通話。
語法
Remove-CsCpsConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式可用來移除通話駐留服務組態。通話駐留服務組態會指定駐留通話後的動作。例如，如果保留通話在一段時間內沒有回應，則可自動轉接其他人 (例如系統管理員) 或回應群組。可以設定來電在一段期間後響鈴，以確保不會忘掉來電。此外，可以設定通話駐留服務在駐留通話時，向等待的來電者播放的等候音樂。
可以使用這個指令程式移除任何通話駐留組態，包括 Global 組態。但如果是 Global 設定，不會真的移除設定，而是重設為預設值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsCpsConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCpsConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
您要移除之通話駐留服務設定的唯一識別碼。這個識別碼將是 Global 或 site:<sitename>，其中 <sitename> 是設定套用之站台的名稱。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 物件。接受管線傳送的通話保留服務組態物件輸入。
傳回類型
移除 Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsCpsConfiguration -Identity site:Redmond1
前面的命令使用 Remove-CsCpsConfiguration 指令程式刪除 Identity 為 site:Redmond1 的通話駐留服務組態。由於是唯一的識別身分，因此這個命令只會刪除一個設定。
-------------------------- 範例 2 --------------------------
Get-CsCpsConfiguration -Filter site:* | Remove-CsCpsConfiguration
範例 2 會刪除所有已在站台範圍內定義的通話保留服務組態。為了執行這項工作，命令會先使用 Get-CsCpsConfiguration 搭配 Filter 參數，以傳回在站台範圍定義的所有通話駐留服務組態；萬用字元 site:* 可確保只傳回 Identity 以字串值 site:開頭的設定。然後將篩選過的集合傳送到 Remove-CsCpsConfiguration，它會繼續刪除集合中每一個項目。請注意，每當您移除站台中的通話保留服務設定時，站台便會自動開始使用於通用範圍內設定的通話保留服務設定。