New-CsNetworkBandwidthPolicyProfile
トピックの最終更新日: 2012-03-24
新しいネットワーク帯域幅ポリシーのプロファイルを作成します。このコマンドレットを使用して、プロファイル内で帯域幅ポリシーを設定することもできます。
構文
New-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]
解説
帯域幅ポリシーは、通話受付管理 (CAC) の一部として、特定のモダリティの帯域幅制限を定義する際に使用します (Microsoft Lync Server 2010 では、オーディオとビデオのモダリティのみに帯域幅の制限を割り当てることができます。)このコマンドレットを実行すると、これらのポリシーのコンテナー プロファイルが作成されます。コンテナー内の個別のポリシーを定義するには、このコマンドレットを呼び出すときにオーディオとビデオの帯域幅制限を指定します。
New-CsNetworkSite コマンドレットまたは Set-CsNetworkSite コマンドレットを呼び出すことで、帯域幅ポリシーのプロファイルがネットワーク サイトに適用されます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが New-CsNetworkBandwidthPolicyProfile コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBandwidthPolicyProfile"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
ポリシーを一意に識別する文字列値です。帯域幅ポリシーのプロファイルは、すべてグローバル スコープで作成されます。したがって新しい帯域幅ポリシーのプロファイルを作成する際、スコープは黙示的であり、指定する必要があるのは一意の名前のみです。この値が、プロファイルの BWPolicyProfileID プロパティにも設定されるという点に注意してください。 |
AudioBWLimit |
省略可能 |
文字列 |
すべてのオーディオ接続に割り当てられる最大帯域幅です。1 つのオーディオ セッションでオーディオの帯域幅制限を超過するような場合は、このセッションを開始できません。 kbps で表されます。たとえば、値が 1000 の場合は 1000 kbps を表します。 このパラメーターに値を指定すると、BWPolicy パラメーターには値を指定できません。 既定値は次のとおりです。AudioBWSessionLimit パラメーターに値を指定し、AudioBWLimit には指定しない場合、AudioBWLimit は既定で 0 になります。 |
AudioBWSessionLimit |
省略可能 |
文字列 |
オーディオ セッションごとに割り当てられる最大帯域幅です。kbps で表されます。この値は 40 以上である必要があります。 このパラメーターに値を指定すると、BWPolicy パラメーターには値を指定できません。 既定値は次のとおりです。AudioBWLimit パラメーターに値を指定し、AudioBWSessionLimit には指定しない場合、AudioBWSessionLimit は既定で 175 になります。 |
BWPolicy |
省略可能 |
PSListModifier |
帯域幅ポリシーのプロファイルを含むオブジェクトのリストです。リスト内の各オブジェクトは、帯域幅モダリティ (オーディオまたはビデオ)、帯域幅制限、および帯域幅のセッション制限です。 このパラメーターに値を指定すると、AudioBWLimit、AudioBWSessionLimit、VideoBWLimit、または VideoBWSessionLimit パラメーターに値を指定することができません。 一覧内のオブジェクトは、New-CsNetworkBWPolicy コマンドレットを呼び出して作成できます。 |
Description |
省略可能 |
文字列 |
帯域幅ポリシーのプロファイルの説明です。たとえば、このパラメーターを使用してプロファイルの用途を明示することができます。 |
VideoBWLimit |
省略可能 |
文字列 |
すべてのビデオ接続に割り当てられる最大帯域幅です。1 つのビデオ セッションでビデオの帯域幅制限を超過するような場合は、このセッションを開始できません。 kbps で表されます。たとえば、値が 1000 の場合は 1000 kbps を表します。 このパラメーターに値を指定すると、BWPolicy パラメーターには値を指定できません。 既定値は次のとおりです。VideoBWSessionLimit パラメーターに値を指定し、VideoBWLimit には指定しない場合、VideoBWLimit は既定で 0 になります。 |
VideoBWSessionLimit |
省略可能 |
文字列 |
ビデオ セッションごとに割り当てられる最大帯域幅です。kbps で表されます。この値は 100 以上である必要があります。 このパラメーターに値を指定すると、BWPolicy パラメーターには値を指定できません。 既定値は次のとおりです。VideoBWLimit パラメーターに値を指定し、VideoBWSessionLimit には指定しない場合、VideoBWSessionLimit は既定で 700 になります。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
InMemory |
省略可能 |
SwitchParameter |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 型のオブジェクトを作成します。
例
-------------------------- 例 1 --------------------------
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimits -AudioBWLimit 2000 -AudioBWSessionLimit 200 -VideoBWLimit 1400 -VideoBWSessionLimit 500
例 1 では、LowBWLimits という名前の新しい帯域幅ポリシーのプロファイルを作成します。この新しいプロファイルには、オーディオ ポリシーとビデオ ポリシーという、2 つのポリシー (Lync Server 2010 で唯一使用可能な 2 つのポリシー) が割り当てられます。オーディオ ポリシーをプロファイルに追加します。AudioBWLimit パラメーターを使用して、オーディオ接続全体に対して (この場合は) 2000 kbps の制限値を割り当て、AudioBWSessionLimit パラメーターを使用して個々のオーディオ セッションの制限値として 200 kbps を割り当てます。ビデオ セッションを制限する場合にも同じ操作を実行しますが、この場合に使用するのは VideoBWLimit パラメーターと VideoBWSessionLimit パラメーターです。