Set-CsNetworkBandwidthPolicyProfile

Syntax

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

Set-CsNetworkBandwidthPolicyProfile [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 ändert ein Containerprofil für diese Richtlinien.

WICHTIG: Wenn ein Profil mehrere Richtlinien enthält (z. B. eine Audio- und eine Videorichtlinie), werden beim Ändern des Profils mithilfe der Eigenschaften "AudioBWLimit", "AudioBWSessionLimit", "VideoBWLimit" oder "VideoBWSessionLimit" alle im Profil vorhandenen Richtlinien entfernt und durch neue Werte ersetzt. Wenn das Profil eine Richtlinie zum Einschränken von Video enthielt und Sie nur den Parameter "AudioBWLimit" festgelegt haben, wird die Videorichtlinie entfernt und eine Audiorichtlinie erstellt.

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

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType-Objekt. Akzeptiert eine weitergeleitete Eingabe von Objekten für ein Netzwerkbandbreiten-Richtlinienprofil.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Es ändert ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType".

Beispiel

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

Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -Description "Policy for links of less than 10MB"

Dieses Beispiel ändert die Beschreibung des Bandbreitenrichtlinienprofils mit dem Identitätswert "LowBWProfile". Hierzu wird das Cmdlet Set-CsNetworkBandwidthPolicyProfile mit zwei Parametern aufgerufen: "Identity" zum Angeben des Namens des zu ändernden Profils und "Description" zum Angeben der neuen Profilbeschreibung.

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

Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -VideoBWLimit 2500 -VideoBWSessionLimit 300

Beispiel 2 ändert den allgemeinen Grenzwert und den Sitzungsgrenzwert für Videoübertragungen des Bandbreitenrichtlinienprofils mit der Identität "LowBWLimit". Nach Angabe des Identitätswerts des zu ändernden Profils wird als Nächstes mithilfe des Parameters "VideoBWLimit" der allgemeine Videogrenzwert auf 2500 festgelegt. Anschließend wird mithilfe des Parameters "VideoBWSessionLimit" der Grenzwert für einzelne Sitzungen auf 300 festgelegt. Dieser Befehl fügt entweder ein Videoprofil hinzu oder aktualisiert ein vorhandenes Videoprofil für das Bandbreitenrichtlinienprofil "LowBWLimit". Vorhandene Audioprofile sind nicht betroffen.

-------------------------- Beispiel 3 --------------------------

$bp = New-CsNetworkBWPolicy -BWLimit 5000 -BWSessionLimit 200 -BWPolicyModality video
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bp

In diesem Beispiel wird eine neue Bandbreitenrichtlinie erstellt und dem Bandbreitenrichtlinienprofil mit dem Identitätswert "LowBWLimit" zugewiesen. Die erste Zeile in diesem Beispiel enthält einen Aufruf des Cmdlets New-CsNetworkBWPolicy. Dieses Cmdlet erstellt ein neues Profil, in diesem Fall ein Videoprofil (-BWPolicyModality video) mit dem Grenzwert 5000 KBit/s (-BWLimit 5000), und dem Sitzungsgrenzwert 200 KBit/s (-BWSessionLimit 200). Dieses neue Profilobjekt wird in der Variablen "$bp" gespeichert. Die nächste Zeile dieses Beispiels ruft das Cmdlet Set-CsNetworkBandwidthPolicyProfile zum Ändern des Profils "LowBWLimit" (-Identity LowBWLimit) auf. Der Parameter "BWPolicy" wird mit dem Wert von "$bp" verwendet. Dadurch werden alle vorhandenen Richtlinien dieses Profils durch die neu erstellte, in der Variablen "$bp" gespeicherte Richtlinie ersetzt.

-------------------------- Beispiel 4 --------------------------

$a = Get-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
$a.BWPolicy.Add($ap)
Set-CsNetworkBandwidthPolicyProfile -Instance $a

Beispiel 4 fügt eine neue Bandbreitenrichtlinie für Audio den im Profil "LowBWProfile" vorhandenen Richtlinien hinzu. In der ersten Zeile wird Get-CsNetworkBandwidthPolicyProfile aufgerufen, um das Profil mit dem Identitätswert "LowBWProfile" abzurufen. Dieses Profil wird in der Variablen "$a" gespeichert. In der nächsten Zeile wird New-CsNetworkBWPolicy aufgerufen, um eine neue Bandbreitenrichtlinie zu erstellen. Diese Richtlinie ist eine Audiorichtlinie (-BWPolicyModality audio) mit dem Grenzwert 2000 KBit/s (-BWLimit 2000) und dem Sitzungsgrenzwert 300 KBit/s (-BWSessionLimit 300). Die neue Richtlinie wird in der Variablen "$ap" gespeichert.

In der dritten Zeile wird dem in der ersten Zeile abgerufenen (und in der Variablen "$a" gespeicherten) Profil die neue Audiorichtline hinzugefügt (und in "$ap" gespeichert). Hierzu wird die Methode "Add" der Eigenschaft "BWPolicy" des Profils aufgerufen, um einen Wert für "$ap" zu übergeben. Dieser kann so gelesen werden, dass die neue Richtlinie, die in "$ap" gespeichert ist, der Richtlinie "BWPolicy" des Profils "LowBWProfile" (das in "$a" gespeichert ist) hinzugefügt wird.

Schließlich wird das Cmdlet Set-CsNetworkBandwidthPolicyProfile zum Aktualisieren des Profils "LowBWProfile" aufgerufen. Mit dem Parameter "Instance" wird ein Wert von "$a" übergeben, der das geänderte Profil enthält.

-------------------------- Beispiel 5 --------------------------

$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -BWPolicy @{add=$ap}

Beispiel 5 entspricht Beispiel 4 dahingehend, dass der vorhandenen Richtlinienliste für das Profil "LowBWProfile" eine neue Audiorichtlinie hinzugefügt wird. Diese Methode erfordert weniger Befehlszeilen, ist aber ggf. nicht so übersichtlich. Sie wurde hier nur hinzugefügt, um zu veranschaulichen, dass es zum Erledigen derselben Aufgaben mehrere Möglichkeiten gibt.

In Zeile 1 wird eine neue Bandbreitenrichtlinie für Audio erstellt, die ein Bandbreitenlimit (2000) und ein Sitzungslimit (300) festlegt und das neue Objekt in der Variablen "$ap" speichert. Als Nächstes wird Set-CsNetworkBandwidthPolicyProfile aufgerufen, um das Profil mit dem Identitätswert "LowBWProfile" zu ändern. Mithilfe des Parameters "BWPolicy" wird die Liste der Richtlinien im Profil geändert. Beachten Sie den Wert, der an diesen Parameter übergeben wird: @{add=$ap}. Dies ist in Windows PowerShell eine Möglichkeit, ein Element einer Liste hinzuzufügen. Sie beginnen mit dem Zeichen "@", auf das geschweifte Klammern "{}" folgen. In diesen geschweiften Klammern geben Sie die Aktion an, die auf die Liste angewendet werden soll, in diesem Fall eine Hinzufügung zur Liste. (Sie können Elemente auch entfernen oder ersetzen.) Dann folgt die Aktion "(add)" mit einem Gleichheitszeichen, gefolgt vom Objekt, das der Liste hinzugefügt werden soll, in diesem Fall die neue in der Variablen "$ap" gespeicherte Richtlinie.

Siehe auch

Weitere Ressourcen

New-CsNetworkBandwidthPolicyProfile
Remove-CsNetworkBandwidthPolicyProfile
Get-CsNetworkBandwidthPolicyProfile
New-CsNetworkBWPolicy