• Artikel

New-CsNetworkBWPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-25

Erstellt im Arbeitsspeicher eine Bandbreitenrichtlinie, die auf das Bandbreitenrichtlinienprofil angewendet werden kann. Diese Richtlinie gilt in Microsoft Lync Server 2010 entweder für die Audio- oder Videobandbreite.

Syntax

New-CsNetworkBWPolicy -BWLimit <UInt32> -BWPolicyModality <Audio | Video> -BWSessionLimit <UInt32>

Detaillierte Beschreibung

Mit diesem Cmdlet wird eine neue Bandbreitenrichtlinie erstellt. Eine Bandbreitenrichtlinie wird verwendet, um Bandbreiteneinschränkungen für bestimmte Modalitäten zu definieren. (In Lync Server 2010 können Bandbreiteneinschränkungen nur für Audio und Video zugewiesen werden.) Die Bandbreitenrichtlinie wird nur im Arbeitsspeicher erstellt. Die Ausgabe muss daher einer Variablen zugewiesen und dann dem Parameter "BWPolicy" des Cmdlets New-CsNetworkBandwidthPolicyProfile oder Set-CsNetworkBandwidthPolicyProfile übergeben werden. Bandbreitenrichtlinien werden auf Richtlinienprofile angewendet, die mehrere Richtlinien für ein Profil speichern und Teil der globalen Netzwerkkonfiguration für die Anrufsteuerung sind.

Es wird zudem empfohlen, Audio- und Videorichtlinien auch direkt dem Bandbreitenrichtlinienprofil zuzuweisen, indem das Cmdlet New-CsNetworkBandwidthPolicyProfile oder Set-CsNetworkBandwidthPolicyProfile aufgerufen wird und Werte für die Parameter "AudioBWLimit", "AudioBWSessionLimit", "VideoBWLimit" und "VideoBWSessionLimit" festgelegt werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsNetworkBWPolicy lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBWPolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

BWLimit

Erforderlich

UInt32

Die maximale Gesamtbandbreite (KBit/s) für alle gleichzeitigen Sitzungen des im Parameter "BWPolicyModality" festgelegten Typs.

BWPolicyModality

Erforderlich

BWPolicyModality

Legt fest, welcher Bandbreitentyp beschränkt wird.

Gültige Werte: Audio, Video

BWSessionLimit

Erforderlich

UInt32

Die maximale, für eine einzige Sitzung zulässige Bandbreite (KBit/s) des im Parameter "BWPolicyModality" festgelegten Typs.

Eingabetypen

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyType".

Beispiel

-------------------------- Beispiel 1 --------------------------

$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video

In diesem Beispiel wird eine neue Bandbreitenrichtlinie erstellt und der Variablen "$bwp" zugewiesen. Alle Parameter für das Cmdlet New-CsNetworkBWPolicy sind erforderlich. In diesem Beispiel wurde ein Gesamtbandbreitenlimit (BWLimit) von 2000 KBit/s und ein Bandbreitensitzungslimit (BWSessionLimit) von 300 KBit/s festgelegt, und diese Grenzwerte wurden auf Videositzungen (-BWPolicyModality video) angewendet.

-------------------------- Beispiel 2 --------------------------

$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bwp

Beispiel 2 ist eine Erweiterung von Beispiel 1, indem einem Richtlinienprofil eine neue Bandbreitenrichtlinie zugewiesen wird. Der Befehl in Zeile 1 ist mit Beispiel 1 identisch: Es werden Videobandbreiteneinschränkungen erstellt. In Zeile 2 wird dann New-CsNetworkBandwidthPolicyProfile aufgerufen, um diese Richtlinie einem neuen Profil hinzuzufügen. Das neue Profil erhält den Identitätswert "LowBWLimit". Anschließend wird der Parameter "BWPolicy" verwendet, der den Wert "$bwp" erhält. Dieser Wert ist die Variable, die die neue Bandbreitenrichtlinie enthält, die in Zeile 1 erstellt wurde.