Freigeben über

  • Artikel

New-CsQoEConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Erstellt eine neue Auflistung von QoE-Einstellungen (Quality of Experience).

Syntax

New-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

QoE-Metriken dienen der Überwachung der Qualität von Audio- und Videoanrufen in Ihrer Organisation, z. B. der Anzahl der verloren gegangenen Netzwerkpakete, von Hintergrundgeräuschen und der Unterschiede bei Paketverzögerung (Jitter). Diese Metriken werden in einer Datenbank getrennt von anderen Daten (z. B. den Kommunikationsdatensätzen) gespeichert, sodass QoE unabhängig von anderen Datenaufzeichnungen aktiviert und deaktiviert werden kann. Mit diesem Cmdlet können Sie Einstellungen erstellen, mit denen QoE auf Standortebene konfiguriert wird. (Einstellungen auf globaler Ebene sind standardmäßig vorhanden und können nicht entfernt werden.)

QoE ist Teil der Rolle Monitoring Server, daher muss Monitoring Server in Ihrer Microsoft Lync Server 2010-Installation bereitgestellt werden, bevor QoE-Aufzeichnungen erfolgen bzw. QoE-Daten erfasst werden können.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Der Standort, für den die neuen Einstellungen gelten. Die Eingabe muss im Format "site:<Standortname>" erfolgen, wobei <Standortname> der Name des Standorts in Ihrer Lync Server 2010-Bereitstellung ist.

EnableExternalConsumer

Optional

Boolescher Wert

Gibt an, ob ein externer Empfänger QoE-Berichte empfangen kann.

Standard: False

EnablePurging

Optional

Boolescher Wert

Gibt an, ob Datensätze gelöscht werden, nachdem der in der Eigenschaft "KeepQoEDataForDays" festgelegte Zeitraum abgelaufen ist.

Standard: True

EnableQoE

Optional

Boolescher Wert

Gibt an, ob QoE-Datensätze erfasst und in der Überwachungsdatenbank gespeichert werden.

Beachten Sie, dass selbst bei Festlegung von "EnableQoE" auf "True" QoE-Daten erst erfasst werden, wenn ein Monitoring Server bereitgestellt und einem Registrierungspool zugeordnet wurde.

Standard: True

ExternalConsumerIssuedCertId

Optional

IssuedCertId

Die ID des Zertifikats, das den Zugriff auf den Webdienst des externen Empfängers zulässt.

ExternalConsumerName

Optional

Zeichenfolge

Der Anzeigename des externen Empfängers des QoE-Berichts.

ExternalConsumerURL

Optional

Zeichenfolge

Die URL des externen Empfängers, an den QoE-Berichte übermittelt werden.

KeepQoEDataForDays

Optional

UInt32

Die Anzahl von Tagen, die QoE-Daten gespeichert werden, bevor sie aus der Datenbank gelöscht werden. Dieser Wert wird ignoriert, wenn "EnablePurging" auf "False" festgelegt ist.

Wertebereich: 1 bis 2562.

Standard: 60

PurgeHourOfDay

Optional

UInt32

Die Uhrzeit, zu der QoE-Datensätze gelöscht werden, die die Anzahl der in der Eigenschaft "KeepQoEDataForDays" angegebenen Tage überschritten haben.

Muss ein Wert von 0 bis 23 sein, der die Uhrzeit darstellt. Beispiel: 0 steht für Mitternacht, 13 steht für 1:00 PM. Standard: 1

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.QoE.QoESettings".

Beispiel

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

New-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False

Der Befehl in Beispiel 1 verwendet das Cmdlet New-CsQoEConfiguration zum Erstellen einer neuen Gruppe von QoE-Einstellungen mit dem Identitätswert "site:Redmond". Zusätzlich zum Identitätswert "site:Redmond" ist die Eigenschaft "EnableQoE" in den neuen Einstellungen auf "False" festgelegt. Da Standorteinstellungen Vorrang vor globalen Einstellungen haben, bedeutet dies, dass QoE für den Standort "Redmond" unabhängig davon deaktiviert wird, ob QoE auf globaler Ebene aktiviert wurde oder nicht.

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

New-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 30 -PurgeHourOfDay 4

Dieser Befehl erstellt neue QoE-Einstellungen, die für den Standort "Dublin" gelten. In diesem Beispiel wurde der Parameter "KeepQoEDataForDays" auf 30 festgelegt, sodass QoE-Daten anstatt standardmäßig alle 60 Tage nun nach 30 Tagen aus der Datenbank entfernt werden. Außerdem wurde der Parameter "PurgeHourOfDay" auf 4 festgelegt, was bedeutet, dass Daten, die älter als die zuvor angegebenen 30 Tage sind, um 04:00 Uhr gelöscht werden.

Hinweis: Falls QoE und die Aufzeichnung von Kommunikationsdatensätzen (KDS) aktiviert sind, empfiehlt es sich aus Leistungsgründen, die Einstellung "PurgeHourOfDay" für QoE anders festzulegen als für KDS.