Remove-CsQoEConfiguration
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt eine Auflistung von QoE-Einstellungen (Quality of Experience).
Syntax
Remove-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 werden Einstellungen entfernt, die QoE auf Standortebene konfigurieren. Wenn dieses Cmdlet für die globale QoE-Konfiguration aufgerufen wird, werden alle Einstellungen auf ihre Standardwerte zurückgesetzt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsQoEConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Die eindeutige ID der Einstellungen, die entfernt werden sollen. Mögliche Werte sind "global" und "site:<Standortname>", wobei "<Standortname>" der Name des Standorts in Ihrer Microsoft Lync Server 2010-Bereitstellung ist, der die zu entfernenden Einstellungen aufweist. |
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
Dieses Cmdlet gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings" entfernt.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsQoEConfiguration -Identity site:Redmond
Im vorstehenden Befehl werden mit Remove-CsQoEConfiguration die QoE-Einstellungen entfernt, die dem Standort "Redmond" zugewiesen sind. Die Verwendung des Parameters "Identity" stellt sicher, dass nur Einstellungen entfernt werden, die dem angegebenen Standort zugewiesen sind.
-------------------------- Beispiel 2 --------------------------
Get-CsQoEConfiguration -Filter site:* | Remove-CsQoEConfiguration
Der Befehl in Beispiel 2 entfernt alle QoE-Einstellungen, die auf Standortebene zugewiesen wurden. Hierzu ruft der Befehl zunächst mit Get-CsQoEConfiguration und dem Parameter "Filter" die entsprechenden QoE-Einstellungen ab. Die Platzhalterzeichenfolge "site:*" stellt sicher, dass nur solche Einstellungen zurückgegeben werden, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsQoEConfiguration weitergeleitet, das alle Elemente in der Auflistung löscht.
-------------------------- Beispiel 3 --------------------------
Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30} | Remove-CsQoEConfiguration
In Beispiel 3 werden sämtliche QoE-Einstellungen gelöscht, deren Eigenschaft "KeepQoEDataForDays" einen geringeren Wert als 30 aufweisen. Hierzu ruft der Befehl zunächst Get-CsQoEConfiguration ohne Parameter auf, um eine Auflistung aller QoE-Einstellungen zurückzugeben, die derzeit in der Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "KeepQoEDataForDays" einen geringeren Wert als 30 aufweist (der Vergleichsoperator "-lt" steht für "less than"). Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsQoEConfiguration weitergeleitet, das jedes Element in der Auflistung löscht.