Restore-SPSite

参考

模块:: SharePointServer

适用于:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

还原网站集。

语法

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>]

说明

此 cmdlet 包含多个参数集。只能使用一个参数集中的参数，而不能结合使用不同参数集中的参数。若要详细了解如何使用参数集，请参阅 Cmdlet 参数集。

cmdlet Restore-SPSite 将网站集还原到 Identity 参数指定的位置。内容数据库可以只包含一个网站集副本。如果在备份网站集之后将其还原到同一 Web 应用程序中的不同 URL 位置，必须提供其他内容数据库，以保存此网站集的已还原副本。

示例

----------------------示例 1----------------------

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

本示例将网站集从备份文件 C：\Backup\site_name.bak 还原到网站集 URL https://server_name/sites/site_name.

----------------------EXAMPLE 2----------------------

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

此示例从备份文件 C：\Backup\site_name.bak 还原网站集备份，但在指定网站集必须存储在特定内容数据库中时覆盖现有 https://server_name/sites/site_name 网站集。

----------------------EXAMPLE 3----------------------

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

本示例将网站集备份从备份文件 \\file_server\share\site_name.bak 还原到 Web 应用程序上以主机命名的网站集https://www.example.comhttps://server_name.

参数

-AssignmentCollection

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

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

执行命令前，看到确认提示。有关详细信息，请键入以下命令：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

指定将存储网站集数据的 SQL Server 内容数据库。如果未指定内容数据库，将使用未使用的网站集容量最大、其数据库状态为准备就绪的内容数据库。

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

指定将存储网站集数据的 SQL Server 内容数据库。如果未指定内容数据库，将使用未使用的网站集容量最大、其数据库状态为准备就绪的内容数据库。

键入的值必须为有效的数据库名称，形式为 SQLDB1。

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

指定包含由 DatabaseName 参数指定的内容数据库的 SQL Server 的名称。

键入的值必须为有效的数据库服务器名称，形式为 SQLBE1，并且需要与 DatabaseName 参数结合使用。

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

指定此还原将覆盖位于 URL 位置的现有网站集。

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

指定计时器作业应逐渐删除使用 Force 参数覆盖的网站集，而不是一次性删除，这可以减少其对 SharePoint 产品的影响并SQL Server性能。建议将此选项用于大型网站集。

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

使用备用访问映射分配给 Web 应用程序的有效 URL，例如 https://server_name

将网站集还原为命名主机的网站集，而不是基于路径的网站集。当 HostHeaderWebApplication 参数存在时， Identity 参数的值为命名主机的网站集的 URL， HostHeaderWebApplication 参数的值为将承载命名主机的网站集的 Web 应用程序的 URL。

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

指定网站集的还原 URL 位置。

还原时，网站集不必已存在于此 URL 位置。但是必须指定可以创建网站集的有效 URL 位置。如果在指定的 URL 位置已存在网站集，则必须指定 Force 参数覆盖它。

类型必须是有效的 URL，格式为 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

指定备份位置的有效路径。例如，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

保留原始站点 ID，而不是创建新站点 ID。

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

显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：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

通过