New-CsNetworkRegionLink
トピックの最終更新日: 2012-03-25
通話受付管理 (CAC) 用に構成された 2 つの地域間のリンクを作成します。
構文
New-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkRegionLink -NetworkRegionID1 <String> -NetworkRegionID2 <String> -NetworkRegionLinkID <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
ネットワーク内の地域は、物理的な WAN 接続でリンクされています。このコマンドレットは、2 つの地域間のリンクを定義し、これらの地域間のオーディオ接続とビデオ接続に帯域幅制限を設定します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが New-CsNetworkRegionLink コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkRegionLink"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
新しく作成されたネットワーク地域リンクの一意の識別子。ネットワーク地域リンクは、グローバル スコープのみで作成されるため、この識別子ではスコープを指定する必要はありません。代わりに、そのリンクを特定する一意の名前を示す文字列が含まれています。 |
NetworkRegionID1 |
必須 |
文字列 |
NetworkRegionID2 パラメーターによって識別される地域にリンクされた地域の Identity (NetworkRegionID)。 |
NetworkRegionID2 |
必須 |
文字列 |
NetworkRegionID1 パラメーターによって識別される地域にリンクされた地域の Identity (NetworkRegionID)。 |
NetworkRegionLinkID |
必須 |
文字列 |
この値は Identity と同じです。Identity と NetworkRegionLinkID の両方を指定することはできません。いずれかに入力された値が自動的に、両方で使用されます。 |
BWPolicyProfileID |
省略可能 |
文字列 |
このリンクの帯域幅制限を定義する帯域幅ポリシー プロファイルの Identity。利用可能なプロファイルの一覧は、Get-CsNetworkBandwidthPolicyProfile コマンドレットを呼び出すことにより取得できます。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
InMemory |
省略可能 |
SwitchParameter |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。
戻り値の種類
このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType 型のオブジェクトが作成されます。
例
-------------------------- 例 1 --------------------------
New-CsNetworkRegionLink -Identity NA_EMEA -NetworkRegionID1 NorthAmerica -NetworkRegionID2 EMEA -BWPolicyProfileID LowBWLimits
この例では、地域 NorthAmerica と EMEA をリンクする、NA_EMEA という名前の新しいネットワーク地域リンクを作成します。この地域リンク名は、Identity パラメーターの値として指定します(これは自動的に、NetworkRegionLinkID の値として割り当てられます)。リンクされた 2 つのネットワーク地域は、リンク作成のための必須パラメーターです。この場合は、NorthAmerica と EMEA という地域名がその必須パラメーターに該当します。この例では、BWPolicyProfile パラメーターにも値を割り当てています。その結果、その帯域幅ポリシー プロファイル (LowBWLimits) で定義した帯域幅制限が、2 つの地域間の接続に割り当てられます。BWPolicyProfileID が指定されない場合、これらの 2 地域間の接続に帯域幅制限はありません(それでも、サイト間に制限が課せられている場合があります。詳細については、New-CsNetworkSite のヘルプ トピックを参照してください。)