New-CsNetworkInterRegionRoute
トピックの最終更新日: 2012-03-27
通話受付管理 (CAC) 構成内のネットワーク地域に接続する新しいルートを作成します。
構文
New-CsNetworkInterRegionRoute -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkInterRegionRoute -InterNetworkRegionRouteID <String> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
解説
CAC 構成内の各地域から他の各地域にアクセスするいくつかの方法が必要です。地域のリンクが地域間の接続に対する帯域幅制限を設定し、物理リンクも表す一方、ルートはある地域から別の地域へ接続が通過するリンクされたパスを決定します。このコマンドレットはこのようなルートの関連付けを作成します。
このコマンドレットを実行できるユーザー: 既定では、New-CsNetworkInterRegionRoute コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkInterRegionRoute"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
新しく作成されるネットワーク地域ルートの一意の識別子です。ネットワーク地域ルートはグローバル スコープのみで作成されるため、この識別子ではスコープを指定する必要はありません。代わりに、そのルートを識別する一意の名前の文字列が含まれます。 |
InterNetworkRegionRouteID |
必須 |
文字列 |
この値は Identity と同じです。Identity と InterNetworkRegionRouteID を両方指定することはできません。片方に入力された値は自動的に両方で使用されます。 |
NetworkRegionID1 |
必須 |
文字列 |
このルートを介して接続された 2 つの地域のいずれかの Identity (NetworkRegionID) です。このパラメーターに渡された値は NetworkRegionID2 パラメーターの値とは異なる地域である必要があります (つまり、地域をそれ自体にルーティングすることはできません)。さらに、NetworkRegionID1 と NetworkRegionID2 の組み合わせは一意である必要があります (たとえば、NorthAmerica と EMEAに接続するように定義されたルートを 2 つ持つことはできません)。 |
NetworkRegionID2 |
必須 |
文字列 |
このルートを介して接続された 2 つの地域のいずれかの Identity (NetworkRegionID) です。このパラメーターに渡された値は NetworkRegionID1 パラメーターの値とは異なる地域である必要があります (つまり、地域をそれ自体にルーティングすることはできません)。さらに、NetworkRegionID1 と NetworkRegionID2 の組み合わせは一意である必要があります (たとえば、NorthAmerica と EMEAに接続するように定義されたルートを 2 つ持つことはできません)。 |
NetworkRegionLinkIDs |
省略可能 |
文字列 |
このルートに対するすべてのリンクをコンマ区切り値の文字列で指定することができます。値は地域リンクの Identity (NetworkRegionLinkIDs) です。NetworkRegionLinkIDs と NetworkRegionLinks の両方の値を入力すると、NetworkRegionLinkIDs は無視されます。このパラメーターにより、リスト オブジェクトを作成し、それを NetworkRegionLinks パラメーターに渡すことをしなくても、リンクのリストを指定する便利な方法が提供されます。 |
NetworkRegionLinks |
省略可能 |
PSListModifier |
このルートに適用する地域リンクの Identity (NetworkRegionLinkIDs) を含むオブジェクトのリストです。このコマンドレットでは、このパラメーターと NetworkRegionLinkIDs パラメーターとの違いは、複数のリンクを入力する場合の形式のみです。NetworkRegionLinkIDs パラメーターは、このコマンドレットで最初のリストを定義するために推奨される方法です。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
InMemory |
省略可能 |
SwitchParameter |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 型のオブジェクトを作成します。
例
-------------------------- 例 1 --------------------------
New-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionID1 NorthAmerica -NetworkRegionID2 APAC -NetworkRegionLinkIDs "NA_EMEA,EMEA_APAC"
例 1 は NorthAmerica 地域と APAC 地域間の新しいネットワーク地域ルートを作成します。新しいルートの Identity に NA_APAC_Route を指定します (これは InterNetworkRegionRouteID として自動的に割り当てられます)。接続されている地域が NorthAmerica で、これが NetworkRegionID1 パラメーターに値として渡され、APAC が NetworkRegionID2 パラメーターに値として渡されます。この例では、NorthAmerica から直接 APAC へリンクするように構成された地域リンクはないことを前提としています。しかし、NorthAmerica から EMEA へ (NA_EMEA)、および EMEA から APAC へ (EMEA_APAC) のリンクはあります。これらの両方のリンクを、コンマで区切って、NetworkRegionLinkIDs パラメーターの値として使用します。これにより、NorthAmerica から EMEA を経由して APAC へ向かう接続がルーティングされ、これらのリンクに関連付けられた音声およびビデオ接続に対する帯域幅の制限が適用されます。