Set-CsOutboundTranslationRule
上次修改主題的時間: 2012-03-26
修改現有的輸出轉譯規則。輸出轉譯規則會將電話號碼轉換為當地撥號格式,以便與專用交換機 (PBX) 系統互動。
語法
Set-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Set-CsOutboundTranslationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 會將電話號碼正規化成 E.164 格式。但是,有許多專用交換機 (PBX) 系統無法使用這個格式。將號碼傳送到 中繼伺服器 或閘道之前,輸出轉譯規則會將號碼轉譯為區域撥號格式。呼叫此指令程式來修改現有的輸出轉譯規則。
每個輸出轉譯規則會與主幹組態相關聯。這表示使用此指令程式來修改規則,將影響對應的主幹組態。每個組態都可以與多個輸出轉譯規則相關聯。因此,每個規則識別是由一個範圍以及在此範圍內之唯一名稱 (格式為 scope/name,例如 site:Redmond/OBR1) 所組成。規則會自動與同一個範圍的主幹組態產生關聯。建議您呼叫 Set-CsOutboundTranslationRule 來變更主幹組態的輸出轉譯規則。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsOutboundTranslationRule Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsOutboundTranslationRule"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
字串 |
您要修改之輸出轉譯規則的唯一識別碼。Identity 是由範圍後面加上在每個範圍內的唯一名稱所組成。例如,Redmond/OutboundRule1。 |
Instance |
選用 |
TranslationRule |
輸出轉譯規則的物件參照。此物件的類型必須是 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule,呼叫 Get-CsOutboundTranslationRule 即可擷取此物件。 |
Description |
選用 |
字串 |
易瞭解輸出轉譯規則的描述。此描述可用來協助系統管理員清楚識別規則的目的。 |
Pattern |
選用 |
字串 |
規則運算式,表示 Translation 將套用的號碼模式。 |
Priority |
選用 |
Int32 |
如果號碼符合多個輸出轉譯規則的 Pattern,將根據優先順序套用規則。使用此參數指定規則的優先順序。 |
Translation |
選用 |
字串 |
規則運算式,將套用至符合 Pattern 的號碼,使號碼準備好以便輸出路由。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 物件。接受輸出轉譯規則物件的管線傳送資料。
傳回類型
這個指令程式不會傳回值。它會修改 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond" -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'
此範例會修改 Identity 為 site:Redmond/Prefix Redmond 的通用輸出轉譯規則。我們包含了一個 Description,說明此規則適合用來將數字從 E.164 格式轉譯為七位數字的電話號碼。此外,還會指定 Pattern 和 Translation 值,這將會修改這些屬性的現有值。這些值會將利用規則運算式以 Pattern 指定的 E.164 號碼 (在此範例中是以 +1425 開頭的 12 位數字) 移去前面 5 個數字,轉譯為 7 位數字。例如,號碼 +14255551212 將轉譯為號碼 5551212。
-------------------------- 範例 2 --------------------------
$a = Get-CsOutboundTranslationRule -Identity "site:Redmond/OBR1"
$a.Name = "Outbound Rule 1"
Set-CsOutboundTranslationRule -Instance $a
此範例會修改輸出轉譯規則的 Name 屬性。請注意,這樣會變更此規則的 Identity。此範例的第一個命令是呼叫 Get-CsOutboundTranslationRule 指令程式。我們將 Identity 指定為 site:Redmond\OBR1,它將傳回一個轉譯規則,已指定 Identity 的規則。我們不會顯示此規則,而是將它指派給變數 $a。此範例的第二行會將字串 "Outbound Rule 1" 指派給變數 $a 的 Name 屬性,此變數包含對於規則 site:Redmond/OBR1 的參照。在此範例的最後一行,我們呼叫 Set-CsOutboundTranslationRule、指定 Instance 參數,然後將之傳送給變數 $a。如果我們現在呼叫 Get-CsOutboundTranslationRule 並將 Identity 值指定為 site:Redmond/OBR1,則不會傳回任何項目。這是因為具有該 Identity 的規則已不存在,它已由 Identity 為 site:Redmond/Outbound Rule 1 的相同規則所取代。