AFUtil.exe 实用工具

AFUtil.exe 实用工具用于扫描 Arcserve UDP 备份会话，以便确认已备份数据的完整性。使用该实用工具之前，应将其放在 Arcserve UDP 安装的“Bin”文件夹中。如果未使用任何参数执行该实用工具，默认情况下，它将确定配置的备份目标，并扫描 Arcserve UDP 保护的所有计算机的最早完全备份会话。不过，强烈建议扫描所有备份映像，以确保来自这些恢复点的数据都可还原。

注意：仅当备份数据格式设置为标准格式时，AFUtil.exe 实用工具才适用。

用法

AFUtil [<-|/><选项> [参数]]

注意：要确保每一映像都得到扫描，请使用 /sid 选项，如第二个示例所示。您将必须每个会话运行一次该实用工具。

示例：

运行以下命令以扫描最旧的基本会话：
```
AFUtil
```

运行以下命令以扫描第五个备份会话：

AFUtil.exe /AFStor /dest <destination_path> /un <username> /upwd <password> /sid 5

运行以下命令以扫描与 Host-Based VM Backup 服务器的备份代理系统连接的所有 VM 的最早完整备份：
```
AFUtil.exe /AFStor /vm
```

AFUtili.exe 实用工具支持以下命令：

命令	说明
/?	显示所有支持的命令的列表。
/help	显示所有支持的命令的列表。
/AFStor	会话相关的命令

AFStor 命令支持以下选项：

注意：您可以使用 "AFUtil.exe / AFStor" 命令查看所有支持的选项列表。

选项	说明
/dest <destination_path>	要扫描的备份目标文件夹。默认情况下，实用工具将尝试从配置的 Arcserve UDP 设置确定备份路径。如果未配置设置，或想扫描不同的路径，可使用此选项。注意：如果路径名中有空格，应使用双引号将路径名引起。
/un <username>	使用此用户名连接到远程目标。默认情况下，将从 Arcserve UDP 备份设置检索该用户名。如果要使用不同的凭据连接到远程目标，可以使用此选项。
/upwd <密码>	使用此密码连接到远程目标。默认情况下，将从 Arcserve UDP 备份设置检索该密码。如果要使用不同的凭据连接到远程目标，可以使用此选项。
/vhd <D2D 文件>	使用该选项可扫描特定 Arcserve UDP 文件。此选项要求提供要扫描文件的完整路径和名称。此选项不能与“/dest”选项一起使用。注意：如果路径名中有空格，应使用双引号将路径名引起。
/pwd <密码>	使用提供的密码来解密会话。默认情况下，如果在执行备份的计算机上运行实用工具，实用工具将尝试从 Arcserve UDP 文件读取密码。如果实用工具无法自动读取加密密码，那么该选项可用于指定密码。
/offset <起始偏移>	在给定偏移值开始扫描。必须使用字节指定偏移值。有效范围是从 0 到磁盘的大小。如果未指定此参数，扫描则从偏移值 0 开始。
/sid <会话号>	扫描指定的会话号。如果未指定此选项，实用工具将仅扫描最旧的基本会话。
/size <大小>	要扫描的源的数据大小（字节）。如果未指定此参数，实用工具将扫描整个磁盘。
/vm [VM UUID]	用于基于 VM 的指定 UUID 扫描 Host-Based Backup VM 服务器的备份代理系统。如果未指定 VM 的 UUID，则将逐一扫描 Arcserve UDP 代理保护的所有 VM 的最早完全备份。

返回值

如果 AFUtil.exe 实用工具成功运行，返回值则为 0。如果在运行该实用工具的过程中出现任何错误，返回值将不为 0。

下表列出在尝试运行该实用工具时会发生的所有可能错误代码以及相应的说明。

返回值/代码	说明
SCAN_RET_ENV_ERROR 0xE0000001	尝试在未安装 Arcserve UDP 的计算机上运行该实用工具。出现此错误时，扫描将立即被中止，并显示出错误消息。
SCAN_RET_ACT_JOB 0xE0000002	尝试运行了该实用工具，但是有活动的作业正同时运行（如备份或合并作业）。出现此错误时，扫描将立即被中止，并显示出错误消息。
SCAN_RET_NET_ERROR 0xE0000003	由于不正确的目标路径、用户名或密码，导致无法连接到指定的目标文件夹。出现此错误时，扫描将立即被中止，并显示出错误消息。
SCAN_RET_WEB_RUN 0xE0000004	尝试运行该实用工具，但是 Arcserve UDP Web 服务仍在运行。必须先停止 Arcserve UDP Web 服务，才能运行实用工具。出现此错误时，扫描将立即被中止，并显示出错误消息。
SCAN_RET_DATA_BAD 0xE0000005	扫描备份会话时，实用工具检测到数据损坏。出现该错误时扫描未立即中止，而是继续执行，直到整个会话的扫描完成。将显示错误消息，并在活动日志中加入一个条目。有关此错误的更详细调试信息，请在调试日志中搜索“<<!检测到数据损坏!>>”。
SCAN_RET_INVALID_UUID 0xE0000006	尝试运行了该实用工具，但是 VM 的指定 UUID 无效。出现此错误时，扫描将立即被中止，并显示出错误消息。
SCAN_RET_INVALID_DEST 0xE0000007	尝试运行了该实用工具，但是无法找到有效的目标文件夹进行扫描。出现此错误时，扫描立即中止。
SCAN_RET_INVALID_CMD 0xDFFFFFFF	尝试运行了该实用工具，但当运行该工具时，输入的参数无效，并显示出帮助消息。
其他非 0 值	有关此错误的详细信息，请查看位于 Arcserve UDP 安装路径中的 Logs 文件夹下的 AFUtil.log。返回此值时，扫描将不会立即中止。扫描将继续，直到所有磁盘得到扫描，无论成功与否。

返回值/代码

说明

SCAN_RET_ENV_ERROR

0xE0000001

尝试在未安装 Arcserve UDP 的计算机上运行该实用工具。

出现此错误时，扫描将立即被中止，并显示出错误消息。

SCAN_RET_ACT_JOB

0xE0000002

尝试运行了该实用工具，但是有活动的作业正同时运行（如备份或合并作业）。

出现此错误时，扫描将立即被中止，并显示出错误消息。

SCAN_RET_NET_ERROR

0xE0000003

由于不正确的目标路径、用户名或密码，导致无法连接到指定的目标文件夹。

出现此错误时，扫描将立即被中止，并显示出错误消息。

SCAN_RET_WEB_RUN

0xE0000004

尝试运行该实用工具，但是 Arcserve UDP Web 服务仍在运行。必须先停止 Arcserve UDP Web 服务，才能运行实用工具。

出现此错误时，扫描将立即被中止，并显示出错误消息。

SCAN_RET_DATA_BAD

0xE0000005

扫描备份会话时，实用工具检测到数据损坏。

出现该错误时扫描未立即中止，而是继续执行，直到整个会话的扫描完成。将显示错误消息，并在活动日志中加入一个条目。有关此错误的更详细调试信息，请在调试日志中搜索“<<!检测到数据损坏!>>”。

SCAN_RET_INVALID_UUID

0xE0000006

尝试运行了该实用工具，但是 VM 的指定 UUID 无效。

出现此错误时，扫描将立即被中止，并显示出错误消息。

SCAN_RET_INVALID_DEST

0xE0000007

尝试运行了该实用工具，但是无法找到有效的目标文件夹进行扫描。

出现此错误时，扫描立即中止。

SCAN_RET_INVALID_CMD

0xDFFFFFFF

尝试运行了该实用工具，但当运行该工具时，输入的参数无效，并显示出帮助消息。

其他非 0 值

有关此错误的详细信息，请查看位于 Arcserve UDP 安装路径中的 Logs 文件夹下的 AFUtil.log。

返回此值时，扫描将不会立即中止。扫描将继续，直到所有磁盘得到扫描，无论成功与否。