Backup-SPSite
执行网站集的备份。
语法
Default (默认值)
Backup-SPSite
[-Identity] <SPSitePipeBind>
-Path <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Force]
[-NoSiteLock]
[-UseSqlSnapshot]
[-WhatIf]
[-UseABSDocStreamInfo]
[<CommonParameters>]
说明
使用 Identity 参数时,Backup-SPSite cmdlet 执行网站集的备份。
默认情况下,网站集在备份期间将一直设置为只读,以减少备份操作期间用户活动损坏备份的可能性。 如果有 SQL Server Enterprise Edition,建议使用 UseSqlSnapshot 参数,因为这可确保获得有效的备份,同时又允许用户在备份期间仍能读写网站集。
有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet。
示例
示例 1
Backup-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak
本示例将 位于 https://server_name/sites/site_name 的网站集备份到 C:\Backup\site_name.bak 文件。
示例 2
Get-SPSiteAdministration https://server_name/sites/site_name | Backup-SPSite -Path C:\Backup\site_name.bak
本示例将 位于 https://server_name/sites/site_name 的网站集备份到 C:\Backup\site_name.bak 文件。 结果与示例 1 相同,但是执行操作的方法不同。
示例 3
Backup-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak -UseSqlSnapshot
此示例使用数据库快照备份网站集,以确保备份完整性。
示例 4
Backup-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak -NoSiteLock
此示例备份网站集,并阻止在备份阶段将网站置于只读模式。 在生产环境中备份站点时,请使用 -NoSiteLock 参数,在进行备份时最好不要将站点置于只读模式。
参数
-AssignmentCollection
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。
在使用 Global 参数时,所有对象均包含在全局存储中。 如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。
参数属性
| 类型: | SPAssignmentCollection |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
执行命令前,看到确认提示。
有关详细信息,请键入以下命令:get-help about_commonparameters
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Force
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定覆盖现有备份文件(如果备份文件已经存在)。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定要备份的网站集的 URL 或 GUID。
例如,有效的 URL,如 https://server_name/sites/site_name,或者 GUID,如"01234567-89ab-cdef-0123-456789abcdef"
参数属性
| 类型: | SPSitePipeBind |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-NoSiteLock
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定备份期间要保持可读写的网站集。
如果未指定 NoSiteLock 参数,那么在执行网站集备份时,网站集锁定设置为"无"或"不可添加"的网站集将被临时设置为"只读"。 备份完成后,网站集锁定将恢复为其原始状态。 备份包将记录原始网站集锁定状态,以便还原为该状态。
如果在备份网站集时,有用户正在写入网站集,那么建议不要使用 NoSiteLock 参数,以防对备份完整性造成可能影响
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Path
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定备份文件的完整路径(即 C:\Backup\site_name.bak)。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-UseABSDocStreamInfo
适用:SharePoint Server 2016,SharePoint Server 2019
请勿使用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-UseSqlSnapshot
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定备份开始时,将创建 SQL 数据库快照,所有网站集数据将直接从数据库快照中检索。 备份完成后,此快照将被自动删除。
如果承载内容数据库的数据库服务器支持数据库快照(如 SQL Server Enterprise Edition 和 SQL Server Developer Edition),那么建议使用 UseSqlSnapshot 参数。 这是因为它将确保获得有效的备份,同时又允许用户在备份期间仍能对网站集进行读写。 指定 UseSqlSnapshot 参数后,不必指定 NoSiteLock 参数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
显示一条描述命令作用的消息,而不执行命令。
有关详细信息,请键入以下命令: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。