Get-CsDiagnosticConfiguration

Syntax

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

Get-CsDiagnosticConfiguration [-Filter <String>] [-LocalStore <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 Get-CsDiagnosticConfiguration können Sie Informationen zu den Konfigurationseinstellungen für Diagnosefilter zurückgeben, die derzeit in Ihrer Organisation verwendet werden.

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

Parameter

Eingabetypen

Keine. Get-CsDiagnosticConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsDiagnosticConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings" zurückgegeben.

Beispiel

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

Get-CsDiagnosticConfiguration

In Beispiel 1 werden Informationen zu allen Diagnosekonfigurationseinstellungen zurückgegeben, die derzeit in der Organisation verwendet werden. Dazu wird Get-CsDiagnosticConfiguration ohne Parameter aufgerufen.

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

Get-CsDiagnosticConfiguration -Identity site:Redmond

Mit dem vorstehenden Befehl werden Informationen zu Diagnosekonfigurationseinstellungen zurückgegeben, die auf den Standort "Redmond" (-Identity site:Redmond) angewendet wurden.

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

Get-CsDiagnosticConfiguration -Identity site:Redmond | Select-Object -ExpandProperty Filter

Der Befehl in Beispiel 3 zeigt Informationen zu den einzelnen Filtern in den Diagnosekonfigurationseinstellungen für den Standort "Redmond" an. Hierzu wird zunächst Get-CsDiagnosticConfiguration verwendet, um die Einstellungen für den Standort "Redmond" zurückzugeben. Diese Informationen werden anschließend an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" verwendet, um den Wert der Eigenschaft "Filter" zu "erweitern". Durch eine Erweiterung der Eigenschaft "Filter" können Sie auf die Eigenschaften und Eigenschaftswerte für einzelne Filter in den Diagnosekonfigurationseinstellungen zugreifen.

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

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -contains "sip:diagnostics@litwareinc.com"}

Mit dem Befehl in Beispiel 4 wird ein Teilsatz der Filter zurückgegeben, die in den globalen Diagnosekonfigurationseinstellungen enthalten sind. Insbesondere werden Filter zurückgegeben, bei denen die Eigenschaft "Uri" die SIP-Adresse "sip:diagnostics@litwareinc.com" enthält. Hierzu wird zunächst das Cmdlet Get-CsDiagnosticConfiguration aufgerufen, um alle Filterinformationen für die globale Instanz der Diagnosekonfigurationseinstellungen zurückzugeben. Diese Informationen werden dann an das Cmdlet Select-Object weitergeleitet, wodurch die Eigenschaft "Filter" erweitert wird. Die einzelnen Filterobjekte werden dann an das Cmdlet Select-Object weitergeleitet, das nur die Filter extrahiert, deren Eigenschaft "Uri" die SIP-Adresse "sip:diagnostics@litwareinc.com" enthält.

-------------------------- Beispiel 5 --------------------------

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -notcontains "sip:diagnostics@litwareinc.com"}

Beispiel 5 ist eine Variante des in Beispiel 4 gezeigten Befehls. In Beispiel 5 werden Filter jedoch nur dann zurückgegeben, wenn die Eigenschaft "Uri" nicht die SIP-Adresse "sip:diagnostics@litwareinc.com" enthält. Hierzu ruft der Befehl Get-CsDiagnosticConfiguration auf, um alle Diagnosekonfigurationsinformationen für die globale Instanz der Konfigurationseinstellungen zurückzugeben. Diese Informationen werden dann an das Cmdlet Select-Object weitergeleitet, wodurch die Eigenschaft "Filter" erweitert wird. Diese Filterobjekte werden dann an das Cmdlet Select-Object weitergeleitet, das nur die Filter auswählt, deren Eigenschaft "Uri" nicht die SIP-Adresse "sip:diagnostics@litwareinc.com" enthält.

Siehe auch

Weitere Ressourcen

New-CsDiagnosticConfiguration
Remove-CsDiagnosticConfiguration
Set-CsDiagnosticConfiguration