New-CsVoiceNormalizationRule

構文

New-CsVoiceNormalizationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

New-CsVoiceNormalizationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

解説

このコマンドレットを実行すると、名前の付いた音声正規化ルールが作成されます。これらのルールは、電話の認証および呼び出しルーティングの必要部分です。これらのルールによって、番号を Lync Server 2010 の内部形式から標準 (E.164) 形式に変換する際の要件を定義します。変換する番号パターンを定義する際には、正規表現を理解していると便利です。

このコマンドレットを使用して作成したルールはダイヤル プランの一部となります。このルールには、Get-CsVoiceNormalizationRule コマンドレットのほか、Get-CsDialPlan コマンドレットを呼び出すことで戻される NormalizationRules プロパティ経由でもアクセスできます。正規化ルールの Identity に指定されているスコープと一致する Identity を持つダイヤル プランが存在しない場合、正規化ルールを作成することはできません。たとえば、site:Redmond のダイヤル プランが存在しない場合、site:Redmond/RedmondNormalizationRule という Identity を持つ正規化ルールを作成することはできません。

このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、New-CsVoiceNormalizationRule コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceNormalizationRule"}

パラメーター

入力の種類

なし。

戻り値の種類

このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule 型のオブジェクトが作成されます。

例

-------------------------- 例 1 --------------------------

New-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond"

この例では、レドモンド サイト向けに、Prefix Redmond という新しい音声正規化ルールを作成しています。他のパラメーターは指定しないため、ルールは既定値で作成されます。Identity パラメーターに渡される値が二重引用符で囲まれていることに注意してください。これはルール名 (Prefix Redmond) にスペースが含まれるためです。ルール名にスペースが含まれていない場合は、Identity を二重引用符で囲む必要はありません。

このコマンドが成功するためには、レドモンド サイトのダイヤル プランが存在している必要があることに注意してください。新しいダイヤル プランを作成するには、New-CsDialPlan コマンドレットを呼び出します。

-------------------------- 例 2 --------------------------

New-CsVoiceNormalizationRule -Parent SeattleUser -Name SeattleFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1206555$1'

この例では、SeattleFourDigit という新しい音声正規化ルールを作成して、SeattleUser という Identity を持つユーザーごとのダイヤル プランに適用しています(注: Parent と Name を指定する代わりに、-Identity を SeattleUser/SeattleFourDigit と指定することで同じルールを作成することができました)。このルールが 4 桁の内線番号のみの内部ダイヤル用番号を変換するものであるという説明を追加しました。また、パターンと変換の値も指定済みです。これらの値によって、(パターンの正規表現で指定した) 4 桁の番号が、変換値 (+1206555) が頭に付く同じ 4 桁の番号に変換されます。たとえば 1234 という内線番号を入力すると、+12065551234 という番号に変換されます。

Pattern と Translation の値は単一引用符で囲まれていることに注意してください。この値には単一引用符が必要です。このインスタンスでは二重引用符または引用符なしの場合動作しません。

例 1 のように、指定のスコープを持つダイヤル プランが存在している必要があります。この場合、SeattleUser という Identity を持つダイヤル プランが既に存在していることを意味します。

関連項目

その他のリソース

Remove-CsVoiceNormalizationRule
Set-CsVoiceNormalizationRule
Get-CsVoiceNormalizationRule
Test-CsVoiceNormalizationRule
New-CsDialPlan
Get-CsDialPlan