Restore-SPSite
还原网站集。
语法
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 Subscription Edition |
-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 Subscription Edition |
-ContentDatabase
指定将存储网站集数据的 SQL Server 内容数据库。 如果未指定内容数据库,将使用未使用的网站集容量最大、其数据库状态为准备就绪的内容数据库。
Type: | SPContentDatabasePipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-Force
指定此还原将覆盖位于 URL 位置的现有网站集。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-PreserveSiteID
保留原始站点 ID,而不是创建新站点 ID。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 Subscription Edition |