• Artikel

Remove-CsDiagnosticConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine oder mehrere der derzeit in Ihrer Organisation verwendeten Auflistungen von Konfigurationseinstellungen für die Diagnose. Mit Konfigurationseinstellungen für die Diagnose wird festgelegt, ob der Datenverkehr an oder von bestimmten Domänen oder URIs (Uniform Resource Identifier) in Ihren Microsoft Lync Server 2010-Protokolldateien aufgezeichnet wird.

Syntax

Remove-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Wenn Sie die Protokollierung für Lync Server 2010 aktivieren, wird der Datenverkehr an oder von Domänen oder URIs in diesen Protokolldateien aufgezeichnet. Dies stellt sicher, dass so viele Informationen wie möglich in den Protokolldateien aufgezeichnet werden.

Dies kann aber gelegentlich dazu führen, dass zu viele Informationen vorliegen. Wenn beispielsweise Probleme bei der Verbindung mit einer bestimmten Domäne auftreten, sollten Sie die Protokollierung auf den Datenverkehr zwischen Ihrem Netzwerk und dieser Domäne begrenzen. Dies erleichtert das Bestimmen der relevanten Einträge sowie auch die Diagnose und Korrektur des Problems.

In den Konfigurationseinstellungen für die Diagnose können Sie die Domänen bzw. URIs angeben, die in den Protokolldateien aufgezeichnet werden sollen. Wenn ein Diagnosefilter aktiviert ist, wird nur der Datenverkehr an und von diesen Domänen protokolliert. Mit Lync Server können Sie Konfigurationseinstellungen für die Diagnose erstellen und Diagnosefilter auf Standortebene anwenden. Dadurch können Sie beispielsweise einen Filter auf den Standort "Redmond" anwenden, während der Filter für die anderen Standorte weiterhin deaktiviert ist.

Mit dem Cmdlet Remove-CsDiagnosticConfiguration können Sie alle Konfigurationseinstellungen für die Diagnose entfernen, die Sie auf Standortebene erstellt haben. Das Cmdlet Remove-CsDiagnosticConfiguration kann auch für die globalen Diagnosefiltereinstellungen ausgeführt werden. In diesem Fall wird die Auflistung jedoch nicht gelöscht, da in Lync Server keine globalen Auflistungen gelöscht werden dürfen. Stattdessen werden die Eigenschaften der globalen Auflistung, die entfernt werden soll, auf ihre Standardwerte zurückgesetzt. Alle dieser Auflistung hinzugefügten Filter werden daher entfernt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID für die Diagnosekonfigurationseinstellungen, die entfernt werden sollen. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierten Einstellungen zu entfernen: -Identity "site:Redmond".

Remove-CsDiagnosticConfiguration kann auch für die globalen Konfigurationseinstellungen ausgeführt werden. Verwenden Sie in diesem Fall folgende Syntax: –Identity global. Die globalen Einstellungen werden jedoch nicht wirklich entfernt. Stattdessen werden die Eigenschaften in den globalen Einstellungen auf ihre Standardwerte zurückgesetzt.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

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.Diagnostics.DiagnosticFilterSettings-Objekt. Remove-CsDiagnosticConfiguration akzeptiert weitergeleitete Instanzen des Objekts für die Diagnosefiltereinstellungen.

Rückgabetypen

Keine. Mit Remove-CsDiagnosticConfiguration werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings" gelöscht.

Beispiel

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

Remove-CsDiagnosticConfiguration -Identity site:Redmond

Mit dem vorstehenden Befehl werden die Diagnosekonfigurationseinstellungen mit dem Identitätswert "site:Redmond" gelöscht.

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

Get-CsDiagnosticConfiguration -Filter site:* | Remove-CsDiagnosticConfiguration

Der Befehl in Beispiel 2 löscht alle Diagnosekonfigurationseinstellungen, die auf Standortebene konfiguriert wurden. Hierzu wird Get-CsDiagnosticConfiguration zusammen mit dem Parameter "Filter" aufgerufen. Mit dem Filterwert "site:*" werden die zurückgegebenen Daten auf Einstellungen beschränkt, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsDiagnosticConfiguration weitergeleitet, das jedes Element in der Auflistung entfernt.

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

Get-CsDiagnosticConfiguration | Remove-CsDiagnosticConfiguration

Der Befehl in Beispiel 3 löscht alle derzeit in der Organisation verwendeten Diagnosekonfigurationseinstellungen. Hierzu wird zunächst Get-CsDiagnosticConfiguration ohne Parameter aufgerufen, um eine Auflistung aller Diagnosekonfigurationseinstellungen zurückzugeben, die derzeit in der Organisation verwendet werden. Diese Elemente werden anschließend an das Cmdlet Remove-CsDiagnosticConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu entfernen.