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