Get-CsNetworkInterSitePolicy
トピックの最終更新日: 2012-03-23
通話受付管理 (CAC) 構成内で直接接続されているサイト間に帯域幅制限を定義する 1 つ以上のネットワーク サイト間ポリシーを取得します。
構文
Get-CsNetworkInterSitePolicy [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkInterSitePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
ネットワーク サイトが直接リンクを共有している場合、これらの 2 つのサイト間にオーディオ接続およびビデオ接続の帯域幅制限を定義できます。このコマンドレットを使用すると、帯域幅制限の設定と直接接続されたサイトを関連付ける 1 つ以上のネットワーク サイト ポリシーを取得できます。
このコマンドレットを実行できるユーザー: 既定では、Get-CsNetworkInterSitePolicy コマンドレットをローカルで実行する権限があるのは、RTCUniversalUserAdmins および RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterSitePolicy"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
取得するネットワーク サイト ポリシーを表す一意の識別子です。ネットワーク サイト ポリシーはグローバル スコープでのみ作成されます。そのため、この識別子にスコープを指定する必要はありません。代わりに、そのポリシーを識別する一意の名前である文字列が含まれます。 |
Filter |
省略可能 |
文字列 |
ワイルドカード文字を含む文字列です。このワイルドカード文字列と一致する Identity 値を持つポリシーを検索します。 |
LocalStore |
省略可能 |
SwitchParameter |
ネットワーク サイト間ポリシーの情報を、中央管理ストア 本体からではなく、中央管理ストア のローカル レプリカから取得します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType 型のオブジェクトを取得します。
例
-------------------------- 例 1 --------------------------
Get-CsNetworkInterSitePolicy
Get-CsNetworkInterSitePolicy をパラメーターなしで呼び出して、2 つの直接接続されたネットワーク サイト間で定義されているすべてのネットワーク サイト ポリシーを取得しています。
-------------------------- 例 2 --------------------------
Get-CsNetworkInterSitePolicy -Identity Reno_Portland
この例では、Reno_Portland という ID を持つネットワーク サイト ポリシーを取得しています。
-------------------------- 例 3 --------------------------
Get-CsNetworkInterSitePolicy -Filter *Reno*
例 3 では、ID 値の一部に文字列 Reno が含まれるネットワーク サイト ポリシーをすべて取得しています。Filter パラメーターに渡される値に含まれているワイルドカード文字 (*) は、"任意の文字または文字のセット" を示します。つまり、文字列 *Reno* は、任意の 1 つまたは複数の文字で始まり、次に文字列 Reno が続き、さらに任意の 1 つまたは複数の文字が続く ID 値と一致します。
-------------------------- 例 4 --------------------------
Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}
この例では、帯域幅ポリシーのプロファイルが割り当てられていないすべてのネットワーク サイト ポリシーを取得しています。このコマンドでは、まず Get-CsNetworkInterSitePolicy を呼び出し、例 1 と同様に、すべてのネットワーク サイト ポリシーのコレクションを取得します。次に、このコレクションを Where-Object コマンドレットへパイプ処理します。Where-Object は、コレクションを帯域幅ポリシーのプロファイルが割り当てられていないサイト ポリシーのみに絞り込みます。これは、各サイト ポリシーの BWPolicyProfileID プロパティが Null ($null) と等しい (-eq) かどうかを比較することによって行われます。