New-CsDiagnosticsFilter
Letztes Änderungsdatum des Themas: 2012-03-23
Erstellt einen neuen Diagnosefilter, der mit Konfigurationseinstellungen für die Diagnose verwendet wird. Mit Konfigurationseinstellungen für die Diagnose wird festgelegt, ob Datenverkehr an oder von bestimmten Domänen oder URIs (Uniform Resource Identifier) in Ihren Microsoft Lync Server 2010-Protokolldateien aufgezeichnet wird.
Syntax
New-CsDiagnosticsFilter [-Enabled <$true | $false>] [-ExcludeConferenceMessages <$true | $false>] [-ExcludePresenceNotifications <$true | $false>] [-ExcludeRegisterMessages <$true | $false>] [-ExcludeSubscribeMessages <$true | $false>] [-Fqdn <PSListModifier>] [-Uri <PSListModifier>]
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.
Allerdings werden dadurch in manchen Fällen auch zu viele Informationen erfasst. 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 Diagnosekonfigurationseinstellungen können Sie die Domänen oder URIs angeben, die in den Protokolldateien aufgezeichnet werden sollen. So besteht beispielsweise die Möglichkeit, nur den Datenverkehr an und von angegebenen Domänen zu protokollieren. Lync Server ermöglicht neben den globalen Einstellungen auch das Erstellen von Diagnoseeinstellungen auf Standort- oder Dienstebene (für entweder den Edgeserver oder den Registrierungsdienst). Dadurch können Sie auf den Standort "Redmond" Einstellungen anwenden, die von den Einstellungen anderer Standorte abweichen.
Mit New-CsDiagnosticsFilter können Sie einer Auflistung von Diagnosefiltereinstellungen einen Filter hinzufügen. Diese Auflistung enthält die Domänen und URIs, deren Datenverkehr in den Protokolldateien aufgezeichnet wird. Wenn ein Filter hinzugefügt wird, werden nur Informationen zu den im Filter aufgeführten Domänen und URIs protokolliert; Datenverkehr von anderen Domänen und URIs wird bei der Aufzeichnung ignoriert.
Beachten Sie, dass das Cmdlet New-CsDiagnosticsFilter nur im Arbeitsspeicher vorhandene Instanzen eines Diagnosefilters erstellt. Nach der Erstellung eines dieser virtuellen Filter müssen Sie entweder New-CsDiagnosticConfiguration oder Set-CsDiagnosticConfiguration verwenden, um den Filter einer Auflistung hinzuzufügen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsDiagnosticsFilter 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 "New-CsDiagnosticsFilter"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Enabled |
Erforderlich |
Boolescher Wert |
Gibt an, ob der Filter verwendet werden soll oder nicht. Der Standardwert lautet "True" ($True). |
ExcludeConferenceMessages |
Optional |
Boolescher Wert |
Bei einem Wert von "True" werden Informationen über Konferenznachrichten (d. h. alle Nachrichten mit einem Konferenz-URI in der Kopfzeile "An" oder "Von") nicht in den Protokolldateien aufgezeichnet. Der Standardwert lautet "False". |
ExcludePresenceNotifications |
Optional |
Boolescher Wert |
Bei einem Wert von "True" werden Informationen über Anwesenheitsbenachrichtigungen (d. h. alle Nachrichten, die die NOTIFY- oder BENOTIFY-Methode verwenden) nicht in den Protokolldateien aufgezeichnet. Der Standardwert lautet "False". |
ExcludeRegisterMessages |
Optional |
Boolescher Wert |
Bei einem Wert von "True" werden Informationen über Clientregistrierungen (d. h. alle Nachrichten, die die REGISTER-Methode verwenden) nicht in den Protokolldateien aufgezeichnet. Der Standardwert lautet "False". |
ExcludeSubscribeMessages |
Optional |
Boolescher Wert |
Bei Festlegung auf "True" werden Informationen zu Clientabonnements (d. h. alle Nachrichten, die die SUBSCRIBE-Methode verwenden) nicht in den Protokolldateien aufgezeichnet. Der Standardwert ist "False". |
Fqdn |
Optional |
PS-Listenmodifizierer |
Auflistung der Domänen, die in den Filter einbezogen werden sollen. (Technisch gesehen stellen diese Domänen den Hostteil einer SIP-Adresse dar.) Für die Eigenschaft "FQDN" können Sie einen vollqualifizierten Domänennamen (FQDN) wie den folgenden nehmen: "fabrikam.com". Alternativ können Sie Platzhalterzeichen zum Berücksichtigen mehrerer Domänen verwenden: "*.fabrikam.com". Sie können einem einzelnen Filter mehrere Domänen hinzufügen. |
Uri |
Optional |
PS-Listenmodifizierer |
Auflistung der URIs, die in den Filter einbezogen werden sollen. (Der URI ist der Teil "Benutzer@Host" einer SIP-Adresse.) Ein URI kann ein beliebiges der folgenden Muster aufweisen: user@fabrikam.com user@* *@fabrikam.com Sie können mehrere URIs in einen einzigen Filter aufnehmen. |
Eingabetypen
Keine. New-CsDiagnosticsFilter akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsDiagnosticsFilter werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Die Befehle in Beispiel 1 verwenden New-CsDiagnosticsFilter zum Erstellen eines neuen Diagnosefilters und zum Zuweisen des Filters zu den globalen Diagnosekonfigurationseinstellungen. Hierzu ruft der erste Befehl New-CsDiagnosticsFilter auf, um einen nur im Arbeitsspeicher vorhandenen Diagnosefilter zu erstellen. Dieser Filter fügt dem Filter den FQDN "fabrikam.com" und den URI "user@fabrikam.com" hinzu. Der Befehl legt außerdem die Eigenschaft "Enabled" auf "True" ($True) fest, um den Filter zu aktivieren. Der resultierende virtuelle Filter wird anschließend in der Variablen "$x" gespeichert.
Im zweiten Befehl wird Set-CsDiagnosticConfiguration zum Zuweisen des neuen FIlters zu den globalen Diagnosekonfigurationseinstellungen verwendet. In diesem Fall werden alle vorhandenen Werte in der Filtereigenschaft durch den neu erstellten, in $x gespeicherten, Filter ersetzt.
-------------------------- Beispiel 2 --------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com","contoso.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Die Befehle in Beispiel 2 sind Varianten der Befehle in Beispiel 1; in Beispiel 2 werden der Eigenschaft "Fqdn" des Filters jedoch zwei FQDNs hinzugefügt: "fabrikam.com" und "contoso.com". Hierzu werden beide Namen durch Komma getrennt als Parameterwerte für den Parameter "Fqdn" verwendet.