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

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

参数

-DatabaseCredentials

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

This parameter should only be specified if SQL authentication is used to connect to the database. If Windows authentication is used to connect to the database, then this parameter should not be specified.

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

-DatabaseName

指定配置数据库名称。

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

-DatabaseServer

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

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

Type:String
Position:Named
Default value:None
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) 。

Multiple backup packages can be stored in the same location. This is the same path that you pass to the Directory parameter of the Restore-SPFarm cmdlet.

键入的值必须为有效路径之一:

  • C:\folder_name
  • \\server_name\folder_name

将自动创建 spbr* 文件夹。

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

-Item

Indicates the part of the farm to back up. You may use the full farm path notation as displayed by the ShowTree parameter or the name of the target component in the path if the component has a unique name. If multiple items match the name, the full path must be provided. Surround the item or path in quotation marks if it contains a space.

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

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-工作分配

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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