• Artikel

New-CsNetworkBandwidthPolicyProfile

 

Letztes Änderungsdatum des Themas: 2012-03-24

Erstellt ein neues Bandbreitenrichtlinienprofil. Dieses Cmdlet kann auch zum Festlegen der Bandbreitenrichtlinien innerhalb des Profils verwendet werden.

Syntax

New-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Im Rahmen der Anrufsteuerung wird eine Bandbreitenrichtlinie dazu verwendet, Bandbreiteneinschränkungen für bestimmte Modalitäten zu definieren. (In Microsoft Lync Server 2010 können Bandbreiteneinschränkungen nur für Audio und Video zugewiesen werden.) Dieses Cmdlet erstellt ein Containerprofil für diese Richtlinien. Sie definieren die einzelnen Richtlinien innerhalb des Containers, indem Sie beim Aufruf dieses Cmdlets die Beschränkungen für die Audio- und Videobandbreite angeben.

Bandbreitenrichtlinienprofile werden durch das Aufrufen der Cmdlets New-CsNetworkSite oder Set-CsNetworkSite auf Netzwerkstandorte angewendet.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-CsNetworkBandwidthPolicyProfile lokal auszufü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-CsNetworkBandwidthPolicyProfile"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Ein Zeichenfolgenwert, der die Richtlinie eindeutig identifiziert. Alle Bandbreitenrichtlinienprofile werden auf globaler Ebene erstellt. Der Gültigkeitsbereich ist daher impliziert, und es muss beim Erstellen eines neuen Bandbreitenrichtlinienprofils nur ein eindeutiger Name angegeben werden. Beachten Sie, dass mit diesem Wert auch die Eigenschaft "BWPolicyProfileID" des Profils aufgefüllt wird.

AudioBWLimit

Optional

Zeichenfolge

Die maximale Bandbreite, die für alle Audioverbindungen zugewiesen wird. Wenn eine einzelne Audiositzung das Audiobandbreitenlimit überschreitet, kann diese Sitzung nicht gestartet werden.

Ausgedrückt in KBit/s. Der Wert 1000 steht beispielsweise für 1.000 KBit/s.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keinen Wert für den Parameter "BWPolicy" angeben.

Standard: Wenn Sie einen Wert für den Parameter "AudioBWSessionLimit", jedoch nicht für "AudioBWLimit" angeben, wird "AudioBWLimit" standardmäßig auf 0 festgelegt.

AudioBWSessionLimit

Optional

Zeichenfolge

Die maximale Bandbreite, die pro Audiositzung zugewiesen wird. Ausgedrückt in KBit/s. Der Wert muss bei 40 oder höher liegen.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keinen Wert für den Parameter "BWPolicy" angeben.

Standard: Wenn Sie einen Wert für den Parameter "AudioBWLimit", jedoch nicht für "AudioBWSessionLimit" angeben, wird "AudioBWSessionLimit" standardmäßig auf 175 festgelegt.

BWPolicy

Optional

PSListModifier

Eine Liste der Objekte, die Bandbreitenrichtlinienprofile enthalten. Jedes Objekt in der Liste umfasst eine Bandbreitenmodalität (Audio oder Video), eine Bandbreiteneinschränkung sowie eine Bandbreitensitzungseinschränkung.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keinen Wert für die Parameter "AudioBWLimit", "AudioBWSessionLimit", "VideoBWLimit" oder "VideoBWSessionLimit" angeben.

Objekte in der Liste können mit dem Cmdlet New-CsNetworkBWPolicy erstellt werden.

Description

Optional

Zeichenfolge

Eine Beschreibung des Bandbreitenrichtlinienprofils. Sie können diesen Parameter beispielsweise verwenden, um die erwartete Verwendung des Profils zu erläutern.

VideoBWLimit

Optional

Zeichenfolge

Die maximale Bandbreite, die für alle Videoverbindungen zugewiesen wird. Wenn eine einzelne Videositzung das Videobandbreitenlimit überschreitet, kann diese Sitzung nicht gestartet werden.

Ausgedrückt in KBit/s. Der Wert 1000 steht beispielsweise für 1.000 KBit/s.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keinen Wert für den Parameter "BWPolicy" angeben.

Standard: Wenn Sie einen Wert für den Parameter "VideoBWSessionLimit", jedoch nicht für "VideoBWLimit" angeben, wird "VideoBWLimit" standardmäßig auf 0 festgelegt.

VideoBWSessionLimit

Optional

Zeichenfolge

Die maximale Bandbreite, die pro Videositzung zugewiesen wird. Ausgedrückt in KBit/s. Der Wert muss bei 100 oder höher liegen.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keinen Wert für den Parameter "BWPolicy" angeben.

Standard: Wenn Sie einen Wert für den Parameter "VideoBWLimit", jedoch nicht für "VideoBWSessionLimit" angeben, wird "VideoBWSessionLimit" standardmäßig auf 700 festgelegt.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Keine.

Rückgabetypen

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

Beispiel

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

New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimits -AudioBWLimit 2000 -AudioBWSessionLimit 200 -VideoBWLimit 1400 -VideoBWSessionLimit 500

In Beispiel 1 wird ein neues Bandbreitenrichtlinienprofil namens "LowBWLimits" erstellt. Diesem neuen Profil werden zwei Richtlinien zugewiesen, eine Audio- und eine Videorichtlinie (die einzig möglichen Richtlinientypen in Lync Server 2010). Die Audiorichtlinie wird dem Profil hinzugefügt, indem dem Parameter "AudioBWLimit" ein Limit von (in diesem Fall) 2.000 KBit/s für alle Audioverbindungen und dem Parameter "AudioBWSessionLimit" ein Limit von 200 KBit/s für einzelne Audiositzungen zugewiesen wird. Ebenso werden Limits für Videositzungen erstellt, hierbei unter Verwendung der Parameter "VideoBWLimit" und "VideoBWSessionLimit".