Freigeben über

  • Artikel

Set-CsQoEConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine vorhandene Auflistung von QoE-Einstellungen (Quality of Experience).

Syntax

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

Set-CsQoEConfiguration [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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. Verwenden Sie dieses Cmdlet, um Einstellungen zu ändern, mit denen QoE auf globaler oder Standortebene konfiguriert wird.

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 Set-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 "Set-CsQoEConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Einstellungen, die geändert werden sollen. Mögliche Werte sind "global" und "site:<Standortname>", wobei "<Standortname>" der Name des Standorts in Ihrer Bereitstellung von Lync Server 2010 ist, für den Sie Änderungen übernehmen möchten.

Instance

Optional

QoESettings

Ein Objektverweis auf ein QoE-Konfigurationsobjekt. Dieses Objekt muss ein Objekt vom Typ "QoESettings" sein, das durch Aufrufen von Get-CsQoEConfiguration abgerufen werden kann.

EnableExternalConsumer

Optional

Boolescher Wert

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

EnablePurging

Optional

Boolescher Wert

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

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.

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.

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.

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.QoE.QoESettings-Objekt. Akzeptiert eine weitergeleitete Eingabe von QoE-Konfigurationsobjekten.

Rückgabetypen

Set-CsQoEConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings" konfiguriert.

Beispiel

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

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

Der Befehl in Beispiel 1 verwendet das Cmdlet Set-CsQoEConfiguration, um die QoE-Einstellungen für den Standort "Redmond" (-Identity site:Redmond) zu ändern. Mit den neuen Einstellungen wird QoE deaktiviert, indem der Parameter "EnableQoE" auf "False" festgelegt wird.

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

Set-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 45 -PurgeHourOfDay 4

Dieser Befehl ändert die QoE-Einstellungen, die für den Standort "Dublin" gelten. In diesem Beispiel wurde der Parameter "KeepQoEDataForDays" auf 45 festgelegt, sodass QoE-Daten nach 45 Tagen aus der Datenbank gelöscht werden. Außerdem wurde der Parameter "PurgeHourOfDay" auf 4 festgelegt, was bedeutet, dass Daten, die älter als die zuvor angegebenen 45 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.