Restore：Stsadm 操作 (Office SharePoint Server)
操作名称：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://server_name” |
否 |
将网站集还原为以主机命名的网站集，而不是基于路径的网站集。当存在 hostheaderwebapplicationurl 参数时，-url 参数的值为以主机命名的网站集的 URL，hostheaderwebapplicationurl 参数的值为将承载以主机命名的网站集的 Web 应用程序的 URL。 |
overwrite |
<无> |
否 |
用备份文件中存储的网站集覆盖当前位于 url 参数所指定位置的现有网站集。 |
directory |
以下任何有效路径之一：
备注 将会自动创建 spbr* 文件夹。 |
是 |
Microsoft Office SharePoint Server 2007 用于存储执行 stsadm -o backup 操作期间生成的灾难性备份包的路径。这是 spbr* 文件夹的父文件夹。 如果您的计算机安装了 Microsoft SQL Server 2005 以及 Office SharePoint Server 2007 的实例，则可以使用本地驱动器路径。该路径应包括基本安装。但是，如果在多台计算机上安装了 SQL Server 2005 和 Office SharePoint Server 2007，则必须使用通用命名约定 (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 |
一个有效的项目，例如： Web Application\SharePoint-80 |
否 |
指示应还原服务器场的哪一部分。可以使用 -showtree 参数所显示的完整服务器场路径表示法，也可以使用路径中目标组件的名称（如果目标组件具有唯一名称）。如果该项或路径包含空格，请将该项或路径用双引号引起来。如果缺少此参数，则将还原备份包中的所有项。 |
percentage |
1 和 100 之间的整数值。 默认值为 5。 |
否 |
要求以该百分比的增量显示 restore 操作进度更新（例如，值为“5”将以 5% 的增量显示完成的还原进度更新，而值为“10”将以 10% 的增量显示完成的还原进度更新）。 备注 此百分比并不精确，实际进度更新可能比所请求更新慢或快。 对于非常大的数据库，您应使用最佳值 1 才能看到某些显示的更新。 默认值为 5。 |
showtree |
<无> |
否 |
显示根据传递到 stsadm -o restore operation 的所有其他参数应还原备份包中的哪些项。 根据传递给 Restore 操作的其他参数，将从还原中排除的项的前面会有一个星号字符。无法选择还原的项将用方括号 ([ ]) 括起来。如果存在 showtree 参数，则不会执行还原操作 |
suppressprompt |
<无> |
否 |
防止显示以下命令行提示： “Warning: All selected items will be overwritten. Do you want them to be overwritten (Y/N)?” 仅当 restoremethod 参数的值设置为 overwrite 时，此参数才有效。 |
username |
有效的 SQL 身份验证用户名，格式为：username |
否 |
为需要用户名的所有正在还原对象（包括 Web 应用程序池）设置相同的用户名。如果还原整个服务器场，则此参数只能由使用 Windows 身份验证连接到数据库的服务器场使用。如果仅还原数据库，则您可能需要提供一个 SQL Server 2005 登录名。 |
password |
否 |
为需要密码的所有正在还原对象（包括 Web 应用程序池）设置相同的密码。如果还原整个服务器场，则此参数只能由通过 SQL Server 2005 使用 Windows 身份验证连接到数据库的服务器场使用。如果仅还原数据库，则您可能需要提供一个 SQL Server 2005 登录密码。 |
|
newdatabaseserver |
有效的数据库服务器名称，例如“SQLBE1” |
否 |
指示当 restoremethod 参数的值为 new 时，还原任意数据库时应使用的 SQL Server 2005 的实例名称。当 restoremethod 参数的值为 overwrite 时，此参数无效。 默认情况下，将要求您为每个数据库提供一个新数据库服务器名称。 |
preservechangelog |
<无> |
否 |
保留更改日志，以便在下一次对此内容数据库爬网时不进行完全爬网。Microsoft Office Server 的基础结构更新中第一次引入了此参数。有关详细信息，请参阅“备注”。 |
quiet |
<无> |
否 |
禁止将还原进度信息输出到显示窗口。最终还原状态（“操作成功完成。”）仍将显示。如果缺少 -quiet 参数，restore 操作将在其还原包时将进度信息显示到显示窗口。 |
备注
如果运行的是 Microsoft Office Server 的基础结构更新，则当您使用内置工具还原或重新附加数据库时，将保留每个内容数据库的标识符 (ID)。使用内置工具时的默认更改日志保留行为如下所示：
还原服务器场时，保留所有数据库的更改日志。
重新附加数据库时，保留内容数据库的更改日志。
仅还原内容数据库时，不保留内容数据库的更改日志。就是在这种情况下您将使用 preservechangelog 参数。
当保留数据库 ID 和更改日志时，搜索将根据爬网规则定义的定期计划继续爬网。当不保留更改日志时，搜索将在下一个预定爬网过程中执行完全爬网。
有关详细信息，请参阅移动内容数据库 (Office SharePoint Server 2007) 和备份和还原整个服务器场 (Office SharePoint Server 2007)。
如果在还原现有数据库时，不将带有 overwrite 选项的 –restoremethod 参数与 stsadm –o restore 操作一起使用，则会为还原的数据库分配一个新的 ID，并且不保留数据库更改日志。下次对数据库爬网时，将对内容数据库编制完整索引。
如果执行还原并且备份包中的 ID 在服务器场中已被使用（例如，您在尝试将一个数据库分割为两个），则会为还原的数据库分配一个新 ID，并向还原日志中添加一条警告。能否执行增量爬网（而不是完全爬网）取决于内容数据库 ID 是否与以前相同，并且搜索使用的更改日志标记对于内容数据库中的当前更改日志是否有效。如果未保留更改日志，则该标记将无效，并且搜索将必须执行完全爬网。