Remove-CsVoiceRoute
上次修改主題的時間: 2012-03-25
移除語音路由。語音路由包含一些指示,告知 Microsoft Lync Server 2010 如何將 Enterprise Voice 使用者的來電轉接至公用交換電話網路 (PSTN) 或專用交換機 (PBX) 上的電話號碼。
語法
Remove-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
使用此指令程式移除現有的語音路由。語音路由透過 PSTN 使用方式和語音原則相關聯,因此移除語音路由並不會變更和語音原則相關的任何值,只會變更和刪除之語音路由模式相符之號碼的路由。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsVoiceRoute Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsVoiceRoute"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
XdsGlobalRelativeIdentity |
唯一識別您要刪除之語音路由的字串(如果路由名稱包含空格 (例如 Test Route),必須使用雙引號括住整個字串)。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 物件。接受語音路由物件管線傳送的輸入。
傳回類型
移除 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsVoiceRoute -Identity Route1
移除識別為 Route1 的語音路由設定。
-------------------------- 範例 2 --------------------------
Get-CsVoiceRoute | Remove-CsVoiceRoute
這個命令會移除組織中所有的語音路由。首先由 Get-CsVoiceRoute 指令程式擷取所有的語音路由。然後將這些語音路由傳送至 Remove-CsVoiceRoute,進而移除每個路由。
-------------------------- 範例 3 --------------------------
Get-CsVoiceRoute -Filter *Redmond* | Remove-CsVoiceRoute
這個命令會移除識別中包含字串 "Redmond" 的所有語音路由。首先使用 Filter 參數呼叫 Get-CsVoiceRoute 指令程式。Filter 參數的值是 Redmond 字串且前後加上萬用字元 (*),這樣會指定字串在 Identity 中的任何位置。在擷取識別中包含字串 Redmond 的所有語音路由之後,便會將這些語音路由傳送至 Remove-CsVoiceRoute,這樣會移除每一個路由。