Set-CsVoiceNormalizationRule
上次修改主題的時間: 2012-03-27
修改語音正規化規則。語音正規化規則可用來將電話撥號要求 (例如,撥打外線要撥 9) 轉換成 Microsoft Lync Server 2010 使用的 E.164 電話號碼格式。
語法
Set-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceNormalizationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
這個指令程式會修改具名的語音正規化規則。這些規則是電話授權和電話轉接的必要部分。它們定義將號碼從內部 Lync Server 2010 格式轉換 (或轉譯) 為標準 (E.164) 格式的需求。了解規則運算式對於定義將要轉譯的號碼模式很有幫助。
使用這個指令程式修改的規則屬於撥號對應表,而且除了使用 Get-CsVoiceNormalizationRule 指令程式存取之外,也可以使用對 Get-CsDialPlan 指令程式的呼叫所傳回的 NormalizationRules 屬性存取。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsVoiceNormalizationRule Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceNormalizationRule"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
XdsIdentity |
規則的唯一識別碼。指定的 Identity 必須包含範圍,後面接正斜線和名稱,例如:site:Redmond/Rule1,其中 site:Redmond 是範圍,Rule1 是名稱。 |
Instance |
選用 |
NormalizationRule |
允許您將物件參照傳遞給 Cmdlet,而不設定個別參數值。 此物件的類型必須是 NormalizationRule,並可由呼叫 Get-CsVoiceNormalizationRule 擷取 |
Description |
選用 |
字串 |
正規化規則的簡易描述。 字串長度上限:512 個字元。 |
IsInternalExtension |
選用 |
布林值 |
若為 True,套用此規則的結果會是企業內部的號碼。若為 False,套用規則會產生外部號碼。如果相關撥號對應表之 OptimizeDeviceDialing 內容的值已設為 False,這個值便會被忽略。 |
Priority |
選用 |
Int32 |
套用規則的順序。一個號碼可能符合多個規則。這個參數會設定針對號碼測試規則的順序。 |
Pattern |
選用 |
字串 |
一個規則運算式,撥打的號碼必須與其相符,才會套用此規則。 |
Translation |
選用 |
字串 |
要套用至號碼的規則運算式模式,以將號碼轉換為 E.164 格式。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule 物件。接受管線傳送的語音正規化規則物件輸入。
傳回類型
Set-CsVoiceNormalizationRule 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"
這個範例將站台 Redmond 上 Prefix Redmond 規則的描述設定為 "Add a prefix to all numbers on site Redmond"。
-------------------------- 範例 2 --------------------------
Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'
這個範例會修改 Identity 為 global/SeattleFourDigit 的語音正規化規則。其會指定新的 Description 以反映規則修改。此外,也已指定 Translation 值,此值會修改規則以將符合此規則現有模式的任何號碼轉譯為相同的號碼,但是加上首碼 +1206556。例如,如果現有的模式符合任何四位數的號碼並輸入數字 1234,此規會將該分機轉譯為號碼 +12065561234。
-------------------------- 範例 3 --------------------------
$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a
範例 3 會變更正規化規則的名稱。請記住,變更名稱也會變更 Identity 的名稱部分。Set-CsVoiceNormalizationRule 指令程式沒有 Name 參數,因此為了變更名稱,我們會先呼叫 Get-CsVoiceNormalizationRule 以擷取 Identity 為 global/RedmondFourDigit 的規則,並將傳回的物件指定給變數 $a。然後將字串 RedmondRule 指定給物件的 Name 屬性。接著將變數傳遞給 Set-CsVoiceNormalizationRule 的 Instance 參數,讓變更永遠生效。