Restore-SPSite

模块:: SharePointServer module

还原网站集。

语法

DatabaseFromPipebind

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

DatabaseParameter

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.

示例 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 。

示例 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 命令来处理对象，则可能会发生内存不足的情况。

参数属性

类型:	SPAssignmentCollection
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

执行命令前，看到确认提示。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ContentDatabase

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

参数属性

类型:	SPContentDatabasePipeBind
默认值:	None
支持通配符:	False
不显示:	False

参数集

DatabaseFromPipebind

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DatabaseName

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

DatabaseParameter

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DatabaseServer

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

DatabaseParameter

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Force

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-GradualDelete

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-HostHeaderWebApplication

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Identity

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

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

类型必须是有效的 URL，格式为 https://server_name/sites/site_name.

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Path

指定备份位置的有效路径。例如，C:\Backup\site_name.bak。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PreserveSiteID

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

反馈

此页面是否有帮助？