Restore-SPSite

Referenz

Modul:: SharePointServer

Gilt für::: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Stellt eine Websitesammlung wieder her.

Syntax

Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-ContentDatabase <SPContentDatabasePipeBind>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]

Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-DatabaseName <String>]
       [-DatabaseServer <String>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]

Beschreibung

Dieses Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.

Das Restore-SPSite Cmdlet führt eine Wiederherstellung der Websitesammlung an einem Speicherort durch, der durch den Identity-Parameter angegeben wird. Eine Inhaltsdatenbank darf nur eine Kopie einer Websitesammlung enthalten. Wenn eine Websitesammlung gesichert und unter einer anderen URL-Adresse in der gleichen Webanwendung wiederhergestellt wird, muss eine zusätzliche Inhaltsdatenbank verfügbar sein, um die wiederhergetellte Kopie der Websitesammlung zu speichern.

Beispiele

----------------------BEISPIEL 1----------------------

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak

In diesem Beispiel wird eine Websitesammlung aus der Sicherungsdatei "C:\Backup\site_name.bak" in der Websitesammlungs-URL wiederhergestellt. https://server_name/sites/site_name.

----------------------BEISPIEL 2----------------------

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak -Force -DatabaseServer SQLBE1 -DatabaseName SQLDB1

In diesem Beispiel wird eine Websitesammlungssicherung aus der Sicherungsdatei C:\Backup\site_name.bak wiederhergestellt, die vorhandene Websitesammlung wird jedoch unter https://server_name/sites/site_name überschrieben, während angegeben wird, dass die Websitesammlung in einer bestimmten Inhaltsdatenbank gespeichert werden muss.

----------------------BEISPIEL 3----------------------

Restore-SPSite https://www.example.com -Path \\file_server\share\site_name.bak -HostHeaderWebApplication https://server_name

In diesem Beispiel wird eine Websitesammlungssicherung aus der Sicherungsdatei \\file_server\share\site_name.bak in der Websitesammlung https://www.example.com mit hostnamen in der Webanwendung wiederhergestellt. https://server_name.

Parameter

-AssignmentCollection

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.

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.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ContentDatabase

Gibt die SQL Server-Inhaltsdatenbank an, in der die Websitesammlung gespeichert wird. Wenn keine Inhaltsdatenbank angegeben wird, wird die Inhaltsdatenbank mit der größten ungenutzten Websitesammlungskapazität mit dem Status Bereit verwendet.

Type:	SPContentDatabasePipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

Bei dem Typ muss es sich um einen gültigen Datenbanknamen im Format SQLDB1 handeln.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Gibt den Namen des Computers mit SQL Server an, der die durch den Parameter DatabaseName angegebene Inhaltsdatenbank enthält.

Bei dem Typ muss es sich um einen gültigen Datenbankservernamen im Format SQLBE1 handeln, und dieser muss in Verbindung mit dem DatabaseName -Parameter verwendet werden.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Force

Gibt an, dass die vorhandene Websitesammlung unter der URL-Adresse durch die Wiederherstellung überschrieben werden soll.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-GradualDelete

Gibt an, dass die Websitesammlung, die mit dem Force-Parameter überschrieben wird, im Laufe der Zeit schrittweise von einem Zeitgeberauftrag gelöscht werden soll, anstatt alle gleichzeitig, wodurch die Auswirkungen auf SharePoint-Produkte und SQL Server Leistung reduziert werden. Diese Option wird für große Websitesammlungen empfohlen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-HostHeaderWebApplication

Eine gültige URL, die der Webanwendung mithilfe einer alternativen Zugriffszuordnung zugewiesen wird, z. B. https://server_name

Stellt eine Websitesammlung als Websitesammlung mit Hostnamen wieder her, nicht als eine auf einem Pfad basierte Websitesammlung. Wenn der HostHeaderWebApplication -Parameter vorhanden ist, entspricht der Wert des Identity -Parameters der URL der Websitesammlung mit Hostnamen, und der Wert des HostHeaderWebApplication -Parameters entspricht der URL der Webanwendung, die die Websitesammlung mit Hostnamen enthält.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Gibt den URL-Pfad an, unter dem die Websitesammlung wiederhergestellt wird.

Eine Websitesammlung muss nicht bereits unter der URL-Adresse vorhanden sein, damit eine Wiederherstellung erfolgen kann. Allerdings müssen Sie eine gültige URL-Adresse angeben, damit eine Websitesammlung erstellt werden kann. Wenn an der angegebenen URL-Adresse bereits eine Websitesammlung vorhanden ist, müssen Sie den Force -Parameter angeben, um sie zu überschreiben.

Der Typ muss eine gültige URL im Format sein. https://server_name/sites/site_name.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Path

Gibt einen gültigen Pfad zum Speicherort der Sicherung an. Beispiel: C:\Backup\site_name.bak.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-PreserveSiteID

Behält die ursprüngliche Website-ID bei, anstatt eine neue zu erstellen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019