New-CsNetworkBWPolicy
上次修改主題的時間： 2012-03-25
在記憶體中建立可套用至頻寬原則設定檔的頻寬原則。在 Microsoft Lync Server 2010，原則可套用至音訊或視訊頻寬。
語法
New-CsNetworkBWPolicy -BWLimit <UInt32> -BWPolicyModality <Audio | Video> -BWSessionLimit <UInt32>
詳細描述
此指令程式會建立頻寬原則。頻寬原則是用於定義特定模式的頻寬限制 (在 Lync Server 2010 中，只會指派音訊與視訊形式的頻寬限制)。頻寬原則只會建立在記憶體中，因此必須將輸出指定到變數，然後將變數當做值傳遞給 New-CsNetworkBandwidthPolicyProfile 或 Set-CsNetworkBandwidthPolicyProfile 指令程式的 BWPolicy 參數。頻寬原則會套用到原則設定檔，一個設定檔中可儲存多個原則，為通話許可控制 (CAC) 通用網路組態的一部分。
請注意，指派音訊和視訊原則的建議方法是，呼叫 New-CsNetworkBandwidthPolicyProfile 或 Set-CsNetworkBandwidthPolicyProfile 指令程式，並為 AudioBWLimit、AudioBWSessionLimit、VideoBWLimit 及 VideoBWSessionLimit 參數指定值，直接將他們指派給頻寬原則設定檔。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkBWPolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBWPolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
BWLimit |
必要 |
UInt32 |
總頻寬的上限，單位為 kbps，用於所有同時連線且是 BWPolicyModality 參數指定類型的工作階段。 |
BWPolicyModality |
必要 |
BWPolicyModality |
決定何種類型的頻寬要加以限制。 有效值：Audio、Video |
BWSessionLimit |
必要 |
UInt32 |
BWPolicyModality 參數指定類型的單一工作階段的頻寬的上限，單位為 kbps。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video
此範例會建立新頻寬原則，並指定給變數 $bwp。需要 New-CsNetworkBWPolicy 指令程式的所有參數。在此範例中，我們指定總頻寬限制 (BWLimit) 為 2000 kbps、頻寬工作階段限制 (BWSessionLimit) 為 300 kbps，且我們將這些限制套用到視訊工作階段 (-BWPolicyModality video)。
-------------------------- 範例 2 --------------------------
$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bwp
範例 2 是範例 1 的延伸，將新的頻寬原則指派給原則設定檔。第 1 行的命令與範例 1 的命令相同:這會建立視訊頻寬限制。第 2 行則呼叫 New-CsNetworkBandwidthPolicyProfile 將此原則加入新的設定檔。新的設定檔得到的 Identity 為 LowBWLimit。然後我們使用 BWPolicy 參數，給予 $bwp 值，即是包含我們剛在第 1 行建立的新頻寬原則的變數。