• Artikel

Set-CsBandwidthPolicyServiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert eine vorhandene Konfiguration des Bandbreitenrichtliniendiensts.

Syntax

Set-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Set-CsBandwidthPolicyServiceConfiguration [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-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 vorhandene Konfiguration des Bandbreitenrichtliniendiensts geändert.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Konfiguration, die geändert 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").

Instance

Optional

BandwidthPolicyServiceConfiguration

Ein Verweis auf ein Objekt für die Konfiguration des Bandbreitenrichtliniendiensts. Das Objekt muss ein Objekt vom Typ "BandwidthPolicyServiceConfiguration" sein, das durch Aufrufen des Cmdlets Get-CsBandwidthPolicyServiceConfiguration abgerufen werden kann.

EnableLogging

Optional

Boolescher Wert

Legen Sie diesen Parameter auf "True" fest, um Protokolle zu Anrufsteuerungsfehlern und Linkstatus im Zusammenhang mit dem Bandbreitenrichtliniendienst zu generieren.

LogCleanUpInterval

Optional

TimeSpan

Der Zeitraum, nach dem Protokolle zu Anrufsteuerungsfehlern und Linkstatus entfernt werden.

Dieser Wert muss zwischen 1 Tag und 60 Tagen liegen. Der Wert muss im Format "tt.hh:mm:ss" eingegeben werden, wobei "t" für Tage, "h" für Stunden, "m" für Minuten und "s" für Sekunden steht. Beispiel: 20 Tage werden im Format 20.00:00:00 ausgedrückt.

MaxLogFileSizeMb

Optional

UInt32

Die maximal zulässige Größe der Protokolldatei. Der Wert für diesen Parameter muss eine positive Zahl sein. Er gibt die Dateigröße in Megabyte an. Wenn beispielsweise die Protokolldatei die maximal zulässige Größe von 10 Megabyte haben soll, geben Sie den Wert 10 ein.

MaxTokenLifetime

Optional

TimeSpan

Der maximale Zeitraum, in dem das vom Bandbreitenrichtlinien-Authentifizierungsdienst herausgegebene Token vorhanden ist.

Dieser Wert muss zwischen 1 Stunde und 24 Stunden liegen. Der Wert muss im Format "tt.hh:mm:ss" eingegeben werden, wobei "t" für Tage, "h" für Stunden, "m" für Minuten und "s" für Sekunden steht. Beispiel: 12 Stunden werden im Format 12:00:00 ausgedrückt.

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. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration" geändert.

Beispiel

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

Set-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond -EnableLogging $true -MaxTokenLifetime 3:00:00 -LogCleanUpInterval 5.00:00:00

In diesem Beispiel wird die Konfiguration des Bandbreitenrichtliniendiensts für den Standort "Redmond" (-Identity site:Redmond) geändert. Die Konfiguration wird für die Aktivierung der Protokollierung geändert. Ändern Sie die maximale Gültigkeitsdauer eines Tokens in drei Stunden und die Anzahl der Tage vor der Protokollleerung in fünf Tage. Dies wird mit einem einzigen Befehl durchgeführt. Legen Sie zur Aktivierung der Protokollierung den Parameter "EnableLogging" auf "True" ($true) fest. Der Parameter "MaxTokenLifetime" erhält anschließend den Wert 3:00:00, der drei Stunden darstellt. Der Parameter "LogCleanUpInterval" erhält schließlich den Wert 5.00:00:00, der fünf Tage darstellt.