• Artikel

New-CsBandwidthPolicyServiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt eine neue Konfiguration des Bandbreitenrichtliniendiensts.

Syntax

New-CsBandwidthPolicyServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 ein neuer Bandbreitenrichtliniendienst auf Standortebene konfiguriert.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID, die den Gültigkeitsbereich und den Namen der Konfiguration enthält. Diese Konfiguration kann nur auf Standortebene erstellt werden, daher liegt der Identitätswert im folgenden Format vor: "site:<Standortname>", wobei <Standortname> für den Namen des Standorts steht, auf den die Konfiguration angewendet wird.

EnableLogging

Optional

Boolescher Wert

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

Standard: False

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.

Standard: 10 Tage (10.00:00:00)

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.

Standard: 3 (MB)

MaxTokenLifetime

Optional

TimeSpan

Der maximale Zeitraum, in dem das vom Bandbreitenrichtlinien-Authentifizierungsdienst ausgegebene 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.

Standard: 8 Stunden (08:00:00)

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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration".

Beispiel

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

New-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

In diesem Beispiel wird die Konfiguration des Bandbreitenrichtliniendiensts erstellt, die für den Standort "Redmond" (-Identity site:Redmond) definiert ist. Da keine Parameter angegeben sind, werden für alle Konfigurationswerte die Standardwerte verwendet.

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

New-CsBandwidthPolicyServiceConfiguration -Identity site:Dublin -EnableLogging $True -LogCleanupInterval 30.00:00:00

In diesem Beispiel wird eine neue Konfiguration des Bandbreitenrichtliniendiensts für den Standort Dublin (-Identity site:Dublin) erstellt. Für diesen Standort sollen nicht die Standardwerte verwendet werden. Stattdessen wird die Protokollierung aktiviert, und der Zeitraum bis zum Löschen der Protokolle wird auf 30 Tage festgelegt. Hierzu wird der Wert "True" ($True) an den Parameter "EnableLogging" und anschließend der Wert 30.00:00:00 an den Parameter "LogCleanupInterval" übergeben. Der Wert "LogCleanupInterval" ist ein Objekt vom Typ "TimeSpan" im Format "tt.hh:mm:ss", wobei t für Tage, h für Stunden, m für Minuten und s für Sekunden steht.