Veritas NetBackup™ 命令参考指南

指定数据将从存档 (-A)、备份 (-B) 还是快照回滚 (-rb) 还原。默认值为 -B。

指定门户名称、工作组站点名称或 Exchange 2010 重定向路径名称，选定的门户或工作组站点将重定向到 SharePoint 服务器场中的该位置。用户应将被重定向的门户或工作组站点指定为 http://portalname | http://teamsitename，并且被重定向的门户或工作组站点应该已存在于一个服务器场中。

指定客户端名称，以查找用于从中还原文件的备份或存档。该名称必须与它在 NetBackup 目录库中显示的名称相同。其默认值是当前客户端的名称。

使还原操作能够遍历日志文件并回滚所有未完成的事务。如果您的选择包含要还原的最后一个备份，请使用此选项。如果没有选择此选项，则数据库将保留为中间状态，尚不可用。

指定要用于还原的副本号。用户可以从主副本以外的其他副本进行还原。例如，-copy 3 将还原文件或文件列表的副本 3。

另外，可以在全局级别（适用于所有还原操作）指定要从其还原的副本。将副本编号放置在文件 ALT_RESTORE_COPY_NUMBER 中。

有关完整描述，请参考“NetBackup 备份、存档和还原”联机帮助中的“从特定的备份副本还原”。

指定目标客户端。其默认值是当前客户端的名称。

在 UNIX 系统上，主服务器 root 用户可以使用此选项执行以下操作：将已还原的文件定向至 -C 选项指定的客户端之外的其他计算机。

在 Windows 系统上，主服务器管理员可以使用此选项执行以下操作：将已还原的文件定向至 -C 选项指定的客户端之外的其他计算机。

标识要用于还原操作的磁盘介质服务器。默认为当前正在使用的服务器。

还原文件时不包括访问控制属性。默认情况下，会将访问控制属性与文件和目录数据一起还原。选项 -drs 仅对 NetBackup 管理员可用。

从 Enterprise Vault 还原迁移的数据。bprestore -ev_migrated_data 不支持从非 Enterprise Vault 源还原迁移的数据。根据需要使用其他 bprestore 参数。

以下示例使用 NDMP 策略类型将迁移的数据从 Vault1 还原到主服务器 ms1。文件 restorefiles 中列出了要还原的文件。

# bprestore -S ms1 -C Vault1 -t 19 -ev_migrated_data restorefiles 

指定一个文件 (listfile)，其中包含要还原的文件列表，且可以不用 filenames 选项来使用该文件。在 listfile 中列出所有文件路径，每个路径必须单独占一行。

文件列表所要求的格式取决于文件名称中是否包含空格或换行符。

要还原名称中不包含空格或换行符的文件，请使用以下格式：

filepath           

其中，filepath 是要还原的文件的路径。例如：

UNIX 系统：

/home /etc /var

Windows 系统：

C:\programs C:\winnt C:\documents\old_memos

要还原名称中包含空格或换行符的文件，请使用以下格式之一：

filepathlen filepath filepathlen filepath start_date_time end_date_time filepathlen filepath -s datetime -e datetime

filepath 是要还原的文件的路径。

filepathlen 是文件路径中的总字符数。

start_date_time 和 end_date_time 是自 01/01/1970 00:00:00 以来的十进制秒数。

datetime 等同于命令行 (mm/dd/yy [hh[:mm[:ss]]])。此命令使用来自命令行的开始日期、结束日期和时间，除非 listfile 中的某行覆盖了此命令。日期在各行之间可能不同。

NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。/usr/openv/msg/.conf 文件 (UNIX) 和 install_path\VERITAS\msg\LC.CONF 文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。

请参见《NetBackup 管理指南，第 II 卷》 中的“关于指定 NetBackup 安装的区域设置”。

要排除在以前的还原操作中包括的文件或目录路径，请在该文件或目录路径前面放置一个惊叹号 (!)。NDMP 和 FlashBackup 还原不支持排除选项。

以下是 filepathlen filepath 的一个使用示例：

UNIX 系统：

5 /home 4 /etc 4 /var 19 /home/abc/test file 12 !/etc/passwd

Windows 系统：

11 C:\programs 8 C:\winnt 22 C:\documents\old memos 17 !C:\programs\test -f filenames

命名一个或多个要还原的文件，可用来代替 -f 选项。

必须将指定的任何文件列在命令行结尾处，位于所有其他选项之后。必须使用绝对文件路径。

要排除在以前的还原操作中包括的文件或目录路径，请在该文件或目录路径前面放置一个惊叹号 (!)。NDMP 和 FlashBackup 还原不支持排除选项。

对于 Windows 系统，驱动器盘符使用大写字母。例如，C:\NetBackup\log1。

允许恢复 NetBackup 文件。

启用 Active Directory 中对象和属性的还原。如果未指定此选项，还原仍会运行，但备份无法生成粒度还原。

如果指定了此选项，卷上的较新快照可能会丢失。此选项仅与回滚还原 (-rb) 选项一起使用。

在还原同名文件时，使 bprestore 保留现有文件，而不是重写它们。默认情况下，将重写现有文件。

将 -K 与回滚 (-rb) 选项一起使用时，意味着在回滚前不执行验证。在创建快照后添加到卷上的文件将丢失。

指定 NetBackup 在搜索用来还原文件的备份或存档时使用的关键字短语。该短语必须与此前和备份或存档相关联的关键字短语匹配，该备份或存档是使用 bpbackup 或 bparchive 命令的 -k 选项创建的。

请使用该选项代替其他还原选项，或者将该选项与其他还原选项结合使用，以便更加轻松地还原备份和存档。以下元字符用于简化与短语中的关键字或部分关键字匹配的任务：

* 匹配任何字符串。

？ 字符匹配任何单个字符。

[ ] 匹配中括号内指定的字符序列中的一个字符。

[ - ] 匹配由 - 分隔的字符范围中的一个字符。

关键字短语的长度最多可达 128 个字符。允许使用所有可打印字符，包括空格 ( ) 和句号 (.)。

短语必须用双引号 ("...") 或单引号 ('...') 括起来。

默认的关键字短语为空字符串。

指定要在其中写入进度信息的现有文件的名称。例如：

UNIX 系统：netbackup/logs/user_ops/proglog

Windows 系统：NetBackup\logs\user_ops\proglog

默认情况下，不使用进度日志。

使用 -en 选项可生成英文的日志条目。日志名称中包含字符串 _en。在分布式环境中，不同的语言环境可能创建不同语言的日志，此时该选项对于支持人员很有用。

仅允许对此选项使用默认路径。Veritas 建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径，应向 NetBackup 配置中添加自定义路径。

有关如何添加自定义路径的更多信息，请参见NetBackup 管理指南，第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。

指定 -l 以使用 -R rename_file 选项重命名 UNIX 链接的目标，其方式与重命名文件时相同。

指定 -H 以使用 -R rename_file 选项重命名 UNIX 硬链接，其方式与重命名文件时相同。软链接保持不变。

指定 -y 以使用 -R rename_file 选项重命名 UNIX 软链接，其方式与重命名文件时相同。硬链接保持不变。

请参见“示例”部分中的示例 5。

启用要监视的客户端作业。

装入数据库供用户使用。仅当选中“还原完成后提交”时，此选项才可用。

指定是否从优化备份执行还原操作。

指定为其执行了备份或存档的策略。

向 stdout 显示 bprestore 命令所启动的还原作业的作业 ID。

指定此选项将还原原始分区（UNIX 系统）或磁盘映像（Windows 系统），而不是文件系统。

为备用路径还原操作指定更改后的文件名。

例如：bprestore -R /C/renamefile /C/origfile

其中 /C/rename_file 是更改名称后的文件，/C/origfile 是要重命名的文件。输入的路径名必须为绝对路径。

重命名文件中的条目使用以下形式：

change backup_filepath to restore_filepath

文件路径必须以 /（斜杠）开头。

第一个匹配的 backup_filepath 将替换为 restore_filepath 字符串。

默认情况下，使用原始路径进行还原。

在 UNIX 系统上：例如，下面的条目将 /usr/fred 重命名为 /usr/fred2：

change /usr/fred to /usr/fred2

在 Windows 系统上：例如，下面的条目将 C:\users\fred 重命名为 C:\users\fred2：

change /C/users/fred to /C/users/fred2

驱动器盘符全部使用大写字母，并用回车键结束该条目。

还原到 Windows 客户端时，还可以使用以下方法来指定重命名文件中的条目。（请勿将此方法用于其他客户端。）

rename bulength backup_filepath reslength restore_filepath

其中：

bulength 是备份路径中 ASCII 字符的数量。

reslength 是还原路径中 ASCII 字符的数量。

第一个匹配的 backup_filepath 将替换为 restore_filepath 字符串。

例如，下面的条目将 C:\fred.txt 重命名为 C:\fred2.txt：

rename 11 /C/fred.txt 12 /C/fred2.txt

（一定要用回车键结束该条目。）

仅允许对此选项使用默认路径。Veritas 建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径，应向 NetBackup 配置中添加自定义路径。

有关如何添加自定义路径的更多信息，请参见NetBackup 管理指南，第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。

指定列表的开始和结束日期范围。bprestore 命令仅从在指定的开始和结束日期范围内创建的备份或存档还原文件。

-s 为还原时段指定开始日期和时间。bprestore 仅从在指定的日期和时间之后（包括此时间）创建的备份或存档还原文件。

NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。/usr/openv/msg/.conf 文件 (UNIX) 和 install_path\VERITAS\msg\LC.CONF 文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。

我们提供了有关您的系统区域设置的更多信息。

请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”。

有效的日期范围为 01/01/1970 00:00:00 到 01/19/2038 03:14:07。默认开始日期为 01/01/1970 00:00:00。

默认情况下返回最新的映像。对于备份，此映像为最新的完全备份（如果存在完全备份）。如果不存在完全备份，则还原最新的增量式备份或用户控制的备份。

-e 为还原时段指定结束日期和时间。bprestore 仅从在指定的日期和时间（或之前）创建的备份或存档还原文件。所用的格式与开始日期和时间的格式相同。

除非针对实际映像还原，否则结束备份的日期和时间不必十分精确（请参见 -T 选项的说明）。bprestore 将还原具有指定备份日期和时间的文件。如果没有指定，它将还原结束日期和时间之前的文件（最新备份）。默认值是当前的日期和时间。

指定 NetBackup 服务器的名称。

在 UNIX 系统上，默认为 /usr/openv/netbackup/bp.conf 文件中的第一个服务器。

在 Windows 系统上，默认为在“指定 NetBackup 计算机”对话框的“服务器”选项卡上被指定为当前服务器的服务器。若要显示此对话框，请在客户端上启动“备份、存档和还原”用户界面。然后在“文件”菜单上单击“指定 NetBackup 计算机”。

对于 SharePoint 操作，-spscurver 仅还原项目的最新版本。

对于 SharePoint 操作，如果已对 SharePoint 场拓扑设置锁定，-spsignorelock 将释放此锁定。

对于 SharePoint 操作，-spspreserveiis 保留现有 Internet 信息服务 (IIS) 网站和应用程序池。

对于 SharePoint 操作，该选项指定 Web 服务器，重定向的门户或工作组站点位于 SharePoint 场中的该服务器上。应将重定向的 Web 服务器指定为 hostname。

对于 SharePoint 操作，-spsrestoresecurity 在还原操作中包括安全信息。

对于 SharePoint 操作，-spsverkeep 指定是否在还原目标上启用版本控制。

指定与策略类型相对应的以下编号之一。Windows 客户端的默认编号是 13，所有其他客户端的默认编号都是 0。

0 = Standard

8 = MS-SharePoint

13 = MS-Windows

16 = MS-Exchange-Server

19 = NDMP

20 = FlashBackup

21 = Split-Mirror

25 = Lotus-Notes

29 = FlashBackup-Windows

30 = Vault

35 = NBU-Catalog

38 = PureDisk-Export

39 = Enterprise-Vault

40 = VMware

41 = Hyper-V

44 = BigData

指定实际映像还原，即仅还原在上次实际映像备份中存在的文件和目录。该选项仅在执行了实际映像备份后才有用。如果未指定该选项，则还原所有符合指定条件的文件和目录，即使它们已被删除也是如此。

如果指定了 -T 选项，则所请求的映像必须具有唯一标识。可以使用具有秒粒度的 -e 选项来实现唯一标识。此时将忽略 -s 选项（如果有）。可以使用带 -l 和 -Listseconds 选项的 bplist 命令来检索映像的秒粒度。

该选项提供一个位置，在还原数据库之前将在此位置保留关联的日志和任何修补文件。如果还原存储组，将在 temp_dir 中为每个存储组创建一个子目录。每个存储组的日志和修补文件保留在相应的子目录中。

在 UNIX 系统上，默认位置为 /temp。

在 Windows 系统上，默认位置是 C:\temp。

对于 Hyper-V 操作，-vhd_dof 指定在失败时是否执行删除操作。可能的值有 1（在失败时删除）和 0（在失败时不删除）。

对于 Hyper-V 操作，-vhd_dsize 指定要恢复的 VHD 文件的大小。

对于 Hyper-V 操作，-vhd_fn 指定要恢复的 VHD 文件的名称。

对于 Hyper-V 操作，-vhd_type 指定 VHD 文件的类型。此选项的可能值如下所示：

1 - 固定。

2 - 动态。

使 NetBackup 在返回到系统提示符状态之前等待来自服务器的完成状态。

NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。/usr/openv/msg/.conf 文件 (UNIX) 和 install_path\VERITAS\msg\LC.CONF 文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。

我们提供了有关您的系统区域设置的更多信息。

请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”。

可以选择用小时、分钟和秒的形式来指定等待时间。可以指定的最长等待时间是 23:59:59。如果等待时间在还原完成前过期，则该命令以超时状态退出。但仍会在服务器上完成还原操作。

如果指定 0 或者未指定时间，则将无限期等待完成状态。