傳回碼

  • 發行項

本主題討論 使用者狀態移轉工具 (USMT) 5.0 傳回碼與錯誤訊息，並且提供表格，其中列出 USMT 的傳回碼以及相關聯的安全防護步驟。此外，本主題提供各種秘訣，幫助您使用記錄檔判斷發生錯誤的原因。

了解執行 USMT 的需求，有助於減少 USMT 移轉發生錯誤的機率。如需詳細資訊，請參閱USMT 需求

在本主題中

USMT 傳回碼

USMT 錯誤訊息

疑難排解傳回碼與錯誤訊息

USMT 傳回碼

如果在 USMT 移轉中發現錯誤，您可以使用傳回碼以及相關聯的 USMT 錯誤訊息中所提供更明確的資訊，對問題進行疑難排解並識別安全防護功能的步驟。

傳回碼會分組成下列各大類別，以描述所屬的錯誤報告區域：

  • 成功或使用者取消

  • 命令列無效

  • 安裝與初始設定

  • 非嚴重錯誤

  • 嚴重錯誤

我們所建議的最佳做法是在 ScanState、LoadState 和 UsmtUtils 命令列上設定詳細資訊等級 5 (/v*:5*)，以便在個別 USMT 記錄中呈現最詳細的報告。如果您要將記錄檔輸出到偵錯工具，則可以使用較高的詳細資訊等級。

USMT 錯誤訊息

錯誤訊息提供的移轉問題相關資訊會比相關聯的傳回碼更為詳盡。例如，ScanState、LoadState 或 UsmtUtils 工具的傳回碼可能為 "11” (“USMT_INVALID_PARAMETERS")，而相關的錯誤訊息則為「已同時指定 /key 和 /keyfile」。錯誤訊息會顯示在命令提示字元中，而且會在 ScanState、LoadState 或 UsmtUtils 記錄檔中識別出來，以協助您判斷收到傳回碼的原因。

您可以在命令列中輸入 net helpmsg，然後輸入錯誤碼的號碼，即可取得任何所列出 Windows 應用程式開發介面 (API) 系統錯誤碼的相關資訊。如需「系統錯誤碼」的相關資訊，請參閱這個 Microsoft 網站。

疑難排解傳回碼與錯誤訊息

下表會依數值列出每個傳回碼，以及相關聯的錯誤訊息與建議的疑難排解動作。

傳回碼值 傳回碼 錯誤訊息 疑難排解、安全防護、因應措施 類別

0

USMT_SUCCESS

Successful run

不適用

成功或取消

1

USMT_DISPLAY_HELP

Command line help requested

不適用

成功或取消

2

USMT_STATUS_CANCELED

Gather was aborted because of an EFS file

不適用

User chose to cancel (such as pressing CTRL+C)

不適用

成功或取消

3

USMT_WOULD_HAVE_FAILED

At least one error was skipped as a result of /c

如需命令列錯誤的詳細資料，請檢閱 ScanState、LoadState 或 UsmtUtils 記錄。

11

USMT_INVALID_PARAMETERS

/all conflicts with /ui, /ue or /uel

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/auto expects an optional parameter for the script folder

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/encrypt can't be used with /nocompress

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/encrypt requires /key or /keyfile

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/genconfig can't be used with most other options

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/genmigxml can't be used with most other options

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/hardlink requires /nocompress

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/key and /keyfile both specified

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/key or /keyfile used without enabling encryption

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/lae is only used with /lac

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/listfiles cannot be used with /p

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/offline requires a valid path to an XML file describing offline paths

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/offlinewindir requires a valid path to offline windows folder

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

/offlinewinold requires a valid path to offline windows folder

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

A command was already specified

檢查命令列語法是否正確而且沒有重複的命令。

An option argument is missing

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

An option is specified more than once and is ambiguous

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

By default /auto selects all users and uses the highest log verbosity level.Switches like /all, /ui, /ue, /v are not allowed.

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Command line arguments are required.Specify /?for options.

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Command line option is not valid

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

EFS parameter specified is not valid for /efs

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

File argument is invalid for /genconfig

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

File argument is invalid for /genmigxml

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Invalid space estimate path.Check the parameters and/or file system permissions

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

List file path argument is invalid for /listfiles

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Retry argument must be an integer

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Settings store argument specified is invalid

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。請確定可以存取存放區路徑，並且已設定適當的權限等級。

Specified encryption algorithm is not supported

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

The /efs:hardlink requires /hardlink

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

The /targetWindows7 option is only available for Windows XP, Windows Vista®, and Windows 7

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

The store parameter is required but not specified

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

The source-to-target domain mapping is invalid for /md

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

The source-to-target user account mapping is invalid for /mu

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Undefined or incomplete command line option

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

命令列無效

Use /nocompress, or provide an XML file path with /p"pathtoafile" to get a compressed store size estimate

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

User exclusion argument is invalid

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Verbosity level must be specified as a sum of the desired log options: Verbose (0x01), Record Objects (0x04), Echo to debug port (0x08)

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Volume shadow copy feature is not supported with a hardlink store

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Wait delay argument must be an integer

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

12

USMT_ERROR_OPTION_PARAM_TOO_LARGE

Command line arguments cannot exceed 256 characters

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

命令列無效

Specified settings store path exceeds the maximum allowed length of 256 characters

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

13

USMT_INIT_LOGFILE_FAILED

Log path argument is invalid for /l

在 ScanState 命令列中指定 /l 時，USMT 會驗證路徑。請驗證磁碟機與其他資訊 (例如，檔案系統字元) 皆正確無誤。

命令列無效

14

USMT_ERROR_USE_LAC

Unable to create a local account because /lac was not specified

建立本機帳戶時，應該使用命令列選項 /lac 和 /lae。

命令列無效

26

USMT_INIT_ERROR

Multiple Windows installations found

無法建立 Listfiles.txt。請確定您對建立此檔案所指定的位置是否有效。

安裝與初始設定

Software malfunction or unknown exception

請檢查所有已載入之 .xml 檔案的錯誤，以及使用 /I 載入 Config.xml 檔案時常見的錯誤。

Unable to find a valid Windows directory to proceed with requested offline operation; Check if offline input file is present and has valid entries

請確定離線輸入檔存在，且該檔案具備有效的項目。USMT 找不到有效的離線作業系統。請驗證離線目錄對應。

27

USMT_INVALID_STORE_LOCATION

A store path can't be used because an existing store exists; specify /o to overwrite

請指定 /o 以覆寫現有的中繼存放區或移轉存放區。

安裝與初始設定

A store path is missing or has incomplete data

請確定可以存取存放區路徑，並且已設定適當的權限等級。

An error occurred during store creation

請確定可以存取存放區路徑，並且已設定適當的權限等級。請指定 /o 以覆寫現有的中繼存放區或移轉存放區。

An inappropriate device such as a floppy disk was specified for the store

請確定可以存取存放區路徑，並且已設定適當的權限等級。

無效的存放區路徑；請檢查存放區參數和/或檔案系統權限

Invalid store path; check the store parameter and/or file system permissions

The file layout and/or file content is not recognized as a valid store

請確定可以存取存放區路徑，並且已設定適當的權限等級。請指定 /o 以覆寫現有的中繼存放區或移轉存放區。

The store path holds a store incompatible with the current USMT version

請確定可以存取存放區路徑，並且已設定適當的權限等級。

The store save location is read-only or does not support a requested storage option

請確定可以存取存放區路徑，並且已設定適當的權限等級。

28

USMT_UNABLE_GET_SCRIPTFILES

Script file is invalid for /i

請檢查所有指定的移轉 .xml 檔案中是否有錯誤。這是使用 /I 載入 Config.xml 檔案時的常見錯誤。

安裝與初始設定

Unable to find a script file specified by /i

請驗證指令檔的位置，並確定命令列選項正確無誤。

29

USMT_FAILED_MIGSTARTUP

A minimum of 250 MB of free space is required for temporary files

請驗證系統符合 250 MB 暫存磁碟空間下限的需求。您可以設定環境變數 USMT_WORKING_DIR=<path>，重新導向暫存檔案工作目錄，做為因應措施。

安裝與初始設定

Another process is preventing migration; only one migration tool can run at a time

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤。

Failed to start main processing, look in log for system errors or check the installation

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤。

Migration failed because of an XML error; look in the log for specific details

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤。

Unable to automatically map the drive letters to match the online drive letter layout; Use /offline to provide a mapping table

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤。

31

USMT_UNABLE_FINDMIGUNITS

An error occurred during the discover phase; the log should have more specific information

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤。

安裝與初始設定

32

USMT_FAILED_SETMIGRATIONTYPE

An error occurred processing the migration system

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤，或者在命令列上輸入 /? 使用線上說明。

安裝與初始設定

33

USMT_UNABLE_READKEY

Error accessing the file specified by the /keyfile parameter

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤，或者在命令列上輸入 /?使用線上說明。

安裝與初始設定

The encryption key must have at least one character

請檢查 ScanState 記錄檔中是否有移轉 .xml 檔案錯誤，或者在命令列上輸入 /?使用線上說明。

34

USMT_ERROR_INSUFFICIENT_RIGHTS

Directory removal requires elevated privileges

以系統管理員身分登入，然後以較高的權限執行。

安裝與初始設定

No rights to create user profiles; log in as Administrator; run with elevated privileges

以系統管理員身分登入，然後以較高的權限執行。

No rights to read or delete user profiles; log in as Administrator, run with elevated privileges

以系統管理員身分登入，然後以較高的權限執行。

35

USMT_UNABLE_DELETE_STORE

A reboot is required to remove the store

重新開機以刪除當命令執行時無法刪除的任何檔案。

安裝與初始設定

A store path can't be used because it contains data that could not be overwritten

無法刪除移轉存放區。如果使用永久連結移轉存放區，其中可能含有鎖定的檔案。您應手動刪除存放區，或使用 usmtutils /rd 命令來刪除存放區。

There was an error removing the store

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

36

USMT_ERROR_UNSUPPORTED_PLATFORM

Compliance check failure; please check the logs for details

請調查系統上是否有使用中的暫存設定檔。

安裝與初始設定

Use of /offline is not supported during apply

在 Windows 預先安裝環境 (Windows PE) 中執行時，不會使用 /offline 命令。

Use /offline to run gather on this platform

在 Windows PE 中執行時，不會使用 /offline 命令。

37

USMT_ERROR_NO_INVALID_KEY

The store holds encrypted data but the correct encryption key was not provided

請驗證已包含正確的加密 /key 或 /keyfile。

安裝與初始設定

38

USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE

An error occurred during store access

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。請確定可以存取存放區路徑，並且已設定適當的權限等級。

安裝與初始設定

39

USMT_UNABLE_TO_READ_CONFIG_FILE

Error reading Config.xml

如需 Config.xml 檔案中命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

安裝與初始設定

File argument is invalid for /config

請檢查您用來載入 Config.xml 檔案的命令列。 您可以在命令列上輸入 /? 使用線上說明。

40

USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG

Error writing to the progress log

無法建立進度記錄。請驗證位置有效而且您具有寫入權限。

安裝與初始設定

Progress log argument is invalid for /progress

無法建立進度記錄。請驗證位置有效而且您具有寫入權限。

41

USMT_PREFLIGHT_FILE_CREATION_FAILED

Can't overwrite existing file

無法建立進度記錄。請驗證位置有效而且您具有寫入權限。

安裝與初始設定

Invalid space estimate path.Check the parameters and/or file system permissions

如需命令列錯誤的詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

42

USMT_ERROR_CORRUPTED_STORE

The store contains one or more corrupted files

如需損毀之檔案的詳細資料，請檢閱 UsmtUtils 記錄。如需如何擷取未損毀檔案的詳細資訊，請參閱從壓縮 USMT 移轉存放區擷取檔案。

61

USMT_MIGRATION_STOPPED_NONFATAL

Processing stopped due to an I/O error

USMT 已結束，但可以透過選擇性可以設定的 <ErrorControl> 區段，或者使用 /vsc 命令列選項來繼續使用 /c 命令列選項。

非嚴重錯誤

71

USMT_INIT_OPERATING_ENVIRONMENT_FAILED

A Windows Win32 API error occurred

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。 如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

嚴重錯誤

An error occurred when attempting to initialize the diagnostic mechanisms such as the log

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Failed to record diagnostic information

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Unable to start.Make sure you are running USMT with elevated privileges

結束 USMT 後再使用較高的權限登入。

72

USMT_UNABLE_DOMIGRATION

An error occurred closing the store

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

嚴重錯誤

An error occurred in the apply process

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

An error occurred in the gather process

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Out of disk space while writing the store

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

Out of temporary disk space on the local system

已開始資料傳輸，而在建立移轉存放區或套用階段期間發生錯誤。如需詳細資料，請檢閱 ScanState 記錄或 LoadState 記錄。

另請參閱

其他資源

使用者狀態遷移工具 (USMT) 疑難排解
記錄檔