Remove-CsCallParkOrbit
上次修改主題的時間： 2012-03-26
移除特定的通話駐留範圍。
語法
Remove-CsCallParkOrbit -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Remove-CsCallParkOrbit 指令程式會刪除含有已傳送給 Identity 參數 (此為必要參數) 之名稱的通話保留範圍。組織中每個通話保留範圍都必須具有唯一的號碼範圍。移除通話保留範圍會釋出該通話保留範圍中的範圍。接著釋出的號碼可用在新定義的通話保留範圍中。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsCallParkOrbit Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCallParkOrbit"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
字串 |
通話駐留範圍的名稱。此名稱由系統管理員在定義通話保留範圍時指派。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbit 物件。接受管線傳送的通話保留範圍物件輸入。
傳回類型
這個指令程式不會傳回值。它會移除 Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbit 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsCallParkOrbit -Identity "Redmond CPO 1"
這個範例中使用 Remove-CsCallParkOrbit 刪除名為 Redmond CPO 1 的通話駐留範圍。
-------------------------- 範例 2 --------------------------
Get-CsCallParkOrbit | Remove-CsCallParkOrbit
此範例中的命令會移除針對組織定義的所有通話駐留範圍。命令會先呼叫 Get-CsCallParkOrbit 指令參數且不搭配參數，以擷取所有已定義的通話駐留範圍。然後將通話駐留範圍集合傳送到 Remove-CsCallParkOrbit 指令程式，這會移除每個通話駐留範圍。
-------------------------- 範例 3 --------------------------
Get-CsCallParkOrbit -Filter *Redmond* | Remove-CsCallParkOrbit
這個命令會移除 identity 包含字串 "Redmond" 的所有通話駐留範圍，如 "Redmond 501"、"CP Redmond 1" 及 "ARedmond"。命令會先呼叫 Get-CsCallParkOrbit 並搭配 Filter 參數，以擷取 Identity 包含字串 Redmond 的所有通話駐留範圍。這個集合會傳送到 Remove-CsCallParkOrbit，它會移除集合中的所有內容。