Freigeben über

  • Artikel

Get-CsQoEConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft eine oder mehrere Auflistungen von QoE-Einstellungen (Quality of Experience) ab.

Syntax

Get-CsQoEConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsQoEConfiguration [-Filter <String>] [-LocalStore <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 werden Einstellungen abgerufen, die QoE auf globaler oder Standortebene konfigurieren.

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 sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsQoEConfiguration lokal auszuführen: RTCUniversalUserAdmins, 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 "Get-CsQoEConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Einstellungen, die abgerufen 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.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen, um eine Auflistung (oder mehrere Auflistungen) von QoE-Konfigurationseinstellungen zurückzugeben. Verwenden Sie folgende Syntax, um eine Auflistung aller auf Standortebene konfigurierten Einstellungen zurückzugeben: -Filter site:*. Verwenden Sie folgende Syntax, um eine Auflistung aller Einstellungen zurückzugeben, deren Identitätswert (die einzige Eigenschaft, nach der gefiltert werden kann) den Zeichenfolgenwert "Western" aufweist: -Filter *Western*.

LocalStore

Optional

Switch-Parameter

Ruft die Einstellungen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab.

Eingabetypen

Keine.

Rückgabetypen

Mit Get-CsQoEConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings" zurückgegeben.

Beispiel

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

Get-CsQoEConfiguration

Bei diesem Beispiel gibt Get-CsQoEConfiguration eine Auflistung aller QoE-Einstellungen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind.

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

Get-CsQoEConfiguration -Identity site:Redmond

In Beispiel 2 wird der Parameter "Identity" verwendet, um sicherzustellen, dass Get-CsQoEConfiguration nur die QoE-Einstellungen mit dem Identitätswert "site:Redmond" zurückgibt.

-------------------------- Beispiel 3 --------------------------

Get-CsQoEConfiguration -Filter site:*

In Beispiel 3 werden mithilfe des Parameters "Filter" alle QoE-Einstellungen zurückgegeben, die auf Standortebene konfiguriert wurden. Der Filterwert "site:*" gibt alle QoE-Einstellungen zurück, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Alle Einstellungen, die diesen Kriterien entsprechen, wurden auf Standortebene konfiguriert.

-------------------------- Beispiel 4 --------------------------

Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30}

Im vorherigen Beispiel wird eine Auflistung aller QoE-Einstellungen zurückgegeben, bei denen der Wert der Eigenschaft "KeepQoEDataForDays" kleiner als 30 Tage ist. Zu diesem Zweck verwendet der Befehl zunächst Get-CsQoEConfiguration, um eine Auflistung aller in der Organisation konfigurierten QoE-Einstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das einen Filter anwendet, um die zurückgegebenen Daten auf die Einstellungen zu begrenzen, deren Wert für "KeepQoEDataForDays" kleiner als 30 Tage ist.