Profilschemareferenzen in SharePoint Server

GILT FÜR: yes-img-13 2013 yes-img-16 2016 yes-img-19 2019 yes-img-se Subscription Edition no-img-sop SharePoint in Microsoft 365

Beim Ausführen der des Microsoft PowerShell- Skripts BackupMonitoringSettings.ps1 auf einer SharePoint-Farm erstellen Sie eine Datei mit dem Namen „Profil". Das Profil folgt einem XML-Schema. Sie können die Einstellungen der Elemente des Schemas zum Erstellen eines benutzerdefinierten Profils ändern. Sie können das benutzerdefinierte Profil dann verwenden, um die Konfiguration der Überwachungseinstellungen in einer SharePoint-Umgebung zu automatisieren. Eine Einführung in die skriptgesteuerte Überwachungskonfiguration finden Sie unter Übersicht der Skriptüberwachungskonfiguration in SharePoint Server.

Administratoren können die Skripts vor, während und nach Änderungen an der Farm wie z. B. Farmtopologie, größere Sicherheitsänderungen, Anwendung von Softwareupdates Ausführung eines Leistungstest durchführen. Die Skripts ändern die Überwachungseinstellungen so, dass alle erforderlichen Überwachungsdaten während des Ereignisses gesammelt werden, ohne dass die Protokollierungsdatenbank während des normalen Betriebs überflutet wird.

Hinweis

[!HINWEIS] Zum Sichern, Wiederherstellen und Ändern der Farmüberwachungseinstellungen müssen Sie die PowerShell-Skripts herunterladen. Die Skripts sind im TechNet-Katalog unter Scripted Monitoring Configuration – BackupMonitoringSettings und Scripted Monitoring Configuration – AlterMonitoringSettings verfügbar. Das PowerShell-Skript BackupMonitoringSettings.ps1 erstellt die Sicherungskopie des Profils, auf deren Basis Sie andere Profile erstellen können.

Sie können mindestens ein Profil zum Anpassen der Ebene der Überwachung in verschiedenen Phasen des SharePoint-Lebenszyklus erstellen. Sie können auch ein benutzerdefiniertes Profil verwenden, um die Konfiguration der Überwachung auf mehrere Farmen gleichzeitig vorzunehmen.

In der Regel werden Profile für folgende Zwecke erstellt:

Zum Abschließen der Konfiguration der Überwachungseinstellungen für eine Farm nach der Installation von SharePoint Server
Zum Ändern der Überwachungseinstellungen für eine Farm unmittelbar vor einer administrativen Änderung wie z. B. der Änderung der Einstellungen einer Suchdienstanwendung in der Farm

Als Ergebnis können Sie die Überwachungsdaten in Bezug auf die Änderung aufzeichnen und unerwünschte Überwachungsdaten unterdrücken. Nach Abschluss der Änderungen können Sie die Überwachungseinstellungen auf die ursprünglichen Werte zurücksetzen.
Zum Wiederherstellen der Überwachungseinstellungen für eine Farm nach einer administrativen Änderung
Zum Wiederherstellen eines vorherigen Satzes von Überwachungseinstellungen für eine Farm

Dies ist sinnvoll, wenn Sie manuelle Anpassungen an den Einstellungen vornehmen und sich dann entscheiden, dass Sie die vorherigen Einstellungen wiederherstellen möchten.
Zum Wiederherstellen der Standardeinstellungen
Zum Erstellen eines Profils, das Sie auf mehrere Farmen anwenden können

Sichern der ursprünglichen Einstellungen

Sie sollten die Standardüberwachungseinstellungen immer sichern, bevor Sie eine Änderung daran vornehmen. Auf diese Weise können Sie diese Einstellungen bei Bedarf wiederherstellen. Die Sicherung des Profils kann auch als Ausgangspunkt für andere Profile dienen, die Sie erstellen möchten. Weitere Informationen zum Sichern der Einstellungen finden Sie unter Ausführen der Skriptüberwachungskonfiguration in SharePoint Server.

Grundlegendes zum Profilschema

Beim Ausführen des PowerShell-Skripts BackupMonitoringSettings.ps1 auf einer SharePoint-Farm erstellen Sie eine Datei mit dem Namen „Profil", die dem folgenden XML-Schema entspricht. Die Elemente der Datei enthalten die zugeordneten Überwachungseinstellungen aus der Farm.

<?xml version="1.0" standalone="yes"?>
<Configuration>
  <FarmDiagnosticConfig />
  <UsageServices>
    <UsageService />  
  </UsageServices>
  <UsageDefinitions>
    <UsageDefinition />
  </UsageDefinitions>
  <LogLevels>
    <LogLevel />
  </LogLevels>
  <TimerJobs>
    <TimerJob />
  </TimerJobs>
  <HealthAnalyzerRules>
    <HealthAnalyzerRule />
  </HealthAnalyzerRules>
</Configuration>

Wichtig

[!WICHTIGER HINWEIS] In den Feldern, die in den folgenden Tabellen als schreibgeschützt markiert sind, können Sie die Werte nicht anpassen. Wenn Sie Werte in schreibgeschützten Feldern Ihres Profils geändert haben, können unerwartete Ergebnisse auftreten.

Einstellungen für das Element FarmDiagnosticConfig

Name	Werttyp	Hinweise
AllowLegacyTraceProviders	Boolescher Wert	Gibt an, dass für frühere Versionen von SharePoint-Produkten und -Technologien erstellte Ablaufverfolgungsanbieter in die Ablaufverfolgungssitzung für SharePoint Server schreiben können.
AppAnalyticsAutomaticUploadEnabled	Boolescher Wert	Gibt an, ob aggregierte Daten zur App-Verwendung automatisch für Microsoft hochgeladen werden.
CustomerExperienceImprovementProgramEnabled	Boolescher Wert	Legt fest, ob eine Verwaltungsgruppe die Funktion für das Programm zur Verbesserung der Benutzerfreundlichkeit aktiviert hat.
ErrorReportingEnabled	Boolescher Wert	Ruft einen Wert ab, der angibt, ob die Sammlung von Absturzdaten und Fehlerberichte aktiviert sind, oder legt den Wert fest.
ErrorReportingAutomaticUploadEnabled	Boolescher Wert	Gibt an, ob die Teilnahme am Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Program, CEIP) aktiviert ist. The CEIP is designed to improve the quality, reliability, and performance of Microsoft products and technologies. Mit Ihrer Erlaubnis werden anonyme Informationen zu Ihrem Server an Microsoft gesendet, um SharePoint Server zu verbessern.
DownloadErrorReportingUpdatesEnabled	Boolescher Wert	Gibt an, ob Fehlerberichte automatisch zu Microsoft hochgeladen werden. Dazu gehören die folgenden Informationen: Informationen zum Status des Servers, wenn ein Problem auftritt, zur verwendeten Betriebssystemversion und Computerhardware sowie zur digitalen Produkt-ID, die zur Identifizierung Ihrer Lizenz verwendet werden kann. Hinweis: Die IP-Adresse des Computers wird auch gesendet, da Sie sich für das Übermitteln von Fehlerberichten mit einem Onlinedienst verbinden. Allerdings wird die IP-Adresse nur dazu verwendet, Gesamtstatistiken zu generieren.
DaysToKeepLogs	Ganze Zahl	Gibt an, wie viele Tage Ablaufverfolgungs-Protokolldateien gespeichert werden sollen. Der Typ muss eine gültige Zahl zwischen 1 und 366 sein. Die Standardeinstellung beträgt 14 Tage.
LogMaxDiskSpaceUsageEnabled	Boolescher Wert	Gibt an, ob der maximal für Ablaufverfolgungs-Protokolldateien verwendete Speicherplatz eingeschränkt wird.
LogDiskSpaceUsageGB	Ganze Zahl	Gibt den maximal für Ablaufverfolgungs-Protokolldateien verwendeten Speicherplatz in Gigabyte (GB) an. Der Standardwert ist 1000 und wird nur wirksam, wenn der LogMaxDiskSpaceusageEnabled-Parameter auf True festgelegt ist. Der Typ muss eine gültige Zahl zwischen 1 und 1000 sein.
LogLocation	String:Path	Dies ist der vollständige Pfad zu dem Speicherort, in dem die Protokolldateien gespeichert werden sollen. Es kann ein Remotespeicherort sein. Beispiel: "%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\16\LOGS" und "%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\LOGS"
LogCutInterval	Ganze Zahl	Gibt einen Zeitraum für den Rollover zur nächsten Protokolldatei an. Der Typ muss eine gültige Zahl zwischen 0 und 1440 sein.
EventLogFloodProtectionEnabled	Boolescher Wert	Gibt an, ob das Feature Ereignisprotokoll-Flutschutz aktiviert ist. Wenn mehrere ähnliche Ereignisse in das Ereignisprotokoll geschrieben werden, werden einige doppelt vorkommende Meldungen unterdrückt. Nach einer gewissen Zeit gibt eine Zusammenfassungsmeldung an, wie viele Ereignisse unterdrückt wurden.
EventLogFloodProtectionThreshold	Ganze Zahl	Gibt an, wie viele Ereignisse in einem bestimmten Zeitrahmen zulässig sind, bevor ein Ereignis als Ursache für eine Überflutung des Ereignisprotokolls erachtet wird. Der ganzzahlige Bereich liegt zwischen 1 und 100. Der Standardwert ist 5.
EventLogFloodProtectionTriggerPeriod	Ganze Zahl	Gibt den Zeitrahmen in Minuten an, während dessen die Überwachung auf möglicherweise eine Überflutung auslösende Ereignisse erfolgen soll. Der ganzzahlige Bereich liegt zwischen 1 und 1440. Der Standardwert lautet 2.
EventLogFloodProtectionQuietPeriod	Ganze Zahl	Gibt an, wie viel Zeit (in Minuten) ohne das Auslösen eines Ereignisses vergehen muss, damit der Flutschutz beendet werden kann. Der ganzzahlige Bereich liegt zwischen 1 und 1440. Der Standardwert lautet 2.
EventLogFloodProtectionNotifyInterval	Ganze Zahl	Gibt an, wie häufig (in Minuten) ein Zusammenfassungsereignis mit der Angabe geschrieben wird, wie viele Ereignisse aufgrund des Flutschutzes unterdrückt wurden. Der ganzzahlige Bereich liegt zwischen 1 und 1440. Der Standardwert ist 5.
ScriptErrorReportingEnabled	Boolescher Wert	Aktiviert oder deaktiviert die Berichterstellung für Skriptfehler in der Protokolldatei.
ScriptErrorReportingRequireAuth	Boolescher Wert	Gibt an, ob für die Erstellung von Skriptfehlerberichten eine Authentifizierung erforderlich ist.
ScriptErrorReportingDelay	Ganze Zahl	Gibt die Zeit zwischen Skriptfehlerberichten (in Minuten) an. Der Wert muss eine gültige ganze Zahl zwischen 0 und 1440 sein. Der Wert wird in Minuten angegeben. Der Standardwert ist 30.

Verwenden Sie die folgende Tabelle für die UsageServices-Einstellungen.

Elemente für die UsageServices-Einstellungen

Name	Werttyp	Hinweise
ID	GUID: Schreibgeschützt	GUID im Format „12345678-90ab-cdef-1234-567890bcdefgh“.
UsageLogLocation	Pfad	Gibt den Pfad auf jedem Computer in der Farm an, in dem Verwendungsprotokolldateien erstellt werden. Derselbe Pfad muss auf allen Computern in der Farm vorhanden sein.
LoggingEnabled	Boolescher Wert	Gibt an, dass Verwendungsdaten in Verwendungsdateien protokolliert werden.
UsageLogMaxFileSizeKB	Ganze Zahl	Gibt die Maximalgröße einer einzelnen Verwendungsdatei an, die für alle Verwendungsanbieter gilt. Der Mindestwert ist 512 Kilobyte (KB), und der Maximalwert ist 65.536 KB.
UsageLogCutTime	Ganze Zahl	Gibt die Zeitspanne in Minuten an, für die Verwendungsdaten pro Verwendungsprotokolldatei erfasst werden. Der Standardwert ist 5 Minuten. Der Wert muss eine ganze Zahl im Bereich von 1 bis 1440 sein.

Verwenden Sie die folgende Tabelle für die UsageDefinition-Einstellungen.

Elemente für die UsageDefinition-Einstellungen

Name	Werttyp	Hinweise
ID	GUID: Schreibgeschützt	GUID im Format „12345678-90ab-cdef-1234-567890bcdefgh“.
Name	String: Schreibgeschützt	Der Name der Zeichenfolge der UsageDefinition.
DaysRetained	Ganze Zahl	Gibt die Anzahl von Tagen an, die Verwendungsdaten für den Verwendungsanbieter in der Verwendungsdienstdatenbank aufbewahrt werden sollen. Der Standardwert lautet 14. Der Typ muss eine ganze Zahl zwischen 0 und 31 sein.
DaysToKeepUsageFiles	Ganze Zahl	Gibt an, wie viele Tage die Verwendungsdateien aufbewahrt werden sollen. Der Wert muss dem Wert des DaysRetained-Parameters entsprechen oder kleiner sein.
Aktiviert	Boolescher Wert	Aktiviert oder deaktiviert den angegebenen Nutzungsanbieter.

Verwenden Sie die folgende Tabelle für die LogLevel-Einstellungen.

Elemente der LogLevel-Einstellungen

Name	Werttyp	Hinweise
Bereich	String: Schreibgeschützt	Komponente oder Dienst, für die/den das LogLevel gilt.
Identität	String: Schreibgeschützt	Gibt die Namen der Kategorie oder Gruppe von Kategorien an, die gedrosselt werden soll. Beispiel: „Vereinheitlichter Protokollierungsdienst“. Hinweis: Wenn der Identitätsparameter nicht angegeben ist, wird die Drosselung auf alle Kategorien in der Farm angewendet.
EventSeverity	String:[None \| ErrorCritical \|Error \| Warning \|Information \| Verbose]	Gibt die festzulegende Kategorieebene an. Die Kategorieebene ist einer der folgenden Werte: [None \| ErrorCritical \|Error \| Warning \|Information \| Verbose]
TraceSeverity	String:[None \| Unexpected \|Monitorable \| High \|Medium \| Verbose \| VerboseX]	Gibt Ablaufverfolgungsdrosselung an, auf die die angegebenen Kategorien festgelegt werden sollen. Die Ablaufprotokollierungsdateien sind Textdateien, die in den Ablaufprotokollierungspfad geschrieben werden, der auf der Seite „Diagnoseprotokollierungseinstellungen auf der die Website für die SharePoint-Zentraladministrationfestgelegt wird. Bei dem Typ muss es sich um einen beliebigen der folgenden Werte handeln: [None \| Unexpected \|Monitorable \| High \|Medium \| Verbose \| VerboseX]

Verwenden Sie die folgende Tabelle für die TimerJob-Einstellungen.

Elemente der TimerJob-Einstellungen

Name	Werttyp	Hinweise
Identität	GUID: Schreibgeschützt	Gibt den zu aktualisierenden Zeitgeberauftrag an. Der Typ muss eine gültige GUID im Format „12345678-90ab-cdef-1234-567890bcdefgh" sein.
Zeitplan	String	Gibt den Zeitplan für die Ausführung des Zeitgeberauftrags an. Der Typ muss ein gültiger SharePoint-Zeitgeberdienstzeitplan (SPTimer) in Form eines der folgenden Zeitpläne sein: Alle 5 Minuten zwischen 0 und 59, Stündlich zwischen 0 und 59, Täglich um 15:00:00, Wöchentlich zwischen Fr 22:00:00 und So 06:00:00, Monatlich um 15:00:00 Uhr und jährlich am 1. Januar 15:00:00 Uhr
Aktiviert	Boolescher Wert	Aktiviert oder deaktiviert den Zeitgeberauftrag.

Verwenden Sie die folgende Tabelle für die HealthAnalyzerRule-Einstellungen.

Elemente der HealthAnalyzerRule-Einstellungen

Name	Werttyp	Hinweise
Identität	GUID: Schreibgeschützt	Gibt den Namen oder die GUID der festzulegenden Integritätsanalyseregel an.
Aktiviert	Boolescher Wert	Aktiviert oder deaktiviert die Regel für die Integritätsanalyse.

Erstellen von Profilen

Sie können eine unbegrenzte Anzahl von Profilen erstellen. Jedes Profil kann für einen anderen Zweck verwendet werden, z. B. zum Erhöhen der Überwachungsebene vor einer bestimmten Änderung an der Umgebung oder zum Verringern nach einer Änderung.

Sie müssen lediglich Profileinträge für die speziellen Änderungen erstellen, die Sie vornehmen möchten. Die anderen Einstellungen bleiben unverändert. Wenn Sie z. B. ein paar LogLevel-Einstellungen ändern möchten, müssen Sie nur diese Einstellungen im Profil angeben. Einstellungen, die nicht im Profil angegeben sind, werden nicht geändert.

Möglicherweise sollten Sie eine Benennungskonvention für Ihre Profile verwenden, damit Sie sie ordnen und einfacher darauf zugreifen können.

Wichtig

[!WICHTIGER HINWEIS] Sichern Sie die Überwachungseinstellungen immer, bevor Sie eine Änderung daran vornehmen. Arbeiten Sie immer in einer Kopie der Sicherungskopie des Profils und nie in der ursprünglichen Sicherungsdatei selbst.

Siehe auch

Konzepte

Übersicht der Skriptüberwachungskonfiguration in SharePoint Server

Ausführen der Skriptüberwachungskonfiguration in SharePoint Server

Last updated on 2023-03-08