Wiederherstellen von Anpassungen in SharePoint Server

Artikel
03/08/2023

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

Sie können alle an SharePoint Server vorgenommenen Anpassungen mithilfe der Zentraladministration oder von PowerShell wiederherstellen. Das dazu verwendete Wiederherstellungstool hängt von der Art der von Ihnen bereitgestellten Umgebung, Ihren Plananforderungen und den Vereinbarungen zum Servicelevel ab, die Sie mit Ihrer Organisation getroffen haben.

Bevor Sie beginnen:

Lesen Sie die folgenden Informationen, bevor Sie dieses Verfahren anwenden:

Es empfiehlt sich, sowohl für vertrauenswürdige Lösungen als auch für Sandkastenlösungen eine Sicherung der ursprünglichen WSP-Datei sowie eine Sicherung des Quellcodes aufzubewahren, der zum Erstellen der WSP-Datei verwendet wurde.

Wiederherstellen von Lösungspaketen in SharePoint Server

Welche Methode Sie zum Wiederherstellen von Lösungspaketen verwenden, hängt davon ab, ob die Anpassungen als vertrauenswürdige Lösungen oder als Sandkastenlösungen bereitgestellt wurden.

Vertrauenswürdige Lösungen sind Lösungen, die von Farmadministratoren bereitgestellt werden. Sie werden für die gesamte Farm bereitgestellt und können auf jeder Website innerhalb der Farm verwendet werden. Vertrauenswürdige Lösungen werden in der Konfigurationsdatenbank gespeichert. Vertrauenswürdige Lösungen werden gesichert, wenn eine Farm mithilfe der Sicherung von SharePoint Server gesichert wird, sie werden in reine Konfigurationssicherungen eingeschlossen und können auch als Gruppe oder einzeln gesichert werden. Sie sind in der Wiederherstellungshierarchie sichtbar.

Sandkastenlösungen sind Lösungen, die Websitesammlungsadministratoren für eine einzelne Websitesammlung bereitstellen können. Sandkastenlösungen werden in der Inhaltsdatenbank gespeichert, die der Websitesammlung zugeordnet ist, für die die Lösung bereitgestellt wird. Diese Lösungen werden in SharePoint Server-Farm-, Webanwendungs-, Inhaltsdatenbank- und Websitesammlungssicherungen einbezogen, sind jedoch in der Wiederherstellungshierarchie nicht sichtbar und können nicht ausgewählt oder einzeln wiederhergestellt werden.

So stellen Sie eine vertrauenswürdige Lösung mithilfe der Zentraladministration wieder her

Vergewissern Sie sich, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der SharePoint-Gruppe "Farmadministratoren" ist.
Starten Sie Zentraladministration.
Klicken Sie in Zentraladministration auf der Homepage im Abschnitt Sichern und Wiederherstellen auf Farm aus Sicherung wiederherstellen.
Wählen Sie auf der Seite Wiederherstellung von Sicherung - Schritt 1 von 3: Wiederherzustellende Sicherung auswählen in der Liste der Sicherungen den Sicherungsauftrag aus, der das Lösungspaket enthält, und klicken Sie dann auf Weiter. Sie können weitere Details zu jeder Sicherung anzeigen, indem Sie neben der fraglichen Sicherung auf das Pluszeichen (+) klicken.

Hinweis

Wenn der richtige Sicherungsauftrag nicht angezeigt wird, geben Sie im Textfeld Speicherort des Sicherungsverzeichnisses den UNC-Pfad (Universal Naming Convention) des richtigen Sicherungsordners ein, und klicken Sie dann auf Aktualisieren.
Aktivieren Sie auf der Seite Wiederherstellung von Sicherung - Schritt 2 von 3: Wiederherzustellende Komponente auswählen das Kontrollkästchen neben der Lösung, und klicken Sie dann auf Weiter.
Stellen Sie auf der Seite Wiederherstellung von Sicherung - Schritt 3 von 3: Wiederherstellungsoptionen auswählen im Abschnitt Komponente wiederherstellen sicher, dass Lösung in der Liste Folgende Komponente wiederherstellen angezeigt wird.

Stellen Sie im Abschnitt Nur Konfigurationseinstellungen wiederherstellen sicher, dass die Option Inhalt und Konfigurationseinstellungen ausgewählt ist.

Wählen Sie im Abschnitt Wiederherstellungsoptionen unter Wiederherstellungstyp die Option Gleiche Konfiguration aus. Es wird ein Dialogfeld angezeigt, in dem Sie aufgefordert werden, den Vorgang zu bestätigen. Klicken Sie auf OK.

Klicken Sie auf Wiederherstellung starten.
Sie können den allgemeinen Status aller Wiederherstellungsaufträge oben auf der Seite Status von Sicherungs- und Wiederherstellungsaufträgen im Abschnitt Bereitschaft anzeigen. Den Status des aktuellen Wiederherstellungsauftrags sehen Sie im unteren Bereich der Seite im Abschnitt Wiederherstellen. Die Statusseite wird alle 30 Sekunden automatisch aktualisiert. Durch Klicken auf Aktualisieren können die Statusangaben manuell aktualisiert werden. Sicherung und Wiederherstellung sind Timerdienstaufträge. Deshalb kann es ein paar Sekunden dauern, bis die Wiederherstellung gestartet wird.

Für den Fall, dass Fehler gemeldet werden, können Sie diese in der Spalte Fehlermeldung auf der Seite Status von Sicherungs- und Wiederherstellungsaufträgen überprüfen. Weitere Informationen finden Sie außerdem in der Datei Sprestore.log unter dem in Schritt 3 angegebenen UNC-Pfad.

So stellen Sie eine vertrauenswürdige Lösung mithilfe von PowerShell wieder her

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
  
  Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator die Berechtigung zur Verwendung von SharePoint Server-Cmdlets gewähren.
Hinweis

[!HINWEIS] Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie die SharePoint-Verwaltungsshell.
Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:
```
Restore-SPFarm -Directory <BackupFolder> -RestoreMethod Overwrite -BackupId <GUID> -Item <SolutionPath>
```
Wobei Folgendes gilt:
- <BackupFolder> ist der UNC-Pfad des Verzeichnisses, aus dem die Wiederherstellung erfolgen soll.
- <GUID> ist die GUID der Sicherung, auf deren Basis die Wiederherstellung erfolgen soll. Wenn Sie keine Sicherung angeben, wird die jüngste Sicherung verwendet.
- <SolutionPath> ist der Pfad der Lösung innerhalb der Sicherungsstruktur (normalerweise farm\solutions\ SolutionName).

Weitere Informationen finden Sie unter Restore-SPFarm.

Hinweis

[!HINWEIS] Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Wiederherstellen einer Sandkastenlösung

Es ist nicht möglich, nur Anpassungen wiederherzustellen, die als Sandkastenlösungen bereitgestellt wurden. Stattdessen müssen Sie die Farm, Webanwendung, Inhaltsdatenbank oder Websitesammlung wiederherstellen, der die Anpassung zugeordnet ist.

Wiederherstellen erstellter Websiteelemente in SharePoint Server

Sie können nicht nur erstellte Websiteelemente wiederherstellen. Stattdessen müssen Sie die Farm, Webanwendung oder Inhaltsdatenbank wiederherstellen, der das erstellte Websiteelement zugeordnet ist.

Wiederherstellen von Workflows in SharePoint

Workflows sind eine besondere Form von Anpassungen, die Sie wiederherstellen können. Stellen Sie sicher, dass Ihr Sicherungs- und Wiederherstellungsplan alle der folgenden Szenarien einschließt, die für die betreffende Umgebung zutreffen:

Deklarative Workflows, z. B. solche, die in SharePoint Designer erstellt werden, werden in der Inhaltsdatenbank für die Websitesammlung gespeichert, für die sie bereitgestellt werden. Durch das Wiederherstellen der Inhaltsdatenbank oder der Websitesammlung werden diese Workflows wiederhergestellt.
Benutzerdefinierte deklarative Workflowaktionen verfügen über Komponenten an den folgenden drei Speicherorten:
- Die Visual Studio 2013-Assemblys für die Aktionen werden im globalen Assemblycache (GAC) gespeichert.
- Die XML-Definitionsdateien (ACTIONS-Dateien) werden im Verzeichnis 16\TEMPLATE<LCID>\Workflow gespeichert.
- Ein XML-Eintrag, um die Aktion als autorisierten Typ zu kennzeichnen, wird in der Datei Web.config für die Webanwendungen gespeichert, in denen sie verwendet wird.
  
  Wenn die Farmworkflows benutzerdefinierte Aktionen verwenden, sollten Sie ein Dateiwiederherstellungssystem verwenden, um diese Dateien und XML-Einträge wiederherzustellen. Sie können die Dateien nach Bedarf nach der Wiederherstellung wieder anwenden.
Workflows, die von benutzerdefiniertem Code abhängen, beispielsweise Workflows, die unter Verwendung von Visual Studio 2013 erstellt werden, werden an zwei Orten gespeichert. Die Visual Studio 2013-Assemblys für den Workflow werden im GAC und die XML-Definitionsdateien im Featureverzeichnis gespeichert. Dies ist mit anderen SharePoint Server-Features wie Webparts und Ereignisempfängern identisch. Wenn der Workflow als Teil eines Lösungspakets installiert wurde, müssen Sie den Anweisungen zum Wiederherstellen von Lösungspaketen folgen.
Wenn Sie einen benutzerdefinierten Workflow erstellen, der mit einer Websitesammlung interagiert, die nicht mit der Websitesammlung identisch ist, in der der Workflow bereitgestellt wurde, müssen Sie beide Websitesammlungen wiederherstellen, um den Workflow wiederherzustellen. Das Wiederherstellen einer Farm reicht aus, um alle Websitesammlungen in der Farm sowie alle Workflows, die ihnen zugeordnet sind, wiederherzustellen.
Nicht bereitgestellte Workflows müssen separat mithilfe einer Dateisystem-Sicherungsanwendung wiederhergestellt werden.

Wiederherstellen von Änderungen an der Datei "Web.config" in SharePoint Server

Sie können Änderungen, die Sie an der Datei "Web.config" vorgenommen haben, mithilfe der Zentraladministration oder der SharePoint Server-APIs und dem Objektmodell wiederherstellen, indem Sie eine Farm- oder ein reine Konfigurationswiederherstellung durchführen.

Sie sollten mithilfe einer Dateisystemsicherung Änderungen an der Datei Web.config schützen, die nicht mit der Zentraladministration oder mit den SharePoint-APIs und dem Objektmodell vorgenommen werden. Die Sicherung kann mit einer Dateisystemwiederherstellung wiederhergestellt werden.

Wiederherstellen entwickelter Anpassungen in SharePoint Server, die nicht als Lösungen gepackt wurden

Das Wiederherstellen entwickelter Anpassungen , die nicht als Lösung gepackt wurden, kann ein komplexer Vorgang sein, da die Speicherorte der Anpassungsdateien nicht standardisiert sind.

Entscheiden Sie zusammen mit dem Entwicklungsteam oder dem Hersteller Ihrer Anpassungen, ob Ihre Anpassungen zusätzliche Add-In-Software oder Dateien an anderen Speicherorten beinhalten. Es wird empfohlen, diese Verzeichnisse mit einem Programm zur Dateisystemwiederherstellung wiederherzustellen. In der folgenden Tabelle sind die Speicherorte aufgeführt, an denen Anpassungen üblicherweise auf Webservern gespeichert werden.

Speicherort	Beschreibung
%PROGRAMFILES%\Common files\Microsoft Shared\Web Server Extensions\16	Häufig aktualisierte Dateien, benutzerdefinierte Assemblys, benutzerdefinierte Vorlagen, benutzerdefinierte Websitedefinitionen
Inetpub	Speicherort für die virtuellen IIS-Verzeichnisse
%WINDIR%\Assembly	Globaler Assemblycache (GAC): ein geschützter Speicherort des Betriebssystems, in dem Microsoft .NET Framework-Code-Assemblys installiert werden, um einen Vollzugriff auf das System zu ermöglichen