Set-CsDiagnosticConfiguration

Syntax

Set-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsDiagnosticConfiguration [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

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

Gelegentlich kann dies jedoch zu einer Aufzeichnung zu vieler Informationen führen. 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.

Konfigurationseinstellungen für die Diagnose ermöglichen es Ihnen, die Domänen oder URIs anzugeben, für die Informationen in den Protokolldateien aufgezeichnet werden. Lync Server ermöglicht das Erstellen von Diagnosekonfigurationseinstellungen auf Standortebene. So können Sie beispielsweise bestimmte Einstellungen auf den Standort "Redmond" anwenden, während Sie auf weitere Standorte andere Einstellungen anwenden.

Mit dem Cmdlet Set-CsDiagnosticConfiguration können Filter zu einer Auflistung hinzugefügt oder aus dieser entfernt werden. Filter werden verwendet, um die Domänen anzugeben, für die der Datenverkehr protokolliert werden soll.

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

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings-Objekt. Set-CsDiagnosticConfiguration akzeptiert weitergeleitete Objektinstanzen der Diagnosekonfigurationseinstellungen.

Rückgabetypen

Set-CsDiagnosticConfiguration gibt keine Werte oder Objekte zurück. Stattdessen konfiguriert das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings".

Beispiel

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri sip:user@fabrikam.com 
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Die in Beispiel 3 gezeigten Befehle verwenden New-CsDiagnosticsFilter, um einen neuen Diagnosefilter zu erstellen. Dieser Filter wird anschließend den globalen Diagnosekonfigurationseinstellungen zugewiesen. Zum Ausführen dieser Aufgabe ruft der erste Befehl New-CsDiagnosticsFilter auf, um einen nur im Arbeitsspeicher vorhandenen Diagnosefilter zu erstellen. Dieser Filter verwendet den FQDN "fabrikam.com" und den URI "sip:user@fabrikam.com". Der virtuelle Filter wird anschließend in der Variablen "$x" gespeichert.

In Befehl 2 wird Set-CsDiagnosticConfiguration verwendet, um den neuen Filter den globalen Diagnosekonfigurationseinstellungen zuzuweisen. In diesem Fall werden alle vorhandenen Werte in der Eigenschaft "Filter" durch den neu erstellten Filter ersetzt.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Add("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Beispiel 2 zeigt, wie Sie der Eigenschaft "Filter" der globalen Diagnosekonfigurationseinstellungen einen neuen FQDN hinzufügen können. Hierzu verwendet der erste Befehl im Beispiel Get-CsDiagnosticConfiguration, um den Wert der Eigenschaft "Filter" für die globalen Einstellungen abzurufen. Dies wird erreicht, indem der Aufruf von Get-CsDiagnosticConfiguration in Klammern eingeschlossen wird. Auf diese Weise führt Windows PowerShell diesen Befehl vor allen anderen aus. Nachdem die globalen Einstellungen zurückgegeben wurden, wird der Wert der Eigenschaft "Filter" extrahiert und in der Variablen "$x" gespeichert.

Im zweiten Befehl wird über die Add-Methode ein neuer FQDN (fabrikam.com) zum Filter hinzugefügt. Anschließend wird im letzten Befehl des Beispiels Set-CsDiagnosticConfiguration aufgerufen, um die geänderte Diagnoseauflistung in die Einstellungen zu schreiben. Als Ergebnis wird "fabrikam.com" zu allen FQDN hinzugefügt, die bereits in der Eigenschaft "Filter" enthalten sind.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Remove("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Über die Befehle in Beispiel 3 wird ein FQDN (fabrikam.com) aus der Eigenschaft "Filter" der globalen Diagnosekonfigurationseinstellungen entfernt. Der erste Befehl verwendet Get-CsDiagnosticConfiguration, um den aktuellen Wert der Eigenschaft "Filter" für die globalen Einstellungen abzurufen. Dieser Wert wird in der Variablen "$x" gespeichert. Nachdem dieser Wert abgerufen wurde, wird der FQDN "fabrikam.com" über die Remove-Methode entfernt. Nach dem Entfernen des FQDN wird Set-CsDiagnosticConfiguration verwendet, um den geänderten Filter (der in der Variablen "$x" gespeichert ist) in die globalen Einstellungen zu schreiben.

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

Set-CsDiagnosticConfiguration -Identity global -Filter $Null

In Beispiel 4 werden alle Elemente aus der Eigenschaft "Filter" der globalen Diagnosekonfigurationseinstellungen entfernt. Hierzu wird die Eigenschaft "Filter" auf einen Nullwert festgelegt.

Siehe auch

Weitere Ressourcen

Get-CsDiagnosticConfiguration
New-CsDiagnosticConfiguration
New-CsDiagnosticsFilter
Remove-CsDiagnosticConfiguration