Restore：Stsadm 操作 (Windows SharePoint Services)
操作名称：Restore
说明
当使用 url 参数时，会对网站集执行还原操作。但是，当使用 restoremethod 参数时，可以对单个数据库、Web 应用程序或整个服务器场执行还原操作。如果要覆盖现有网站集，请使用 overwrite 参数。
语法
对于网站集还原
stsadm -o restore
-url <URL name>
-filename <file name>
[-hostheaderwebapplicationurl] <Web application URL>
[-overwrite]
对于灾难性还原
stsadm -o restore
-directory <UNC path>
-restoremethod {overwrite | new}
[-backupid] <GUID from backuphistory, see stsadm -help backuphistory>
[-item] <created path from tree>
[-percentage] <integer between 1 and 100>
[-showtree]
[-suppressprompt]
[-username] <user name>
[-password] <password>
[-newdatabaseserver] <new database server name>
[-preservechangelog]
[-quiet]
参数
| 参数 | 值 | 是否必需？ | 说明 |
|---|---|---|---|
url |
一个有效的 URL，例如 http://server_name/sites/site_name |
是 |
指定应将网站集备份还原到的 URL。 |
filename |
网站集备份文件的有效文件名，如“Site_name.bak” |
是 |
指定包含网站集备份的文件的路径和名称。 |
hostheaderwebapplicationurl |
通过使用备用访问映射 (AAM) 为 Web 应用程序分配的有效 URL，如“http://服务器名称” |
否 |
将网站集还原为以主机命名的网站集，而不是基于路径的网站集。当存在 hostheaderwebapplicationurl 参数时，url 参数的值为以主机命名的网站集的 URL，hostheaderwebapplicationurl 参数的值为将承载以主机命名的网站集的 Web 应用程序的 URL。 |
overwrite |
<无> |
否 |
用备份文件中存储的网站集覆盖当前位于由 url 参数指定的位置的现有网站集。 |
directory |
以下任何一个有效路径：
备注 将自动创建 spbr* 文件夹。 |
是 |
Windows SharePoint Services 3.0 在其中存储 stsadm -o backup 操作期间生成的灾难性备份包的路径。此路径为 spbr* 文件夹的父文件夹。 如果计算机上安装了 Microsoft SQL Server 2005 和 Windows SharePoint Services 3.0 实例，则可以使用本地驱动器路径。该路径将包括基本安装。但如果 SQL Server 2005 和 Windows SharePoint Services 3.0 安装在多台计算机上，则必须使用通用命名约定 (UNC) 共享路径，以便从同一位置（例如，\\计算机名称\volume\Backup）中读取 SQL 数据库和搜索组件。可以将多个备份包存储在同一位置。此路径将与传递到 stsadm -o restore 操作 -directory 参数的路径相同。 |
restoremethod |
以下任一项：
|
是 |
指定要执行的服务器场还原的类型（overwrite 或 new）。 如果值为 overwrite，则会将内容和设置还原到其原始位置。此参数仅在同一服务器场内的灾难性还原中使用。如果使用值 overwrite，则会显示确认提示。若要禁止提示，请使用 suppressprompt 参数。 如果值为 new，则指定将内容还原到新位置，并预期要在还原到不同服务器场（例如一个新的数据库服务器）时使用。 |
backupid |
一个有效的 GUID，如“12345678-90ab-cdef-1234-567890abcdef” |
应还原的备份包的 GUID。每个备份包都有一个唯一的 GUID 与其关联，可通过查看备份历史记录（方法是使用 stsadm -o backuphistory 操作）来查看备份包。如果缺少此参数，则将使用最新的备份包。 |
|
item |
一个有效项，例如：
|
否 |
指示应还原服务器场的哪一部分。可以使用 -showtree 参数所显示的完整服务器场路径表示法，也可以使用路径中目标组件的名称（如果目标组件具有唯一名称）。如果该项或路径包含空格，请将该项或路径用双引号引起来。如果缺少此参数，则将还原备份包中的所有项。 |
percentage |
1 和 100 之间的整数值。 默认值为 5。 |
否 |
请求 Restore 操作更新进度以该百分比为增量显示（例如，值“5”将表示还原进度更新已完成 5%，值“10”将表示已完成 10%）。 备注 此百分比并不准确，实际更新进度可能小于或大于所请求的百分比。 对于非常大的数据库，1 是用于查看某些显示的更新的最佳值。 默认值为 5。 |
showtree |
<无> |
否 |
显示将根据传递到 stsadm -o restore 操作的所有其他参数还原备份包中的哪些项 根据传递给 Restore 操作的其他参数将从还原中排除的项的前面会有一个星号字符。无法选定用于还原的项将使用方括号 ([ ]) 括起来。如果存在 showtree 参数，则不会执行还原操作 |
suppressprompt |
<无> |
否 |
防止显示以下命令行提示： “警告: 将覆盖所有所选项。是否要覆盖它们 (Y/N)?” 仅当 restoremethod 参数的值设置为 overwrite 时，此参数才有效。 |
username |
一个有效的 SQL 验证用户名，格式为：用户名 |
否 |
为需要用户名的所有正在还原的对象（包括 Web 应用程序池）设置相同的用户名。如果还原整个服务器场，则此参数只应由使用 Windows 身份验证连接到数据库的服务器场使用。如果只还原数据库，则可以提供 SQL Server 2005 登录名。 |
password |
否 |
为需要密码的所有正在还原的对象（包括 Web 应用程序池）设置相同的密码。如果还原整个服务器场，则此参数只应由使用 Windows 身份验证连接到数据库的服务器场使用。如果只还原数据库，则可以提供 SQL Server 2005 登录密码。 |
|
newdatabaseserver |
一个有效的数据库服务器名称，如“SQLBE1” |
否 |
指示当 restoremethod 参数的值为 new 时，还原任意数据库时应使用的 SQL Server 2005 的实例名称。当 restoremethod 参数的值设置为 overwrite 时，此参数无效。 默认情况下，将要求您为每个数据库提供一个新数据库服务器名称。 |
preservechangelog |
<无> |
否 |
保留更改日志，以便对此内容数据库的下次爬网不是完全爬网。此参数是在 Windows SharePoint Services 3.0 的基础结构更新中首次引入的。有关详细信息，请参阅“备注”。 |
quiet |
<无> |
否 |
禁止将还原进度信息输出到显示窗口。仍将显示最终还原状态（“操作成功完成。”）。如果缺少 -quiet 参数，则 restore 操作会在还原程序包时在显示窗口中显示进度信息。 |
备注
如果运行的是 Windows SharePoint Services 3.0 的基础结构更新，则在使用内置工具还原或重新附加数据库时，会保留每个内容数据库的标识符 (ID)。使用内置工具时的默认更改日志保留行为如下所示：
还原服务器场时，保留所有数据库的更改日志。
重新附加数据库时，保留内容数据库的更改日志。
仅还原内容数据库时，不保留内容数据库的更改日志。在这种情况下，您应使用 preservechangelog 参数。
当保留数据库 ID 和更改日志时，搜索将根据爬网规则定义的定期计划继续爬网。当不保留更改日志时，搜索将在下一个预定爬网过程中执行完全爬网。
有关详细信息，请参阅移动内容数据库 (Windows SharePoint Services 3.0) 和管理 Windows SharePoint Services 3.0 技术的备份和恢复。
如果在还原现有数据库时，不将带有 overwrite 选项的 restoremethod 参数与 stsadm –o restore 操作一起使用，则会为还原的数据库分配一个新的 ID，并且不保留数据库更改日志。下次对数据库爬网时，将对内容数据库编制完整索引。
如果在执行还原操作时，备份包中的 ID 已经在服务器场中使用（例如，您尝试将数据库分为两部分），则会为还原的数据库分配一个新的 ID，并且会在还原日志中添加一个警告。能否执行增量爬网（而不是完全爬网）取决于内容数据库 ID 是否与以前相同，以及搜索所使用的更改日志令牌对内容数据库中的当前更改日志是否有效。如果不保留更改日志，则令牌将无效，并且搜索将必须执行完全爬网。