Backup-SPFarm
适用于: SharePoint Foundation 2010, SharePoint Server 2010
上一次修改主题: 2015-03-09
创建单个数据库、Web 应用程序或整个服务器场的备份。
Syntax
Backup-SPFarm -BackupMethod <String> -Directory <String> [-AssignmentCollection <SPAssignmentCollection>] [-BackupThreads <Int32>] [-ConfigurationOnly <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Item <String>] [-Percentage <Int32>] [-WhatIf [<SwitchParameter>]]
Backup-SPFarm -ShowTree <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>] [-ConfigurationOnly <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Item <String>] [-WhatIf [<SwitchParameter>]]
详细说明
Backup-SPFarm cmdlet 创建整个服务器场或服务器场中单个组件的备份。该 cmdlet 还可用于仅备份服务器场的配置设置,以用作其他 SharePoint 服务器场的服务器场模板。如果要备份单个网站集,请使用 Backup-SPSite cmdlet。
Parameters
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
BackupMethod |
必需 |
System.String |
指定要创建的备份文件的类型。 如果使用 –ShowTree 参数执行备份,则不使用 BackupMethod 参数。 完整备份是指备份所有选定的数据。差异备份是自上次完整备份以来发生更改的所有选定数据的备份。如果某项不支持差异备份,则对该项执行完整备份。 该类型必须是下列值之一: - Full - Differential |
Directory |
必需 |
System.String |
指定 SharePoint 2010 产品存储其生成的备份包的路径。如果您的计算机上安装了 Microsoft SQL Server 2008 和 SharePoint 2010 产品的实例,则您可以使用本地驱动器路径。这包括基本安装。但是,如果在多台计算机上安装了 SQL Server 2008 以及 SharePoint 2010 产品,或者如果有多台服务器均在运行 SharePoint 2010 产品,则必须使用通用命名约定 (UNC) 共享路径,以便将 SQL Server 数据库和搜索组件写入到同一位置;例如,\\computer_name\volume\Backup。 多个备份包可以存储在同一位置。这与传递给 Restore-SPFarm cmdlet 的 Directory 参数的路径相同。 类型必须为有效路径之一: - C:\folder_name - \\server_name\folder_name
Note
将自动创建 spbr* 文件夹。
|
ShowTree |
必需 |
System.Management.Automation.SwitchParameter |
显示将基于传递给 Backup-SPFarm cmdelt 的其他参数(即 Item 参数)备份服务器场中的哪些对象。将要基于传递给 Backup-SPFarm cmdlet 的其他参数从备份中排除的项目前面标记有星号字符 (*)。无法备份的项目将括在方括号 ([ ]) 中。如果 ShowTree 参数存在,将不执行备份。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。
Note
在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。
|
BackupThreads |
可选 |
System.Int32 |
指定在备份过程中使用的线程数。线程越少,备份日志文件则越容易读取和理解。线程越多,可并行备份的组件则越多,进而可能导致备份操作的速度越快。最小值为 1,最大值为 10。 默认值为 3。 如果使用 –ShowTree 参数执行备份,则不使用 BackupMethod 参数。 |
ConfigurationOnly |
可选 |
System.Management.Automation.SwitchParameter |
如果设置此参数,则备份将仅包含要备份的每个对象的配置设置(无数据)。 |
Force |
可选 |
System.Management.Automation.SwitchParameter |
指定即使估计备份目录没有足够的空间来保存整个备份,也仍然继续执行备份操作。 如果使用 ShowTree 参数执行备份,则不使用 Force 参数。 |
Item |
可选 |
System.String |
指示要备份服务器场的哪个部分。可以使用 ShowTree 参数显示的完整服务器场路径表示法,也可以使用路径中目标组件的名称(如果该组件具有唯一名称)。如果同一匹配中包括多项,则必须提供完整路径。默认情况下,顶级节点处于选中状态。如果项目或路径中包含空格,请将该项目或路径用引号引起来。如果未指定此参数,将备份整个服务器场。 键入的类型必须是有效项目;例如,Farm\Microsoft SharePoint Foundation Web Application\SharePoint – 80。 |
Percentage |
可选 |
System.Int32 |
要求以该百分比增量的形式显示有关备份操作的进度更新;例如,值为 5 将以 5% 的增量显示完成的备份进度更新,而值为 10 将以 10% 的增量显示完成的备份进度更新。若要显示进度输出,则必须指定 Verbose 参数。
Note
该百分比并不精确,实际更新进度可能低于或高于要求的百分比。将始终在备份日志文件中记录更新进度。
百分比值并不精确,实际更新进度可能低于或高于要求的百分比值。 默认值为 5。对于非常大的数据库,建议使用值 1。 有效值是介于 1 和 100 之间的整数值。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息,而不执行命令。有关详细信息,请键入以下命令:get-help about_commonparameters |
输入类型
返回类型
Example
--------------------示例 1---------------------
Backup-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnly
此示例将服务器场的配置设置备份到 \\file_server\share\Backup 目录。
--------------------示例 2---------------------
Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -Verbose
此示例显示将备份服务器场中“Microsoft SharePoint Foundation Web Application”节点下的哪些组件,但不会实际备份这些组件。
--------------------示例 3---------------------
Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -Force
此示例使用 10 个线程来将服务器场备份到 C:\Backup 目录,并且即使 SharePoint 估计该目录没有足够的可用空间,也仍然会强制将备份保存到该目录。
See Also
Reference
Backup-SPConfigurationDatabase
Get-SPBackupHistory
Restore-SPFarm