• Artikel

Remove-CsBandwidthPolicyServiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt eine vorhandene Konfiguration des Bandbreitenrichtliniendiensts.

Syntax

Remove-CsBandwidthPolicyServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mithilfe der Anrufsteuerung können Sie festlegen, ob basierend auf Bandbreiteneinschränkungen Echtzeitkommunikationssitzungen (z. B. Sprach- oder Videoanrufe) hergestellt werden können. In der Microsoft Lync Server 2010-Implementierung der Anrufsteuerung werden Regionen, Standorte und Subnetze in einem Netzwerk mit den Beziehungen und Verbindungen zwischen diesen Entitäten definiert, um Bandbreiteneinschränkungen zwischen ihnen zu definieren. Der Bandbreitenrichtliniendienst ist die Komponente, die in einer Lync Server 2010-Bereitstellung die Anrufsteuerung übernimmt und beispielsweise die Entscheidung ermöglicht, ob für einen zu tätigenden Anruf ausreichend Bandbreite zur Verfügung steht. Mit diesem Cmdlet wird eine auf Standortebene definierte Konfiguration des Bandbreitenrichtliniendiensts entfernt. Sie können das Cmdlet auch zum "Entfernen" des globalen Bandbreitenrichtliniendiensts verwenden. Der globale Dienst wird jedoch nicht wirklich entfernt, sondern lediglich auf die Standardwerte zurückgesetzt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID der Konfiguration, die entfernt werden soll. Diese ID umfasst den Gültigkeitsbereich (für die globale Konfiguration) oder den Gültigkeitsbereich und den Namen (für die Konfiguration auf Standortebene, z. B. "site:Redmond").

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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von Konfigurationsobjekten des Bandbreitenrichtliniendiensts.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Es entfernt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration".

Beispiel

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

Remove-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

In diesem Beispiel wird die Konfiguration des Bandbreitenrichtliniendiensts entfernt, die für den Standort "Redmond" (-Identity site:Redmond) definiert ist.

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

Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.EnableLogging -eq $False} | Remove-CsBandwidthPolicyServiceConfiguration

Beispiel 2 ruft alle Konfigurationen des Bandbreitenrichtliniendiensts ab, bei denen die Protokollierung deaktiviert ist. Hierzu wird zunächst das Cmdlet Get-CsBandwidthPolicyServiceConfiguration aufgerufen. Daraufhin wird eine Auflistung aller Konfigurationen des Bandbreitenrichtliniendiensts in der Lync Server 2010-Bereitstellung zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet und dadurch auf die Konfigurationen beschränkt, bei denen die Eigenschaft "EnableLogging" den Wert "False" ($False) aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Das Ergebnis ist eine Auflistung von Konfigurationen mit deaktivierter Protokollierung. Diese Auflistung wird dann an das Cmdlet Remove-CsBandwidthPolicyServiceConfiguration weitergeleitet, das jedes Element in der Auflistung entfernt.