New-CsSipResponseCodeTranslationRule
トピックの最終更新日: 2012-03-26
新しい SIP 応答コード変換ルールを作成します。これらのルールを使用して、管理者は 400 ～ 699 の範囲の値を持つ SIP 応答コードを Microsoft Lync Server 2010 によって使用される値にマップできます。
構文
New-CsSipResponseCodeTranslationRule -Identity <XdsIdentity> -TranslatedResponseCode <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]
New-CsSipResponseCodeTranslationRule -Name <String> -Parent <String> -TranslatedResponseCode <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]
解説
SIP トランキングは、ボイス オーバー インターネット プロトコル (VoIP) ネットワーク (エンタープライズ VoIP など) と公衆交換電話網 (PSTN) を接続する方法を提供します。Lync Server 2010 では、仲介サーバー はトランキング ピアを使用して PSTN ネットワークと対話します。発信通話が PSTN ネットワークで失敗すると、ISDN User Part (ISUP) の原因コードが自動的に生成されます。たとえば、PSTN ゲートウェイは、原因コード 34 を送信し、通話を完了するための使用可能な回線またはチャネルが存在しないと示すことがあります。仲介サーバー のトランキング ピアがその ISUP 原因コードを受け取ると、そのコードは SIP 応答コードに変換されて、仲介サーバー 自体に送信されます。その結果、Lync Server は、これらの応答コードを使用して、発信ルーティングを判断します。たとえば、故障したゲートウェイに対しては自動的に "less-preferred" (優先度が低い) ステータスが割り当てられます。この結果、故障したゲートウェイの使用頻度は最小限に抑えられ、通話が正常に完了する可能性が最大化されます。
ただし、Lync Server が使用している、ISUP 原因コードから SIP 応答コードへのマッピングに関して推奨される変換を、すべてのゲートウェイが使用しているわけではありません。これらのゲートウェイに対して、管理者は CsSipResponseCodeTranslationRule コマンドレットを使用し、ゲートウェイの SIP 応答コード (原因コードが使用可能な場合は ISUP 原因コードと組み合わせて) を、Lync Server が使用している SIP 応答コードにマップすることができます。たとえば、あるゲートウェイは ISUP 原因コード 34 ("No circuit/channel is available"、"使用可能な回線またはチャネルが存在しない") を、SIP 応答コード 486 ("Busy here"、"話中") にマップすることがあります。応答コード 486 に基づいて、通話を完了するために Lync Server の発信ルーティング ロジックが新しいゲートウェイを検索するよう試みることはありません。
ただし、Lync Server では、代わりに SIP 応答コード 486 を SIP 応答コード 503 にマップする必要があります。応答コード 503 は、Lync Server の発信ルーティング ロジックの再試行メカニズムを起動し、通話を完了するためにシステムによって別のゲートウェイが検索されます。この状況に対処するために、ISUP 原因コード 34 と SIP 応答コード 486 の組み合わせを、SIP 応答コード 503 にマップする変換ルールを作成できます。これらの新しい変換ルールは、New-CsSipResponseCodeTranslationRule コマンドレットを使用して作成できます。変換ルールは、グローバル スコープ、サイト スコープ、またはサービス スコープ (PSTN ゲートウェイ サービス の場合のみ) に割り当てることができます。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、New-CsSipResponseCodeTranslationRule コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipResponseCodeTranslationRule"}
パラメーター
| パラメーター | 必須 | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
Xds Identity |
作成される変換ルールに関する一意の識別子。変換ルールの Identity は、次の 2 つの部分で構成されています。ルールの割り当て先であるスコープと、ルールに付与する名前です。たとえば、グローバル スコープで作成された Rule404 という変換ルールは、次のような Identity を持ちます。global/Rule404。 ID パラメーターを使用する代わりに、新しいルールを作成するときに Parent と Name の各パラメーターを使用することもできます。 |
TranslatedResponseCode |
必須 |
整数 |
ReceivedResponseCode や ReceivedISUPCauseCode の変換先である、Lync Server 2010 SIP 応答コードの値。変換後の応答コードには、400 ～ 699 の範囲の整数値を指定できます。 |
Name |
省略可能 |
文字列 |
ある変換ルールを他の変換ルールと区別するために使用する名前です。Name は、特定のスコープ内で一意であることが必要です。たとえば、Redmond サイトでは、Rule404 という変換ルールをただ 1 つだけ使用できます。ただし、Rule404 という変換ルールを Redmond サイトで使用し、もう 1 つの Rule404 という変換ルールを Dublin サイトで使用することは可能です。 Name パラメーターは必ず、Parent パラメーターと共に使用する必要があります。 |
Parent |
省略可能 |
文字列 |
新しい変換ルールの割り当て先となるスコープ。グローバル スコープにルールを割り当てるには、次の構文を使用します。-Parent global。サイト スコープにルールを割り当てるには、次のような構文を使用します。-Parent site:Redmond。サービス スコープにルールを割り当てるには、次のような構文を使用します。-Parent PstnGateway:192.168.0.242。 Parent パラメーターは必ず、Name パラメーターと共に使用する必要があります。 |
Priority |
省略可能 |
整数 |
変換ルールの相対的な優先度。ルールは割り当てられている優先度に従って処理されます。処理が最初のルールの優先度は 0 で、処理が 2 番目のルールの優先度は 1 で、以降も同様になります。このパラメーターを指定しない場合、新しいルールにはスコープの中で最も低い優先順位が付与されます。 |
ReceivedISUPCauseValue |
省略可能 |
整数 |
INVITE メッセージへの応答時にゲートウェイによって使用される SIP 応答メッセージに示す必要がある、ISDN User Part (ISUP) コードの値。値 -1 は、変換ルールの実行時に SIP 応答コードだけが使用され、ISUP 原因コードは無視されることを示します。 |
ReceivedResponseCode |
省略可能 |
整数 |
INVITE メッセージへの応答時にゲートウェイによって使用される SIP 応答コードの値。応答コードには、400 ～ 699 の範囲の整数値を指定できます。コマンドレットは 400 未満の整数値を受け入れますが、これらの値は最終応答としては認識されません。そのため、変換ルールは使用されません。値 0 は、変換ルールの実行時に ISUP 原因コードが使用されて、SIP 応答コードは無視されることを示します。 |
InMemory |
省略可能 |
スイッチ パラメーター |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。New-CsSipResponseCodeTranslationRule はパイプライン入力を受け入れません。
戻り値の種類
New-CsSipResponseCodeTranslationRule は、Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated オブジェクトの新しいインスタンスを作成します。
例
-------------------------- 例 1 ------------------------
New-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404
例 1 のコマンドを実行すると、PstnGateway:192.168.0.240/Rule404 という Identity を持つ、SIP 応答コード変換ルールが新しく作成されます。このルールは、434 という受信した応答コードを、標準的な SIP 応答コード 404 (Not Found、見つからない) に変換します。
-------------------------- 例 2 ------------------------
New-CsSipResponseCodeTranslationRule -Parent "PstnGateway:192.168.0.240" -Name "Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404
例 2 に示すコマンドは、例 1 で示したコマンドと同じタスクを実行します。ただし、例 2 では Identity パラメーターの代わりに Parent パラメーターと Name パラメーターを使用します。この例は単純に、PstnGateway:192.168.0.240/Rule404 という Identity を持つ SIP 応答コード変換ルールを新しく作成する別の方法を示しています。