• Artikel

Remove-CsNetworkBandwidthPolicyProfile

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt ein Bandbreitenrichtlinienprofil.

Syntax

Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 entfernt ein Containerprofil für diese Richtlinien.

WICHTIG: Wenn einem Standort (über das Cmdlet New-CsNetworkSite oder das Cmdlet Set-CsNetworkSite), einer standortübergreifenden Richtlinie (über das Cmdlet New-CsNetworkInterSitePolicy oder das Cmdlet Set-CsNetworkInterSitePolicy) oder einer Netzwerkregionenverbindung (über das Cmdlet New-CsNetworkRegionLink oder das Cmdlet Set-CsNetworkRegionLink) ein Profil zugewiesen wurde, kann dieses nicht entfernt werden. Beim Versuch, das Profil über einen Aufruf von Remove-CsNetworkBandwidthPolicyProfile zu entfernen, wird ein Fehler zurückgegeben. Zum Entfernen des Profils muss dieses zunächst aus allen Standorten, standortübergreifenden Richtlinien und Netzwerkregionenverbindungen entfernt werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Ein Zeichenfolgenwert zur eindeutigen Kennzeichnung des zu entfernenden Bandbreitenrichtlinienprofils. Beim Angeben einer Identität wird maximal ein Profil entfernt.

Force

Optional

Switch-Parameter

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

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

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 entfernt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType".

Beispiel

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

Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

In diesem Beispiel wird das Bandbreitenrichtlinienprofil mit der Identität "LowBWProfile" entfernt. Da Identitäten eindeutig sein müssen, wird maximal ein Profil entfernt.

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

Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

In Beispiel 2 werden alle Verweise auf das Bandbreitenrichtlinienprofil mit der Identität "LowBWProfile" aus allen Standorten entfernt, denen das Profil zugeordnet wurde. Anschließend wird das Profil entfernt. In der ersten Zeile wird zunächst Get-CsNetworkSite aufgerufen, um alle für die Anrufsteuerung konfigurierten Standorte abzurufen. Diese Auflistung von Standorten wird anschließend an das Cmdlet Where-Object weitergeleitet, das sie auf lediglich die Standorte beschränkt, deren "BWPolicyProfileID" den Wert "LowBWProfile" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese eingeschränkte Auflistung, die nur Standorte mit dem Wert "LowBWProfile" für den Parameter "BWPolicyProfileID" enthält, wird an das Cmdlet Set-CSNetworkSite weitergeleitet, das den Wert von "BWPolicyProfileID" für jeden aufgeführten Standort in einen Nullwert ($null) ändert. Über diese Schritte wurden sämtliche Standorte ermittelt, bei denen der Parameter "BWPolicyProfileID" den Wert "LowBWProfile" aufweist. Dieser Wert wurde dann auf "Null" gesetzt. Anschließend sind keine Standorte mehr vorhanden, die das Profil "LowBWProfile" verwenden. Jetzt wird das Cmdlet Remove-CsNetworkBandwidthPolicyProfile für das Profil "LowBWProfile" aufgerufen, um das nicht mehr verwendete Profil zu entfernen.

Um sicherzustellen, dass das Profil in der Netzwerkkonfiguration nicht mehr verwendet wird, führen Sie dieselben Schritte in Zeile 1 für standortübergreifende Richtlinien und Netzwerkregionenverbindungen durch.