Get-CsNetworkInterRegionRoute
トピックの最終更新日: 2012-03-23
通話受付管理 (CAC) 構成内のネットワーク地域間を接続するルートを 1 つ以上取得します。
構文
Get-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkInterRegionRoute [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
CAC 構成内の各地域から他の各地域にアクセスするいくつかの方法が必要です。地域のリンクが地域間の接続に対する帯域幅制限を設定し、物理リンクも表す一方、ルートはある地域から別の地域へ接続が通過するリンクされたパスを決定します。このコマンドレットは、それらのルートの関連付けに関する情報を取得します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsNetworkInterRegionRoute コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterRegionRoute"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
取得するネットワーク地域ルートの一意の識別子。ネットワーク地域ルートはグローバル スコープのみで作成されるため、この識別子ではスコープを指定する必要はありません。代わりに、特定のルートを識別する一意の名前の文字列が含まれます。 |
Filter |
省略可能 |
文字列 |
ルートを取得するときに使用する文字列。この文字列は、Identity の値と、このパラメーターに値として渡されるワイルドカード文字列との照合結果に基づいています。 |
LocalStore |
省略可能 |
SwitchParameter |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカからネットワーク地域間ルート情報を取得します。 |
入力の種類
なし。
戻り値の種類
このコマンドレットは、Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 型のオブジェクトを 1 つ以上戻します。
例
-------------------------- 例 1 --------------------------
Get-CsNetworkInterRegionRoute -Identity NA_APAC_Route
例 1 では、Identity が NA_APAC_Route になっているルートを取得します。
-------------------------- 例 2 --------------------------
Get-CsNetworkInterRegionRoute -Filter *APAC*
例 2 では、Filter パラメーターを使用して、Identity の一部に文字列 APAC を含むすべてのルートを取得します。
-------------------------- 例 3 --------------------------
Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionLinks -eq "NA_EMEA"}
この例では、ネットワーク地域リンク NA_EMEA を使用するすべての地域のルートを取得します。このコマンドはまず、Get-CsNetworkInterRegionRoute コマンドレットを呼び出します。パラメーターを指定せずにこのコマンドレットを呼び出すと、CAC 構成によって定義されているすべてのルートを取得できます。次に、このルートのコレクションは Where-Object コマンドレットにパイプ処理されます。Where-Object によりそのコレクションが取得され、コレクション内で NetworkRegionLinks 一覧内に NA_EMEA という値が含まれるすべての項目が取得されます。
-------------------------- 例 4 --------------------------
Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"}
例 4 では、NorthAmerica 地域を含むすべての地域ルートを取得します。コマンドの最初の部分で、Get-CsNetworkInterRegionRoute コマンドレットを呼び出します。このコマンドレットはパラメーターを指定せずに呼び出され、すべての地域ルートを取得します。次に、このルートのコレクションは Where-Object コマンドレットにパイプ処理されます。Where-Object コマンドレットは、ルート内の地域の 1 つとして NorthAmerica が定義されているルートのみにコレクションを絞り込みます。このコマンドレットでは、ルートの NetworkRegionlD1 値が NorthAmerica に等しい (-eq) かどうか、または (-or)、NetworkRegionlD2 値が NorthAmerica に等しいかどうかを確認することで、これを実行します。