Verwalten der Konfiguration des computer-, standort- und globalen zentralisierten Protokollierungsdiensts in Lync Server 2013
Letzte Änderung: 04.02.2014
Der zentralisierte Protokollierungsdienst kann in einem Bereich ausgeführt werden, der einen einzelnen Computer, einen Computerpool, einen Standortbereich (also einen definierten Standort wie den Standort Redmond, der eine Sammlung von Computern und Pools in Ihrer Bereitstellung enthält) oder auf globaler Ebene (d. a. alle Computer und Pools in Ihrer Bereitstellung) umfasst.
Um den Bereich des zentralisierten Protokollierungsdiensts mithilfe der Lync Server-Verwaltungsshell zu konfigurieren, müssen Sie entweder Mitglied der rollenbasierten Zugriffssteuerungsgruppe "CsAdministrator" oder "CsServerAdministrator" oder einer benutzerdefinierten RBAC-Rolle sein, die eine dieser beiden Gruppen enthält. Um eine Liste aller RBAC-Rollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich aller benutzerdefinierten RBAC-Rollen, die Sie selbst erstellt haben), führen Sie den folgenden Befehl in der Lync Server-Verwaltungsshell oder in der Windows PowerShell Eingabeaufforderung aus:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Lync Server 2013 cmdlet>"}
Zum Beispiel:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}
Hinweis
Windows PowerShell bietet Ihnen weitere Optionen und zusätzliche Konfigurationsoptionen, die mithilfe von CLSController.exe nicht verfügbar sind. CLSController bietet eine schnelle, präzise Methode zum Ausführen von Befehlen, ist jedoch auf die für den CLSController verfügbaren Befehle beschränkt. Windows PowerShell ist nicht nur auf den Befehl beschränkt, der für den Befehlsprozessor des CLSControllers verfügbar ist, und bietet eine breitere Gruppe von Befehlen und einen umfangreicheren Satz von Optionen. Beispielsweise bietet CLSController.exe Ihnen eine Bereichsoptionen für –Computer und –Pools. Mit Windows PowerShell können Sie computer oder Pools in den meisten Befehlen angeben. Wenn Sie neue Szenarien definieren (CLSController hat eine begrenzte Anzahl von Szenarien, die nicht vom Benutzer geändert werden können), können Sie einen Standort oder einen globalen Bereich definieren. Dieses leistungsstarke Feature von Windows PowerShell ermöglicht es Ihnen, ein Szenario für einen Standort oder einen globalen Bereich zu definieren, die tatsächliche Protokollierung jedoch auf einen Computer oder Pool zu beschränken.
Es gibt grundlegende Unterschiede zwischen den Befehlszeilenbefehlen, die Sie in Windows PowerShell oder CLSController ausführen können. Windows PowerShell bietet eine umfangreiche Methode zum Konfigurieren und Definieren von Szenarien und zum sinnvollen Wiederverwenden dieser Szenarien für Ihre Problembehandlungsszenarien. Während der CLSController eine schnelle und effiziente Möglichkeit bietet, Befehle einzugeben und Ergebnisse zu erhalten, ist der Befehlssatz für den CLSController auf die begrenzte Anzahl der über die Befehlszeile verfügbaren Befehle beschränkt. Im Gegensatz zu den Windows PowerShell-Cmdlets kann CLSController keine neuen Szenarien definieren, den Bereich auf Standort- oder globaler Ebene verwalten und viele andere Einschränkungen eines endlichen Befehlssatzes, der nicht dynamisch konfiguriert werden kann. Während CLSController eine Möglichkeit zur schnellen Ausführung bietet, bietet Windows PowerShell eine Möglichkeit, die Funktionalität des zentralisierten Protokollierungsdiensts über das hinaus zu erweitern, was mit CLSController möglich ist.
Bei der Ausführung der Befehle Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging und Update-CsClsLogging kann mit dem Parameter „–Computers“ ein einzelner Computerbereich definiert werden. Der Parameter „–Computers“ akzeptiert eine kommagetrennte Liste vollqualifizierter Domänennamen (FQDNs) für den Zielcomputer.
Tipp
Sie können ebenso „–Pools“ angeben und eine kommagetrennte Liste mit Pools übergeben, in denen die Protokollierungsbefehle ausgeführt werden sollen.
Standort- und globale Bereiche werden in den Cmdlets "New-, Set-, and Remove- Centralized Logging Service" definiert. Die folgenden Beispiele zeigen, wie ein Standortbereich und ein globaler Bereich festgelegt werden.
Wichtig
Die angezeigten Befehle können Parameter und Konzepte enthalten, die in anderen Abschnitten behandelt werden. Die Beispielbefehle sollen die Verwendung des Parameters "–Identity " zum Definieren des Bereichs veranschaulichen, und die anderen Parameter werden zur Vollständigkeit und zum Angeben des Bereichs eingeschlossen. Ausführliche Informationen zu den Cmdlets "Set-CsClsConfiguration " finden Sie unter "Set-CsClsConfiguration " in der Betriebsdokumentation.
So rufen Sie die aktuelle Konfiguration des zentralisierten Protokollierungsdiensts ab
Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".
Geben Sie den folgenden Befehl an der Eingabeaufforderung ein:
Get-CsClsConfiguration
Verwenden Sie die Cmdlets New-CsClsConfiguration und Set-CsClsConfiguration, um eine neue Konfiguration zu erstellen oder eine vorhandene Konfiguration zu aktualisieren.
Wenn Sie Get-CsClsConfiguration ausführen, werden Informationen wie auf dem folgenden Screenshot angezeigt, auf dem die Bereitstellung aktuell die standardmäßige Global-Konfiguration hat, aber keine Standortkonfigurationen definiert sind:
.jpg "Beispielausgabe von Get-CsClsConfiguration.")
So rufen Sie die aktuelle Konfiguration des zentralisierten Protokollierungsdiensts aus dem lokalen Speicher des Computers ab
Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".
Geben Sie den folgenden Befehl an der Eingabeaufforderung ein:
Get-CsClsConfiguration -LocalStore
Wenn Sie das erste Beispiel verwenden, in dem Get-CsClsConfiguration keine Parameter angibt, verweist der Befehl auf den zentralen Verwaltungsspeicher für die Daten. Wenn Sie den Parameter "–LocalStore" angeben, verweist der Befehl auf den Lokalen Computerspeicher anstelle des zentralen Verwaltungsspeichers.
So rufen Sie eine Liste der aktuell definierten Szenarien ab
Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".
Geben Sie den folgenden Befehl an der Eingabeaufforderung ein:
Get-CsClsConfiguration -Identity <scope and name> | Select-Object -ExpandProperty ScenariosUm z. B. die für den globalen Bereich definierten Szenarien abzurufen:
Get-CsClsConfiguration -Identity "global" | Select-Object -ExpandProperty Scenarios
Das Cmdlet Get-CsClsConfiguration zeigt immer die Szenarien an, die Teil der Konfiguration eines vorgegebenen Bereichs sind. In den meisten Fällen werden nicht alle Szenarien angezeigt und es wird gekürzt. Der hier verwendete Befehl erstellt eine Liste aller Szenarien mit Teilinformationen darüber, welche Anbieter, Einstellungen und Flags verwendet werden.
So aktualisieren Sie einen globalen Bereich für den zentralisierten Protokollierungsdienst mithilfe von Windows PowerShell
Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".
Geben Sie den folgenden Befehl an der Eingabeaufforderung ein:
Set-CsClsConfiguration -Identity <scope> -EtlFileRolloverSizeMB <size for logging file in megabytes>Beispiel:
Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40
Der Befehl trägt dem CLSAgent auf allen Computern und in allen Pools der Bereitstellung auf, die Größe des Rollover-Werts für die Tracing-Datei auf 40 MB festzulegen. Dieser Befehl wirkt sich auf alle Computer und Pools an allen Standorten aus und ändert deren konfigurierten Rollover-Wert in 40 MB.
So aktualisieren Sie einen Websitebereich für den zentralisierten Protokollierungsdienst mithilfe von Windows PowerShell
Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".
Geben Sie den folgenden Befehl an der Eingabeaufforderung ein:
Set-CsClsConfiguration -Identity <scope/site name> -EtlFileRolloverSizeMB <size for logging file in megabytes> -EtlFileFolder <default location %TEMP%\Tracing>Beispiel:
Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40 -EtlFileFolder "C:\LogFiles\Tracing"Hinweis
Wie im Beispiel gezeigt ist der Standardspeicherort der Protokolldateien „%TEMP%\Tracing“. Da es jedoch der CLSAgent ist, der die Datei tatsächlich schreibt, und da der CSLAgent als Netzwerkdienst ausgeführt wird, wird die Variable %TEMP% zu „%WINDIR%\ServiceProfiles\NetworkService\AppData\Local“ erweitert.
Der Befehl trägt dem CLSAgent auf allen Computern und in allen Pools am Standort Redmond auf, die Größe des Rollover-Werts für die Tracing-Datei auf 40 MB festzulegen. Computer und Pools an anderen Standorten sind von dem Befehl nicht betroffen und verwenden weiterhin den aktuell konfigurierten Rollover-Wert für die Tracing-Datei – der entweder durch den Standardwert (20 MB) oder bei der Anmeldung definiert wird.
So erstellen Sie eine neue Konfiguration des zentralisierten Protokollierungsdiensts
Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".
Geben Sie den folgenden Befehl an der Eingabeaufforderung ein:
New-CsClsConfiguration -Identity <scope and name> [CsClsConfiguration options for this site]Hinweis
„New-CsClsConfiguration“ bietet Zugriff auf eine Vielzahl optionaler Konfigurationseinstellungen. Ausführliche Informationen zu den Konfigurationsoptionen finden Sie unter Get-CsClsConfiguration and Understanding Centralized Logging Service configuration settings in Lync Server 2013.
Wenn Sie z. B. eine neue Konfiguration erstellen möchten, die einen Netzwerkordner für Cachedateien, den Rollover-Zeitraum für die Protokolldateien und die Rollover-Größe für die Protokolldateien definiert, können Sie folgenden Befehl eingeben:
New-CsClsConfiguration -Identity "site:Redmond" -CacheFileNetworkFolder "\\fs01.contoso.net\filestore\logfiles" -EtlFileRolloverMinutes 120 -EtlFileRolloverSizeMB 40
Sie sollten die Erstellung neuer Konfigurationen und die Definition neuer Eigenschaften für den zentralisierten Protokollierungsdienst sorgfältig planen. Gehen Sie vorsichtig vor, wenn Sie Änderungen durchführen, und stellen Sie sicher, dass Ihnen die Auswirkungen auf die Möglichkeit, Problemszenarien richtig zu protokollieren, bewusst sind. Änderungen an der Konfiguration sollten Sie durchführen, um Ihre Möglichkeiten zur Verwaltung der Protokolle mit einer Größe und einem Rollover-Zeitraum so zu verbessern, dass Sie Probleme bei ihrem Auftreten lösen können.
So entfernen Sie eine vorhandene Konfiguration des zentralisierten Protokollierungsdiensts
Starten Sie die Lync Server-Verwaltungsshell: Klicken Sie auf "Start", dann auf "Alle Programme", dann auf "Microsoft Lync Server 2013" und dann auf "Lync Server-Verwaltungsshell".
Geben Sie den folgenden Befehl an der Eingabeaufforderung ein:
Remove-CsClsConfiguration -Identity <scope and name>Wenn Sie beispielsweise eine von Ihnen erstellte Konfiguration für den zentralisierten Protokollierungsdienst entfernen möchten, um die Rolloverzeit der Protokolldatei zu erhöhen, erhöhen Sie die Größe der Rolloverprotokolldatei, und legen Sie den Cachespeicherort der Protokolldatei wie folgt auf eine Netzwerkfreigabe fest:
Remove-CsClsConfiguration -Identity "site:Redmond"Hinweis
Dies ist die neue Konfiguration, die im Verfahren "So erstellen Sie eine neue Konfiguration des zentralisierten Protokollierungsdiensts" erstellt wurde.
Wenn Sie eine Konfiguration auf Standortebene löschen, verwendet der Standort anschließend die globalen Einstellungen.