New-CsOutboundTranslationRule
トピックの最終更新日: 2012-03-26
新しい発信変換ルールを作成します。発信変換ルールは、電話番号を地域のダイヤル形式に変換して、構内交換機 (PBX) システムとやり取りできるようにします。
構文
New-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
New-CsOutboundTranslationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
解説
新しい発信変換ルールを作成する場合は、このコマンドレットを呼び出します。Microsoft Lync Server 2010 は電話番号を E.164 形式に正規化します。ただし、多くの構内交換機 (PBX) システムはこの形式を処理することができません。発信変換ルールによって、番号が地域のダイヤル形式に変換されてから、仲介サーバー またはゲートウェイへ送信されます。
各発信変換ルールはトランク構成に関連付けられています。各構成に複数の発信変換ルールを関連付けることができます。したがって、各ルールの Identity は、スコープ内で一意の名前 (スコープ/名前の形式。"site:Redmond/OBR1" など) で構成されます。ルールは、同じスコープのトランク構成に自動的に関連付けられます。New-CsOutboundTranslationRule を呼び出して、トランク構成がまだ定義されていないスコープを指定すると、指定されたスコープ、発信変換ルール、および既定値でトランク構成が作成されます。
このコマンドレットを実行できるユーザー: 既定では、New-CsOutboundTranslationRule コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsOutboundTranslationRule"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsIdentity |
発信変換ルールの一意の識別子。Identity にはルールが適用されるスコープと、ルールの名前が含まれます。また、グローバル スコープ、サイト スコープまたはサービス スコープ (PSTNGateway の場合のみ) である必要があります。たとえば、site:Redmond/OutboundRule1 や PstnGateway:Redmond.litwareinc.com/OutboundRule2 です。 Identity パラメーターを指定した場合、Name パラメーターまたは Parent パラメーターの値は指定できません。 |
Parent |
必須 |
文字列 |
発信変換ルールのスコープ。このパラメーターに値を指定する場合、Name パラメーターの値も指定する必要があります。ただし、Identity パラメーターは指定できません。Parent パラメーターおよび Name パラメーターを指定しない場合は、Identity を指定する必要があります。 |
Name |
必須 |
文字列 |
発信変換ルールの名前。Name を指定しない場合、スコープと名前からなる Identity を指定する必要があります。Name を指定した場合は、Parent パラメーターも指定する必要がありますが、Identity は指定できません。 |
Description |
省略可能 |
文字列 |
発信変換ルールの説明。この説明は、ルールの目的を特定する場合に役立ちます。 |
Pattern |
省略可能 |
文字列 |
変換を適用する番号パターンを表す正規表現。 既定値は次のとおりです。^\+(\d*)$ |
Priority |
省略可能 |
Int32 |
番号が複数の発信変換ルールのパターンに一致する場合、ルールは優先順に適用されます。このパラメーターを使用して、ルールに優先順位を割り当てます。 |
Translation |
省略可能 |
文字列 |
パターンに一致する番号に適用する正規表現 (これにより、番号を発信ルーティング用に準備)。 既定値は次のとおりです。$1 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
InMemory |
省略可能 |
SwitchParameter |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。
戻り値の種類
このコマンドレットは、Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 型のオブジェクトを作成します。
例
-------------------------- 例 1 --------------------------
New-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
この例では、"Prefix Redmond" というサイト Redmond の新しい発信変換ルールを作成します。他のパラメーターは指定しないため、ルールは既定値で作成されます。Identity パラメーターに渡される値が二重引用符で囲まれていることに注意してください。これはルール名 (Prefix Redmond) にスペースが含まれるためです。ルール名にスペースが含まれていない場合は、Identity を二重引用符で囲む必要はありません。
-------------------------- 例 2 --------------------------
New-CsOutboundTranslationRule -Parent global -Name SeattleSevenDigit -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'
この例では、SeattleSevenDigit という新しいグローバル発信変換ルールを作成します(注: Parent と Name を指定する代わりに、-Identity を "global/SeattleSevenDigit" を指定することで同じルールを作成することができます)。このルールが E.164 形式の番号を 7 桁の形式に変換するものであるという説明を追加しています。また、パターンと変換値も指定済みです。これらの値により、パターンの正規表現によって指定された E.164 番号 (この場合は、+1425 で始まる 12 桁の番号) は、最初の 5 桁を削除されて 7 桁の番号に変換されます。たとえば、番号 +14255551212 は、番号 5551212 に変換されます。