Remove-CsOutboundTranslationRule
上次修改主題的時間: 2012-03-25
移除現有的輸出轉譯規則。輸出轉譯規則會將電話號碼轉換為用於與專用交換機 (PBX) 系統互動的本地撥號格式。
語法
Remove-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
呼叫此指令程式可移除現有的輸出轉譯規則。Microsoft Lync Server 2010 會將電話號碼正規化為 E.164 格式。不過,許多專用交換機 (PBX) 系統無法使用此格式。將號碼傳送到 中繼伺服器 或閘道之前,輸出轉譯規則會將號碼轉譯為區域撥號格式。
每個輸出轉譯規則都會與一個主幹組態相關聯。也就是說,使用此指令程式移除規則時,會將其從對應範圍的主幹組態中移除。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsOutboundTranslationRule Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsOutboundTranslationRule"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
您要移除之輸出轉譯規則的唯一識別碼。Identity 是由範圍加上每個範圍中的唯一名稱組成。例如,site:Redmond/OutboundRule1。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 物件。接受輸出轉譯規則物件的管線傳送資料。
傳回類型
這個指令程式不會傳回值。它會移除 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
此範例會移除名稱為 Prefix Redmond 之 Redmond 網站的現有輸出轉譯規則。Identity 是唯一的,因此此命令會刪除單一規則。
-------------------------- 範例 2 --------------------------
Get-CsOutboundTranslationRule -Filter site:* | Remove-CsOutboundTranslationRule
此範例會移除所有網站層級的輸出轉譯規則。此命令的第一部分會呼叫 Get-CsOutboundTranslationRule 並加上 Filter site:*,以傳回 Identity 值開頭為 site: 的所有規則集合。接著,此集合會傳送到 Remove-CsOutboundTranslationRule,以移除集合中的每個規則。