次の方法で共有

  • [アーティクル]

New-CsStaticRoutingConfiguration

 

トピックの最終更新日: 2012-03-26

静的ルーティング構成設定の新しいコレクションを作成します。

構文

New-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

解説

他のユーザーに SIP メッセージを送信する場合、配信される前に、そのメッセージが複数のサブネットやネットワークを通過することが必要になる場合があります。多くの場合、メッセージが通過するパスをルートと呼びます。ネットワークでは、動的ルートと静的ルートの 2 種類のルートがあります。動的ルートでは、サーバーは、アルゴリズムを使用してメッセージを転送する次の場所 (次ホップ) を判断します。静的ルートでは、メッセージ パスはシステム管理者があらかじめ設定します。メッセージがサーバーによって受信されると、サーバーは、メッセージのアドレスを確認し、そのメッセージを管理者があらかじめ設定した次ホップ サーバーに転送します。正しく構成されている場合、静的ルートによって、メッセージを適切なタイミングで正確に配信でき、サーバーにかかるオーバーヘッドが最小限になります。静的ルートの欠点は、ネットワーク障害が発生した場合に、メッセージが動的に再ルーティングされないという点です。

Microsoft Lync Server 2010 をインストールすると、静的ルートのグローバル コレクションが自動的に作成されます。それ以外にも、New-CsStaticRoutingConfiguration コマンドレットを使用して、追加のコレクションおよびサイト スコープまたはサービス スコープを作成できます (レジストラー サービスの場合のみ)。

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

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

パラメーター

パラメーター 必須かどうか 型 説明

Identity

必須

Xds Identity

作成する新しい静的ルーティング コレクションの一意の識別子。新しいコレクションはサービス スコープでのみ作成することができ、レジストラー サービスにのみ割り当てることができます。そのため、新しいコレクションの Identity は次のようになります。-Identity "service:Registrar:atl-cs-001.litwareinc.com" です。

Route

省略可能

PSList Modifier

コレクション内で保持される個々の静的ルート。コレクションに追加するルートは、別のコレクションからコピーするか、New-CsStaticRoute コマンドレットを使用して作成する必要があります。詳細については、このトピックの「例」セクションを参照してください。

Force

省略可能

スイッチ パラメーター

コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。

InMemory

省略可能

SwitchParameter

永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。

WhatIf

省略可能

スイッチ パラメーター

実際にコマンドを実行せずに、コマンドの実行結果がわかります。

Confirm

省略可能

スイッチ パラメーター

コマンドの実行前に確認メッセージを表示します。

入力の種類

なし。New-CsStaticRoutingConfiguration は、パイプライン処理された入力を受け入れません。

戻り値の種類

New-CsStaticRoutingConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings オブジェクトの新しいインスタンスが作成されます。

例

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

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

上記のコマンドは、service:Registrar:atl-cs-001.litwareinc.com という ID を持つ新しい静的ルーティング構成コレクションを作成します。このコマンドでは Route パラメーターが指定されていないため、新しいコレクションには静的ルートは割り当てられません。

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

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "*.litwareinc.com"

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -Route $x

例 2 に示すコマンドは、トランスポート プロトコルとして TCP を使用する新しい SIP プロキシ ルートを作成します。作成された新しいルートは、新しい静的ルーティング構成コレクションに追加されます。これを実行するために、例の最初のコマンドで New-CsStaticRoute を使用して、IP アドレスが 192.168.1.100 の次ホップ サーバーを指す新しいルートを作成します。この新しいルート ($x という変数に格納されている) も、ポート 8025 と MatchUri "*.litwareinc.com" を使用します。

その後で、New-CsStaticRoutingConfiguration を呼び出して (ID が service:Registrar:atl-cs-001.litwareinc.com の) 新しいコレクションを作成し、変数 $x に格納されているルートを新しいコレクションの Route プロパティに割り当てます。