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 指令程式來套用至網路站台。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkBandwidthPolicyProfile Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBandwidthPolicyProfile"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
XdsGlobalRelativeIdentity |
原則的唯一識別字串值。所有的頻寬原則設定檔都是在全域範圍建立。因此,建立新的頻寬原則設定檔時,基於範圍已經暗定的緣故,您只需要指定唯一的名稱。請注意,這個值也會填入到設定檔的 BWPolicyProfileID 屬性。 |
AudioBWLimit |
選用 |
字串 |
配置給所有音訊連線的最大頻寬量。如果單一音訊工作階段會導致超出音訊頻寬限制,則不會允許啟動該工作階段。 以 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 |
選用 |
字串 |
配置給所有視訊連線的最大頻寬量。如果單一視訊工作階段會導致超出視訊頻寬限制,則不會允許啟動該工作階段。 以 kbps 為單位傳送。例如,數值 1000 表示 1000 kbps。 如果您提供值給此參數,則無法提供值給 BWPolicy 參數。 預設值:如果您將值提供給 VideoBWSessionLimit 參數但未提供給 VideoBWLimit,VideoBWLimit 會使用預設值 0。 |
VideoBWSessionLimit |
選用 |
字串 |
每個視訊工作階段所配置的最大頻寬量。以 kbps 為單位傳送。值必須為 100 或更大。 如果您提供值給此參數,則無法提供值給 BWPolicy 參數。 預設值:如果您將值提供給 VideoBWLimit 參數但未提供給 VideoBWSessionLimit,VideoBWSessionLimit 會使用預設值 700。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照,但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數,將可變更物件參照的屬性,然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimits -AudioBWLimit 2000 -AudioBWSessionLimit 200 -VideoBWLimit 1400 -VideoBWSessionLimit 500
範例 1 會建立名為 LowBWLimits 的新頻寬原則設定檔。這個新設定檔中將已指派兩個原則,音訊原則和視訊原則 (Lync Server 2010 中唯一可能有的兩個原則)。此音訊原則新增至設定檔時,會使用 AudioBWLimit 參數指派 2000 kbps (這是此例使用的值) 作為整體音訊連線的限制,並使用 AudioBWSessionLimit 參數指派 200 kbps 作為個別音訊工作階段的限制。建立視訊工作階段限制時也是用相同的方式,但是會使用 VideoBWLimit 和 VideoBWSessionLimit 參數。