AFUtil.exe 公用程式

AFUtil.exe 公用程式是用來掃描您的備份工作階段，並確認備份資料的完整性。使用前這個公用程式應放置於 CA ARCserve D2D 的 Bin 資料夾中。執行這個公用程式時若沒有任何參數，按預設它將決定已配置的備份目標，並掃描 CA ARCserve D2D 所保護的所有機器上最舊的 [完整備份]。不過，強烈建議您掃描所有的備份映像，以確保來自這些復原點的資料都能夠還原。

使用

AFUtil [<-|/><switch> [參數]]

附註：為了確保每次都能掃描每個映像，請依照第二個範例所述使用 /sid 參數。您必須為每個工作階段執行一次公用程式。

範例：

執行下列命令以掃描最舊的基礎工作階段：
```
AFUtil
```

執行下列命令以掃描第五個備份工作階段：

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

執行下列命令以掃描所有連接到 Host-Based VM Backup 伺服器備份 Proxy 系統的 VM 之最舊的完整備份：
```
AFUtil.exe /AFStor /vm
```

以下是 AFUtili.exe 公用程式支援的命令：

命令	說明
/?	顯示所有支援的命令之清單。
/help	顯示所有支援的命令之清單。
/AFStor	工作階段相關命令。

以下是 AFStor 命令支援的參數：

附註：您可以使用 "AFUtil.exe /? 以檢視所有支援參數的清單。 AFStor" 命令。

參數	說明
/dest <destination_path>	要掃描的備份目標資料夾。按預設，公用程式將嘗試從已配置的 CA ARCserve D2D 設定決定備份路徑。若尚未配置設定，或您希望掃描不同的路徑，即可使用這個參數。附註：包含空格的路徑名稱應以雙括號括住。
/un <使用者名稱>	使用這個使用者名稱以連接到遠端目標。按預設，使用者名稱是從 CA ARCserve D2D 備份設定擷取得來。若使用不同的憑證連接到遠端目標，可以使用這個參數。
/upwd <密碼>	使用這個密碼以連接到遠端目標。按預設，密碼是從 CA ARCserve D2D 備份設定擷取得來。若使用不同的憑證連接到遠端目標，可以使用這個參數。
/vhd <D2D 檔>	使用這個檔案名稱以掃描特定的 CA ARCserve D2D 檔案。這個參數需要有要掃描的 CA ARCserve D2D 檔案的完整路徑與名稱。這個參數不能結合 '/dest' 參數一起使用。附註：包含空格的路徑名稱應以雙括號括住。
/pwd <密碼>	使用提供的密碼以將工作階段解密。按預設，如果公用程式是在執行備份所在的機器上執行，則公用程式將嘗試從 CA ARCserve D2D 檔案讀取密碼。如果公用程式無法自動讀取加密密碼，則這個參數可以用來指定一個密碼。
/offset <起始位移>	從指定位移值開始掃描。位移值必須以位元組為單位指定。有效範圍為 0 到磁碟的大小。如果未指定這個參數，掃描從位移 0 開始。
/sid <工作階段編號>	掃描指定的工作階段編號。如果未指定這個參數，公用程式僅會掃描最舊的基礎工作階段。
/size <大小>	待掃描來源資料的大小 (位元組)。如果未指定這個參數，公用程式會掃描整個磁碟。
/vm [VM UUID]	用於依據 VM 的特定 UUID，掃描 Host-Based Backup VM 伺服器的備份 Proxy 系統。若未指定 VM 的 UUID，則將逐一掃描由 CA ARCserve D2D Proxy 保護的所有 VM 上的最舊的完整備份。

傳回值

若成功執行 AFUtil.exe 公用程式，傳回值為 0。若執行這個公用程式期間發生任何錯誤，則傳回值不是 0。

下表包含嘗試執行這個公用程式期間所有可能的錯誤代碼以及對應的說明。

傳回值/代碼	說明
SCAN_RET_ENV_ERROR 0xE0000001	嘗試在未安裝 CA ARCserve D2D 的機器上執行公用程式。當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。
SCAN_RET_ACT_JOB 0xE0000002	嘗試執行這個公用程式，但同時有一個使用中的工作正在執行中 (例如備份或合併工作)。當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。
SCAN_RET_NET_ERROR 0xE0000003	無法連線到指定的目標資料夾，因為有錯誤的目標路徑、使用者名稱或密碼。當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。
SCAN_RET_WEB_RUN 0xE0000004	嘗試執行這個公用程式，但 CA ARCserve D2D Web 服務仍在執行中。必須停止 CA ARCserve D2D Web 服務後才能執行這個公用程式。當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。
SCAN_RET_DATA_BAD 0xE0000005	掃描備份工作階段期間，公用程式偵測到資料毀損。發生這個錯誤時掃描不會立即中止，而是繼續執行直到整個工作階段完成為止。將顯示錯誤訊息，且包含一個項目在活動日誌中。有關這個錯誤的詳細偵錯資訊，請於偵錯日誌中搜尋 "<<!data corruption detected!>>"。
SCAN_RET_INVALID_UUID 0xE0000006	嘗試執行這個公用程式，但指定的 VM UUID 無效。當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。
SCAN_RET_INVALID_DEST 0xE0000007	嘗試執行這個公用程式，但找不到有效的目標資料夾以供掃描。當發生這個錯誤時，掃描將立即中止。
SCAN_RET_INVALID_CMD 0xDFFFFFFF	嘗試執行這個公用程式，但執行工具時輸入了無效的參數，顯示一個說明訊息。
其他非 0 值	有關這個錯誤的其他詳細資訊，請參見位於 CA ARCserve D2D 安裝路徑中 [日誌檔] 資料夾的 AFUtil.log。傳回這個值時掃描不會立即中止。掃描工作將繼續執行，直到掃描所有磁碟為止 (不管成功與否)。

傳回值/代碼

說明

SCAN_RET_ENV_ERROR

0xE0000001

嘗試在未安裝 CA ARCserve D2D 的機器上執行公用程式。

當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。

SCAN_RET_ACT_JOB

0xE0000002

嘗試執行這個公用程式，但同時有一個使用中的工作正在執行中 (例如備份或合併工作)。

當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。

SCAN_RET_NET_ERROR

0xE0000003

無法連線到指定的目標資料夾，因為有錯誤的目標路徑、使用者名稱或密碼。

當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。

SCAN_RET_WEB_RUN

0xE0000004

嘗試執行這個公用程式，但 CA ARCserve D2D Web 服務仍在執行中。必須停止 CA ARCserve D2D Web 服務後才能執行這個公用程式。

當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。

SCAN_RET_DATA_BAD

0xE0000005

掃描備份工作階段期間，公用程式偵測到資料毀損。

發生這個錯誤時掃描不會立即中止，而是繼續執行直到整個工作階段完成為止。將顯示錯誤訊息，且包含一個項目在活動日誌中。有關這個錯誤的詳細偵錯資訊，請於偵錯日誌中搜尋 "<<!data corruption detected!>>"。

SCAN_RET_INVALID_UUID

0xE0000006

嘗試執行這個公用程式，但指定的 VM UUID 無效。

當發生這個錯誤且顯示錯誤訊息時，掃描將立即中止。

SCAN_RET_INVALID_DEST

0xE0000007

嘗試執行這個公用程式，但找不到有效的目標資料夾以供掃描。

當發生這個錯誤時，掃描將立即中止。

SCAN_RET_INVALID_CMD

0xDFFFFFFF

嘗試執行這個公用程式，但執行工具時輸入了無效的參數，顯示一個說明訊息。

其他非 0 值

有關這個錯誤的其他詳細資訊，請參見位於 CA ARCserve D2D 安裝路徑中 [日誌檔] 資料夾的 AFUtil.log。

傳回這個值時掃描不會立即中止。掃描工作將繼續執行，直到掃描所有磁碟為止 (不管成功與否)。