Verwenden der Protokollierung administrativer Aktionen in SharePoint 2016
**Gilt für:**SharePoint Server 2016
**Letztes Änderungsdatum des Themas:**2016-11-07
Das Feature der Protokollierung von Verwaltungsaktionen ist in Öffentliches Update für SharePoint Server 2016 (Feature Pack 1), November 2016 enthalten. Dieses Feature ermöglicht die Protokollierung von SharePoint Server 2016-Verwaltungsaktionen.
Übersicht
Administrative Änderungen an SharePoint Server-Einstellungen können manchmal Fehler verursachen oder unerwünschte Auswirkungen haben. Zur Unterstützung bei der Problembehandlung administrativer Änderungen ist die Protokollierung wichtiger Verwaltungsaktionen in SharePoint in Feature Pack 1 verfügbar. Die Protokollierung ist sowohl für Aktionen in der Zentraladministration als auch für Windows PowerShell-Aktionen verfügbar.
Aktivieren der Protokollierung von Verwaltungsaktionen
Die Protokollierung von Verwaltungsaktionen wird bei der Installation von SharePoint Server 2016 Öffentliches Update für SharePoint Server 2016 (Feature Pack 1), November 2016 standardmäßig aktiviert.
Nach der Installation von Feature Pack 1 werden Verwaltungsaktionen als aktivierte Option unter „Zu protokollierende Ereignisse“ auf der Seite Konfigurieren der Sammlung von Integritäts- und Verwendungsdaten der SharePoint 2016-Zentraladministration angezeigt.
Suchen des lokalen Speicherorts der Protokolldatei der Verwaltungsaktionen
Protokolldateien für Verwaltungsaktionen werden auf dem Server gespeichert. So zeigen Sie den lokalen Speicherort dieser Protokolle an:
Klicken Sie auf der Homepage der SharePoint 2016-Zentraladministration auf Überwachung.
Klicken Sie im Abschnitt „Berichterstellung“ auf Konfigurieren der Sammlung von Integritäts- und Verwendungsdaten.
Der lokale Speicherort der Protokolldatei ist unter Verwendungsdatensammlung aufgeführt.
Suchen der Protokolldateien der Verwendungsdatenbank für Verwaltungsaktionen
Die Protokolle der Verwaltungsaktionen werden in die SharePoint-Verwendungsdatenbank geschrieben. So suchen Sie den Datenbankserver für die Protokollierung:
Klicken Sie auf der Homepage der SharePoint 2016-Zentraladministration auf Überwachung.
Klicken Sie im Abschnitt „Berichterstellung“ auf Konfigurieren der Sammlung von Integritäts- und Verwendungsdaten.
Der Datenbankserver und der Datenbankname für die Protokollierung ist zu finden unter: Protokollierungsdatenbankserver-Einstellungen.
Abrufen von Protokollen aus der SharePoint-Verwendungsdatenbank
Die Protokolle der Verwaltungsaktionen werden maximal 31 Tage in der SharePoint-Verwendungsdatenbank gespeichert.
Öffnen Sie Microsoft SQL Server Management Studio. Hinweis: Sie müssen als Administrator angemeldet sein.
Stellen Sie in den Protokollierungsdatenbankserver-Einstellungen eine Verbindung mit dem als „Datenbankserver“ angegebenen Servernamen her.
Stellen Sie eine Verbindung mit der zutreffenden Protokollierungsdatenbank her. Dies ist die Datenbank, die Sie in den Protokollierungsdatenbankserver-Einstellungen als „Datenbankname“ festgelegt haben, in der Regel „WSS_Logging“.
Fragen Sie die Partitionen „AdministrativeActions“ ab.
Hinweis
Wählen Sie die Anzahl der zutreffenden „AdministrativeActions“-Partitionen aus. Es sollten 32 Partitionen (0 bis 31) erstellt worden sein. „WSS_logging“ ist der Standardname der Protokollierungsdatenbank. Ändern Sie die Abfrage, wenn Sie einen anderen Namen für die Protokollierungsdatenbank haben.
Beispielabfrage
SELECT TOP 1000 [PartitionId]
,[RowId]
,[LogTime]
,[MachineName]
,[FarmId]
,[SiteSubscriptionId]
,[UserLogin]
,[CorrelationId]
,[Action]
,[Target]
,[Details]
,[RowCreatedTime]
FROM (
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition0]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition1]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition2]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition3]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition4]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition5]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition6]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition7]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition8]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition9]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition10]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition11]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition12]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition13]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition14]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition15]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition16]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition17]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition18]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition19]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition20]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition21]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition22]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition23]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition24]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition25]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition26]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition27]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition28]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition29]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition30]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition31]
) as A
Verwenden von Windows PowerShell zum Abrufen von Protokollen
Sie können Protokolle für Verwaltungsaktionen auch mithilfe des Windows PowerShell-Cmdlets Merge-SPUsageLog abrufen.
Wichtig
Um Merge-SPUsageLog verwenden zu können, muss die Remoteausführung von Cmdlets aktiviert sein. Informationen zum Konfigurieren des Computers zum Empfangen von Remotebefehlen finden Sie unter Enable-PSRemoting.
Das Cmdlet Merge-SPUsageLog erfasst, filtert und aggregiert Protokolle basierend auf von Ihnen angegebenen Kriterien, die Sie mit den Parametern „StartTime“ und „EndTime“ filtern sollten, um die Leistung dieses Cmdlet zu optimieren.
Merge-SPUsageLog generiert Objekte in der PowerShell-Pipeline aus Protokollen, die die Kriterien erfüllen. Geben Sie mindestens einen Verwendungstyp an, z. B. „Verwaltungsaktionen“.
Merge-SPUsageLog -Identity <SPUsageDefinitionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-DiagnosticLogPath <String>] [-EndTime <DateTime>] [-OverWrite <SwitchParameter>] [-Servers <String[]>] [-StartTime <DateTime>]
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identität |
Erforderlich |
Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind |
Gibt den Namen der Verwendungsprotokolldatei an. |
AssignmentCollection |
Optional |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird. Hinweis Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden. |
DiagnosticLogPath |
Optional |
System.String |
Gibt die Datei zum Schreiben von Diagnoseinformationen an. Ein relativer Pfad wird unterstützt. |
EndTime |
Optional |
System.DateTime |
Gibt die Endzeit der zurückgegebenen Protokolleinträge zurück. Bei dem Typ muss es sich um ein gültiges Format für Datum/Uhrzeit handeln, das für die Verwaltungssprache kulturspezifisch ist, z. B. 2/16/2007 12:15:12 für Englisch (USA). Der Standardwert ist die aktuelle Uhrzeit. Wenn Sie die UTC-Zeit angeben möchten, müssen Sie ein „Z“ am Ende des Parameters hinzufügen. Beispiel: „2016-06-15 03:29:18.199 Z“. Wenn das „Z“ nicht angeben ist, wird statt der UTC-Zeit die lokale Uhrzeit des Computers angezeigt. |
OverWrite |
Optional |
System.Management.Automation.SwitchParameter |
Überschreibt die Diagnoseprotokolldatei, wenn sie bereits unter dem angegebenen Pfad vorhanden ist. |
Server |
Optional |
System.String[] |
Die Serveradressen, nach denen gefiltert wird. Zum Abrufen einer Liste gültiger Adressen in der Farm verwenden Sie „ Get-SPServer | Select Address“. |
StartTime |
Optional |
System.DateTime |
Gibt die Startzeit der zurückgegebenen Protokolleinträge zurück. Bei dem Typ muss es sich um ein gültiges Format für Datum/Uhrzeit handeln, das für die Verwaltungssprache kulturspezifisch ist, z. B. „2/16/2007 12:15:12“ für Englisch (USA). Im Standardwert ist dies eine Stunde vor der aktuellen Zeit auf dem lokalen Computer. Wenn Sie die UTC-Zeit angeben möchten, müssen Sie ein „Z“ am Ende des Parameters hinzufügen. Beispiel: „2016-06-15 03:29:18.199 Z“. Wenn das „Z“ nicht angeben ist, wird statt der UTC-Zeit die lokale Uhrzeit des Computers angezeigt. |
**Beispiel 1:**In diesem Beispiel wird die letzte Stunde der Protokolldaten für den Verwendungsanbieter „Verwaltungsaktionen“ aus allen Farmcomputern zusammengeführt.
Merge-SPUsageLog -Identity "Administrative Actions"
Beispiel 2: Dieses Beispiel führt die Protokolleinträge für den Verwendungsanbieter „Verwaltungsaktionen“ von „06/09/2016 16:00“ bis jetzt von Servern mit dem Namen „A-0606“ und „A-0505“ zusammen.
Merge-SPUsageLog -Identity "Administrative Actions" -Servers "A-0606","A-0505" -StartTime "06/09/2008 16:00"
**Beispiel 3:**In diesem Beispiel werden Verwaltungsaktionsprotokolle vom 11. August abgerufen und dann folgende Felder für die Anzeige ausgewählt: Benutzer, ActionName und TimeStamp. Die Ergebnisse werden nach TimeStamp sortiert. In diesem Beispiel wird die Windows PowerShell-Pipeline verwendet. Weitere Informationen zum Verwenden der Pipeline finden Sie unter „ about_Pipelines“.
Get-SPUsageDefinition -Identity "Administrative Actions" | Merge-SPUsagelog -StartTime "08/11/2016 3:50 AM" | Select User, ActionName, Timestamp | Sort Timestamp
Typen protokollierter Verwaltungsaktionen
In den folgenden Tabellen sind die Typen von Verwaltungsaktionen aufgeführt, die in den Protokollen erfasst werden.
Aktionskategorie | Aktionsunterkategorie | Protokollaktion(en) | Beschreibung |
---|---|---|---|
Konfigurieren von Konten |
Hinzufügen, Entfernen, Aktualisieren |
Administration.Security.User.Add |
Protokolliert Konfigurations- und Informationsänderungen des Administratorkontos, einschließlich des Hinzufügens, Entfernens und Aktualisierens von Farm- und Websitesammlungsadministratoren. Protokolliert auch Rollenaktualisierungen. |
Konfigurieren verwalteter Konten |
Neu, Entfernen, Aktualisieren |
Administration.Security.ManagedAccount.New Administration.Security.ManagedAccount.Remove Administration.Security.ManagedAccount.Update |
Protokolliert Änderungen in der Konfiguration verwalteter Konten, das Erstellen und Entfernen verwalteter Konten sowie Aktualisierungen an vorhandenen verwalteten Konten. |
Konfigurieren des Dienstkontos |
Aktualisieren |
Administration.Security.ServiceAccount.Update |
Protokolliert Updates an den festgelegten Dienstkonten in der Farm. |
Konfigurieren von Kennwortänderungseinstellungen |
Aktualisieren |
Administration.Security.AccountPasswordSetting.Update |
Protokolliert Aktualisierungen an Kennwortänderungseinstellungen. |
Angeben von Authentifizierungsanbietern |
Aktualisieren |
Administration.Security.AuthenticationProviderSetting.Update |
Protokolliert Aktualisierungen an Authentifizierungsanbietereinstellungen. |
Verwalten von Vertrauensstellungen |
Bearbeiten, Entfernen, Aktualisieren |
Administration.Security.ManageTrust.SPTrustedRootAuthority.Edit Administration.Security.ManageTrust.SPTrustedRootAuthority.New Administration.Security.ManageTrust.SPTrustedRootAuthority.Remove Administration.Security.ManageTrust.SPTrustedSecurityTokenIssuer.Edit Administration.Security.ManageTrust.SPTrustedSecurityTokenIssuer.New Administration.Security.ManageTrust.SPTrustedSecurityTokenIssuer.Remove |
Administration.Security.ManageTrust.SPTrustedRootAuthority protokolliert das Bearbeiten von und das Entfernen der Vertrauensstellungseinstellungen in der Farm sowie das Erstellen neuer Vertrauensstellungen. Administration.Security.ManageTrust.SPTrustedRootAuthority protokolliert das Bearbeiten von und das Entfernen der Tokenausstellungseinstellungen sowie das Erstellen neuer Vertrauensstellungen von Tokenausstellern. |
Verwalten der Webpart-Sicherheit |
Aktualisieren |
Administration.Security.WebPart.Update |
Protokolliert Aktualisierungen an Webpartseiten und Webparts in Ihrer ausgewählten Webanwendung. |
Farmsicherung und Wiederherstellung |
Sichern, Wiederherstellen, Aktualisieren |
Administration.Farm.BackupRestore.Backup Administration.Farm.BackupRestore.Restore Administration.Farm.BackupRestore.Settings.Update |
Protokolliert Vorgänge zur Farmwiederherstellung- und sicherung, einschließlich Aktualisierungen an den standardmäßigen Sicherungs- und Wiederherstellungseigenschaften. |
Serververwaltung |
Hinzufügen, Entfernen, Aktualisieren |
Administration.Farm.Server.Add Administration.Farm.Server.Remove Administration.Farm.Server.Role.Update |
Protokolliert das Entfernen und Hinzufügen von Servern zur Farm, einschließlich Rollenaktualisierungen von Farmservern. |
Änderungen an der Konfigurationsdatenbank |
Neu, Entfernen |
Administration.Farm.ConfigurationDatabase.New Administration.Farm.ConfigurationDatabase.Remove |
Protokolliert das Hinzufügen der neuen Konfigurationsdatenbank oder das Entfernen einer vorhandenen Datenbank. |
Websitesammlungsverwaltung |
Hinzuzufügen, Sichern, Exportieren, Importieren, Entfernen, Wiederherstellen, Aktualisieren |
Administration.SiteCollection.Add Administration.SiteCollection.Remove Administration.SiteCollection.BackupRestore.Backup Administration.SiteCollection.BackupRestore.Restore Administration.SiteCollection.Owner.Update Administration.SiteCollection.SecondContact.Update Administration.SiteCollection.Quota.Update Administration.SiteCollection.ImportExport.Export Administration.SiteCollection.ImportExport.Import |
Protokolliert die häufigsten Vorgänge bei der Verwaltung der Websitesammlung, einschließlich des Hinzufügens und Entfernens einer Websitesammlung, der Sicherung und der Wiederherstellung einer Websitesammlung, Änderungen am Besitz, am sekundären Kontakt und am Kontingent sowie des Imports und Exports der Websitesammlung. |
Inhaltsdatenbank der Websitesammlung |
Hinzufügen, Neu, Entfernen, Festlegen |
Administration.ContentDatabase.Add Administration.ContentDatabase.New Administration.ContentDatabase.Remove Administration.ContentDatabase.Set |
Protokolliert allgemeine Vorgänge von SharePoint-Inhaltsdatenbanken, z. B.: Hinzufügen einer Inhaltsdatenbank zur Farm, Erstellen einer neuen Inhaltsdatenbank, Entfernen einer Inhaltsdatenbank und Festlegen der globalen Eigenschaften einer Inhaltsdatenbank. |
Kontingentänderungen |
Neu, Entfernen, Aktualisieren |
Administration.Quota.New Administration.Quota.Remove Administration.Quota.Update |
Protokolliert das Festlegen eines neuen Websitesammlungskontingent, das Aktualisieren eines vorhandenen Websitesammlungskontingents und das Entfernen eines Websitesammlungskontingents. |
Featureverwaltung |
Installieren, Deaktivieren, Deinstallieren, Aktivieren |
Administration.Feature.Disable Administration.Feature.Enable Administration.Feature.Install Administration.Feature.Uninstall |
Protokolliert Featureverwaltungsaktionen von Websitesammlungen zum Deaktivieren, Aktivieren, Installieren und Deinstallieren von Features. |
Webanwendungsverwaltung |
Bearbeiten, Neu, Entfernen |
Administration.WebApplication.Edit Administration.WebApplication.New Administration.WebApplication.Remove |
Protokolliert allgemeine Verwaltungsaktionen von Webanwendungen, einschließlich der Bearbeitung einer vorhandenen Webanwendung, das Erstellen einer neuen Webanwendung und das Entfernen einer vorhandenen Webanwendung. |
Benutzerrichtlinie für die Webanwendungsverwaltung |
Hinzufügen, Neu, Entfernen, Aktualisieren |
Administration.WebApplication.UserPolicy.Add Administration.WebApplication.UserPolicy.New Administration.WebApplication.UserPolicy.Remove Administration.WebApplication.UserPolicy.Update |
Protokolliert Vorgänge im Zusammenhang mit der Verwaltung von Benutzerberechtigungsrichtlinien von Webanwendungen einschließlich: Hinzufügen von Benutzern zu einer vorhandenen Webanwendungs-Benutzerrichtlinie, das Erstellen einer neuen Benutzerrichtlinie, das Entfernen von Benutzern aus einer vorhandenen Benutzerrichtlinie und das Vornehmen von Aktualisierungen an einer Benutzerberechtigungsrichtlinie. |
Dienstanwendung |
Bearbeiten, Neu, Entfernen |
Administration.ServiceApplication.Edit Administration.ServiceApplication.New Administration.ServiceApplication.Remove |
Protokolliert Bearbeitungen an Dienstanwendungen, das Erstellen einer neuen Dienstanwendung und das Entfernen einer vorhandenen Dienstanwendung. |
Verwalten der Formular- und Featurevorlage |
Konvertieren, Deaktivieren, Aktivieren, Installieren, Neu, Festlegen, Starten, Stoppen, Testen, Aktualisieren, Upgraden, Deinstallieren |
Administration.FormTemplate.Convert Administration.FormTemplate.Disable Administration.FormTemplate.Enable Administration.FormTemplate.Install Administration.FormTemplate.New Administration.FormTemplate.Set Administration.FormTemplate.Start Administration.FormTemplate.Stop Administration.FormTemplate.Update Administration.FormTemplate.Test Administration.FormTemplate.Upgrade Administration.FormTemplate.Uninstall Administration.Feature.FormTemplate.Install Administration.Feature.FormTemplate.Uninstall |
Protokolliert Operationen im Zusammenhang mit der Verwaltung von InfoPath-Vorlagen in Websitesammlungen, einschließlich: Vorlagenkonvertierung, Deaktivierung, Aktivierung, Installation, Erstellen einer neuen Vorlage, Festlegen einer Vorlage, Starten und Beenden von Vorlagen, Aktualisierungen, Testing, Upgrade und Deinstallieren einer Vorlage. |
Inhaltsdatenbank |
Hinzufügen, Neu, Entfernen, Festlegen |
Administration.ContentDatabase.Add Administration.ContentDatabase.New Administration.ContentDatabase.Remove Administration.ContentDatabase.Set |
|
Konfigurieren von Gruppen |
Hinzufügen, Entfernen, Aktualisieren |
Administration.Security.Group.Add Administration.Security.Group.Remove Administration.Security.Group.Update |
Protokolliert Aktionen im Zusammenhang mit dem Erstellen von Gruppen, dem Löschen und der Verwaltung, z. B.: Hinzufügen, Entfernen und Aktualisieren von Gruppen. |
Migration von Benutzer und Gruppen |
Verschieben |
Administration.Security.User.Move Administration.Security.Group.Move |
Protokolliert Aktivitäten bezüglich der Migration von Gruppen- und Benutzeranmeldungen. |