Set-CsNetworkRegion

構文

Set-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkRegion [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

解説

ネットワーク地域は、複数の地理的な領域にまたがるネットワークのさまざまな部分を相互接続します。各ネットワーク地域は、1 つの 中央サイト に関連付ける必要が必要があります。この中央サイトは、通話受付管理 (CAC) 帯域幅ポリシー サービスが実行されているデータ センター サイトです。オーディオおよびビデオの接続に対して代替パスを許可するか、メディア バイパス構成を持つ地域の中でサイトを関連付けるかなどの設定を含め、既存のネットワーク地域を変更するには、このコマンドレットを使用します。

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkRegion\b"}

パラメーター

入力の種類

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType オブジェクト。ネットワーク地域オブジェクトのパイプライン入力を受け入れます。

戻り値の種類

このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType 型のオブジェクトを変更します。

例

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

Set-CsNetworkRegion -Identity NorthAmerica -Description "North American Region"

この例では、NorthAmerica というネットワーク地域を変更します。Description パラメーターに、"North American Region" という値を指定します。NorthAmerica 地域に対する Description が存在している場合は、このコマンドを実行すると、この値によって上書きされます。まだ Description の値が設定されていなかった場合は、このコマンドを実行すると、値が設定されます。

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

Set-CsNetworkRegion -Identity EMEA -VideoAlternatePath $False

この例では、EMEA というネットワーク地域を変更し、新しいビデオ代替パス設定を割り当てます。これを実行するために Set-CsNetworkRegion を呼び出し、EMEA という Identity を渡します。次に、VideoAlternatePath パラメーターを指定し、$False という値を渡します。VideoAlternatePath を False に設定すると、適切な帯域幅が使用できない場合に、ビデオ通話が代替パスにルーティングされず、代わりに、ビデオ通話が確立されません。

-------------------------- 例 3 --------------------------

$a = Get-CsNetworkRegion -Identity NorthAmerica
$a.BWAlternatePaths | foreach {Set-CsNetworkRegion -Identity Asia -BWAlternatePaths @{add=$_}}

例 3 では、NorthAmerica 地域に対して設定されたのと同じ代替パス設定のセットを Asia ネットワーク地域に割り当てます。この例の最初の行では、NorthAmerica ネットワーク地域のインスタンスを取得し、変数 $a に割り当てます。2 番目の行では最初に (変数 $a に保存されている) NorthAmerica 地域の BWAlternatePaths プロパティの内容を取得します。つまり、$a.BWAlternatePaths です。これは、NorthAmerica 地域におけるすべての代替パス設定から成るコレクションです。

次に、設定から成るコレクションを foreach 関数にパイプ処理します。foreach では、コレクション内の項目を一度に 1 つずつサイクル処理し、続く中かっこ内のアクションを実行します。この例のアクションは、Asia という Identity に対して Set-CsNetworkRegion を呼び出し、Asia 地域のプロパティを設定することです。次のパラメーターは BWAlternatePaths です。@{add=$_} という値をこのパラメーターに渡します。変数 $_ は、コレクション内にある現在の項目を表します。この例では、現在の代替パスです。値のうち @{add=} という部分は、この項目を、Asia 地域の BWAlternatePath から成るコレクションに追加することを意味します。

関連項目

その他のリソース

New-CsNetworkRegion
Remove-CsNetworkRegion
Get-CsNetworkRegion
New-CsNetworkBWAlternatePath