Restore-SPFarm

从备份还原一个或多个项目。

语法

Restore-SPFarm
       -Directory <String>
       -RestoreMethod <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-FarmCredentials <PSCredential>]
       [-Force]
       [-Item <String>]
       [-NewDatabaseServer <String>]
       [-Percentage <Int32>]
       [-RestoreThreads <Int32>]
       [-WhatIf]
       [<CommonParameters>]
Restore-SPFarm
       -Directory <String>
       [-ShowTree]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-BackupId <Guid>]
       [-ConfigurationOnly]
       [-Confirm]
       [-Item <String>]
       [-WhatIf]
       [<CommonParameters>]

说明

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

该 cmdlet 从备份中还原一个或多个项目,如单个数据库 Restore-SPFarm 、Web 应用程序或整个服务器场。 此 cmdlet 还可用于将服务器场模板应用于整个服务器场。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet

示例

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

Restore-SPFarm -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -RestoreMethod new -ConfigurationOnly

此示例将配置设置从 \ \ file_server\share\Backup 目录中的备份包还原到服务器场。

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

Restore-SPFarm -ShowTree -Directory \\file_server\share\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef -Item "Microsoft SharePoint Foundation Web Application" -Verbose

此示例显示在 Microsoft SharePoint Foundation Web Application 节点下将还原的服务器场的组件,但实际并不进行还原。

-------------------示例 3-----------------------

Restore-SPFarm -Directory C:\Backup -BackupId 12345678-90ab-cdef-1234-567890abcdef  -RestoreMethod overwrite -RestoreThreads 10 -Force

此示例使用 10 个线程还原服务器场并阻止 overwrite 警告。

参数

-BackupId

指定要还原的备份包的 GUID。 每个备份包都有与其关联的唯一 GUID。 可以使用 cmdlet 查看备份历史记录, Get-SPBackupHistory 以查看 GUID。 如果未指定此参数,则使用通过 Directory 参数指定的路径中的最新备份包。

键入的值必须为有效 GUID,格式为 12345678-90ab-cdef-1234-567890abcdef。

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

仅指定将从备份包中还原并应用于目标服务器场上对象的设置(没有数据)。

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

在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
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 产品安装在多台计算机上,则必须使用通用命名约定 (UNC) 共享路径,以便 SQL Server 和 SharePoint 产品可以从同一位置读取 (例如 \ \ computer_name \volume\Backup) 。

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

  • 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
-FarmCredentials

指定将用于要还原的所有组件的凭据,例如,要还原的 Web 应用程序的应用程序池凭据。如果还原的应用程序池已存在于服务器场中,当还原该应用程序池时,将忽略 FarmCredentials 参数指定的凭据。

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

阻止执行覆盖还原操作时将覆盖组件的提示警告。

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

指定有效的 SQL 数据库服务器名称。如果指定,将用作还原操作中所有数据库的默认数据库服务器名称。

此参数仅在全新还原时有效。对于覆盖还原无效。

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

要求以该百分比的增量显示有关还原操作的进度更新。例如,值为 5 将以 5% 的增量显示完成的还原进度更新,而值为 10 将以 10% 的增量显示完成的还原进度更新。

注意:如果指定了 -Verbose 参数,则只在输出中显示进度。 否则,可以在还原日志文件中看到进度。

该百分比并不精确,实际更新进度可能低于或高于要求的百分比。

对于非常大的数据库,建议使用值 1 。

键入的值必须是介于 1 和 100 之间的整数值。

默认值为 5。

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

指定要执行的还原方法。

有效值为:

  • New ;指定还原内容的新位置,此参数旨在当还原到其他服务器场时使用。还会显示其他提示,以指定新设置。
  • Overwrite ;将内容和设置还原至其初始位置,此参数旨在当还原到备份所在的同一服务器场时使用。如果使用 Overwrite 参数,则显示确认提示。如果要阻止确认提示,请使用 Force 参数。
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition
-RestoreThreads

还原期间应使用的线程数。

还原线程越少,越容易理解还原日志。但是,还原线程越多,越多的组件可以并行还原,可能导致速度更快的还原。

有效范围介于 1 和 10 之间。默认值为 3。

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

显示将基于传递给 cmdlet 的其他参数(即 Item 和 ConfigurationOnly 参数)还原服务器场 Restore-SPFarm 中的哪些对象。 基于传递给 cmdlet 的其他参数从还原中排除的项目前面将带有星号 Restore-SPFarm (*) 。 无法还原的项目将括在方括号 [ ] () 。 如果 ShowTree 参数存在,将不执行还原操作。

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

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过Stop-SPAssignment使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

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