Backup-SPConfigurationDatabase

执行服务器场级的仅配置备份。

语法

Backup-SPConfigurationDatabase
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [<CommonParameters>]
Backup-SPConfigurationDatabase
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [-ShowTree]
      [<CommonParameters>]

说明

此 cmdlet 包含多个参数集。 您可以只使用来自一个参数集的参数,也可以不合并来自不同参数集的参数。 若要详细了解如何使用参数集,请参阅 Cmdlet 参数集

Backup-SPConfigurationDatabase cmdlet 执行当前服务器场的仅配置备份或独立于当前服务器场的单独配置数据库的仅配置备份。 如果您要执行当前服务器场的仅配置备份,则无需指定 DatabaseServer 和 DatabaseName 参数。 但是,对于这种情况,建议将 Backup-SPFarm cmdlet 与 ConfigurationOnly 参数配合使用。

配置备份的一个示例为:管理员创建一个服务器场配置模板,该模板以后可以通过使用 Restore-SPFarm cmdlet 执行还原操作应用于其他 SharePoint 服务器场。

有关 SharePoint 产品Windows PowerShell的权限和最新信息,请参阅 中的https://go.microsoft.com/fwlink/p/?LinkId=251831联机文档。

示例

-------------------示例 1--------------------

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -ShowTree

此示例显示适用于包含在仅配置备份中的组件。

-------------------示例 2--------------------

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -Verbose

此示例执行带有详细输出的仅配置备份。

参数

-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

-DatabaseCredentials

指定与 SQL Server 数据库的管理员用户名对应的 ID 和密码。

仅当 SQL 验证用于连接到数据库时,才应指定此参数。 如果 Windows 验证用于连接到数据库,则不应指定此参数。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DatabaseName

指定配置数据库名称。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DatabaseServer

指定包含配置数据库的 SQL 数据库服务器。 默认值为本地计算机名称。

键入的值必须为有效的数据库服务器;例如,DS。

Type:String
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

-Item

指示要备份服务器场的哪个部分。 可以使用完整服务器场路径表示法,如 ShowTree 参数所示,或者可以使用路径中目标组件的名称(如果该组件具有唯一的名称)。 如果该名称具有多个匹配项,则必须提供完整路径。 如果项目或路径中包含空格,请将该项目或路径用引号引起来。

如果未指定 Item 参数,则备份整个服务器场配置。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ShowTree

根据传递给备份 cmdlet 的其他参数,即 Item 参数,显示服务器场中将备份的对象。 根据传递给 Backup-SPConfigurationDatabase 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