Backup-SPFarm
创建单个数据库、Web 应用程序或整个服务器场的备份。
语法
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Backup-SPFarm
[-ShowTree]
[-AssignmentCollection <SPAssignmentCollection>]
[-ConfigurationOnly]
[-Item <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
此 cmdlet 包含多个参数集。 您可以只使用来自一个参数集的参数，也可以不合并来自不同参数集的参数。 若要详细了解如何使用参数集，请参阅 Cmdlet 参数集。
Backup-SPFarm cmdlet 创建整个服务器场或服务器场中单个组件的备份。 该 cmdlet 还可用于仅备份服务器场的配置设置，以用作其他 SharePoint 服务器场的服务器场模板。 如果要备份单个网站集，请使用 Backup-SPSite cmdlet。
若要查看要备份的可用对象，请使用 -ShowTree 参数集。
有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。
示例
--------------------示例 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 估计该目录没有足够的可用空间，也仍然会强制将备份保存到该目录。
--------------------EXAMPLE 4---------------------
Backup-SPFarm -ShowTree此示例显示使用 进行备份的 Backup-SPFarm可用对象。
参数
-AssignmentCollection
管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。
在使用 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 |
-BackupMethod
指定要创建的备份文件的类型。
如果使用 -ShowTree 参数执行备份，则不使用 BackupMethod 参数。
完整备份是指备份所有选定的数据。 差异备份是自上次完整备份以来发生更改的所有选定数据的备份。 如果某项不支持差异备份，则对该项执行完整备份。
键入的值必须是下列值之一：
- 完整
- 微分
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-BackupThreads
指定在备份过程中使用的线程数。 线程越少，备份日志文件则越容易读取和理解。 线程越多，可并行备份的组件则越多，进而可能导致备份操作的速度越快。 最小值为 1 ，最大值为 10 。
默认值为 3。
如果使用 -ShowTree 参数执行备份，则不使用 BackupMethod 参数。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ConfigurationOnly
如果设置此参数，则备份将仅包含要备份的每个对象的配置设置（无数据）。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 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 |
-Directory
指定 SharePoint 产品存储它生成的备份包的路径。 如果你有一台安装了 SQL Server 和 SharePoint 产品实例的计算机，则可以使用本地驱动器路径。 这包括基本安装。 但是，如果在多台计算机上安装 SQL Server 和 SharePoint 产品，或者有多个运行 SharePoint 产品的服务器，则必须使用通用命名约定 (UNC) 共享路径，以便将SQL Server数据库和搜索组件写入到同一位置;例如，\computer_name\volume\Backup) 。
多个备份包可以存储在同一位置。 这与传递给 Restore-SPFarm cmdlet 的 Directory 参数的路径相同。
键入的值必须为有效路径之一：
- C:\folder_name
- \\server_name\folder_name
将自动创建 spbr* 文件夹。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Force
指定即使估计备份目录没有足够的空间来保存整个备份，也仍然继续执行备份操作。
如果使用 ShowTree 参数执行备份，则不使用 Force 参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Item
指示要备份服务器场的哪个部分。 可以使用 ShowTree 参数显示的完整服务器场路径表示法，也可以使用路径中目标组件的名称（如果该组件具有唯一名称）。 如果同一匹配中包括多项，则必须提供完整路径。 默认情况下，顶级节点处于选中状态。 如果项目或路径中包含空格，请将该项目或路径用引号引起来。 如果未指定此参数，将备份整个服务器场。
类型必须是有效的项;例如，Farm\Microsoft SharePoint Foundation Web Application\SharePoint - 80。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Percentage
要求以该百分比增量的形式显示有关备份操作的进度更新；例如，值为 5 将以 5% 的增量显示完成的备份进度更新，而值为 10 将以 10% 的增量显示完成的备份进度更新。 若要显示进度输出，则必须指定 Verbose 参数。
该百分比并不精确，实际更新进度可能低于或高于要求的百分比。 将始终在备份日志文件中记录更新进度。
百分比值并不精确，实际更新进度可能低于或高于要求的百分比值。
默认值为 5。 对于非常大的数据库，建议使用值 1 。
有效值是介于 1 和 100 之间的整数值。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ShowTree
显示将基于传递给 Backup-SPFarm cmdelt 的其他参数（即 Item 参数）备份服务器场中的哪些对象。 将要基于传递给 Backup-SPFarm cmdlet 的其他参数从备份中排除的项目前面标记有星号字符 (*)。 无法备份的项目将括在方括号 ([ ]) 中。 如果 ShowTree 参数存在，将不执行备份。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈