Get-CsNetworkBandwidthPolicyProfile
トピックの最終更新日: 2012-03-23
1 つまたは複数のネットワーク帯域幅ポリシーのプロファイルを取得します。
構文
Get-CsNetworkBandwidthPolicyProfile [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkBandwidthPolicyProfile [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
帯域幅ポリシーは、通話受付管理 (CAC) の一部として、特定のモダリティの帯域幅制限を定義する際に使用します (Microsoft Lync Server 2010 では、オーディオとビデオのモダリティのみを帯域幅の制限に割り当てることができます)。このコマンドレットは、これらのポリシーの 1 つまたは複数のコンテナー プロファイルを取得します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsNetworkBandwidthPolicyProfile コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkBandwidthPolicyProfile"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
取得する帯域幅ポリシー プロファイルを一意に識別する文字列値。Identity を指定すると、取得されるプロファイルは多くても 1 つになります。 |
Filter |
省略可能 |
文字列 |
Identity 値がワイルドカード パターンと一致する帯域幅ポリシーのプロファイルを取得するために使用する、ワイルドカードを含む文字列。 |
LocalStore |
省略可能 |
SwitchParameter |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカからネットワーク帯域幅ポリシーのプロファイルを取得します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 型のオブジェクトを戻します。
例
-------------------------- 例 1 --------------------------
Get-CsNetworkBandwidthPolicyProfile
パラメーターを指定せずに Get-CsNetworkBandwidthPolicyProfile を呼び出して、Lync Server 2010 展開内で定義されているすべての帯域幅ポリシーのプロファイルを取得します。
-------------------------- 例 2 --------------------------
Get-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
この例では、Identity が LowBWProfile の帯域幅ポリシーのプロファイルを取得します。ID は一意である必要があるため、これによって戻されるプロファイルは多くても 1 つです。
-------------------------- 例 3 --------------------------
Get-CsNetworkBandwidthPolicyProfile -Filter *50MB*
この例では、Filter パラメーターを使用して、ワイルドカード文字列に基づいて 1 つまたは複数のプロファイルを取得するように指定しています。文字列値として *50MB* を使用することは、Identity 値の一部に 50MB という文字列を含む帯域幅ポリシーのプロファイルすべてを取得しようとしていることを示しています。たとえば、このコマンドを実行すると、"50MB リンクの BW プロファイル"、"50MB オーディオ制限"、および "50MB のビデオ制限" などの ID を持つプロファイルを取得できます。