Remove-CsNetworkRegion
トピックの最終更新日: 2012-03-25
既存のネットワーク地域を削除します。ネットワーク地域は、エンタープライズ ネットワークのネットワーク ハブまたはバックボーンです。
構文
Remove-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
ネットワーク地域により、複数の地理的領域にわたって、ネットワークのさまざまな部分を相互接続します。すべてのネットワーク地域は、中央サイトと関連付ける必要があります。中央サイトは、帯域幅ポリシー サービスが実行されているデータセンター サイトです。ネットワーク地域を削除する場合は、このコマンドレットを使用します。
ネットワーク地域がネットワークサイトに関連付けられている場合 (つまり、任意のサイトの NetworkRegionID が地域の Identity と同じ場合)、そのネットワーク地域を削除することはできません。サイトに関連付けられている地域を削除しようとすると、エラー メッセージが表示されます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Remove-CsNetworkRegion コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkRegion"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
削除するネットワーク地域の一意の識別子。Identity は、その地域を一意に識別する文字列形式となります。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType オブジェクト。パイプライン処理されたネットワーク地域オブジェクトの入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType 型のオブジェクトを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsNetworkRegion -Identity NorthAmerica
例 1 では、Identity が NorthAmerica のネットワーク地域を削除します。identity は一意なので、このコマンドは 1 つのネットワーク地域のみを削除します。
-------------------------- 例 2 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"} | Remove-CsNetworkRegion
この例では、中央サイト Redmond と関連付けられたすべてのネットワーク地域を削除します。まず、Get-CsNetworkRegion コマンドレットをパラメーターを指定せずに呼び出して、Microsoft Lync Server 2010 展開用に定義されたすべてのネットワーク地域のコレクションを取得します。次にこのコレクションを、Where-Object コマンドレットにパイプ処理します。Where-Object は、このコレクションをフィルター処理して、CentralSite 値が site:Redmond と等しい (-eq) 項目 (ネットワーク地域) のみを戻します。コレクションの内容をそれらの項目に絞り込んだら、この新しいコレクションを Remove-CsNetworkRegion にパイプ処理して、そのコレクション内の各項目を削除します。
-------------------------- 例 3 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"} | Set-CsNetworkSite -NetworkRegionID $null -BypassID $null
Remove-CsNetworkRegion -Identity "NorthAmerica"
この例では、Identity が NorthAmerica のネットワーク地域を削除します。ただし、地域がサイトに関連付けられている場合は、地域を削除することはできません。そのため、この例ではまず、NorthAmerica 地域とサイト間の関連付けをすべて削除します。
まず、Get-CsNetworkSite コマンドレットをパラメーターを指定せずに呼び出して、Lync Server 展開用に定義されたすべてのネットワーク サイトのコレクションを取得します。次にこのコレクションを、Where-Object コマンドレットにパイプ処理します。Where-Object は、このコレクションをフィルター処理して、NetworkRegionID 値が NorthAmerica に等しい (-eq) 項目 (ネットワーク サイト) のみを戻します。コレクションの内容をこれらの項目に絞り込んだら、この新しいコレクションを Set-CsNetworkSite にパイプ処理します。NorthAmerica の NetworkRegionID を持つサイトごとに、NetworkRegionID を Null ($null) に設定します。これにより、サイトの地域への参照が削除されます。ただし、バイパス ID がサイトに関連付けられていない場合、サイトはバイパス ID を持つことはできません。そのため、NetworkRegionID を Null に設定して地域への参照を削除することに加えて、BypassID を Null に設定することで、バイパスの関連付けも削除する必要があります。
行 1 の完了後、NorthAmerica 地域に関連付けられていたサイトは、地域またはバイパス設定に結び付けられなくなります。この時点で行 2 を呼び出して、ネットワーク地域を削除します。