USMT (用戶狀態移轉工具) 傳回碼
本文說明 USMT 10.0 傳回碼和錯誤訊息。 也包含一份表格，其中列出USMT傳回碼及其相關聯的風險降低步驟。 此外，本文提供提示，協助您使用記錄檔來判斷您收到錯誤的原因。
瞭解執行 USMT 的需求有助於將 USMT 移轉中的錯誤降至最低。 如需詳細資訊，請參閱 USMT 需求。
傳回 USMT 所使用的代碼
如果您在 USMT 移轉時遇到錯誤，您可以使用傳回碼和相關聯的 USMT 錯誤訊息中提供的更具體資訊，來針對問題進行疑難解答，並找出緩和步驟。
傳回碼會分組為下列廣泛類別，描述其錯誤報告區域：
成功或使用者取消
無效的命令行
安裝和初始化
非嚴重錯誤
嚴重錯誤
最佳做法是，建議您在ScanState.exe、 v:5LoadState.exe 和UsmtUtils.exe 命令行上將詳細資訊層級設定為 5，以便在個別的 USMT 記錄中提供最詳細的報告。 如果您想要將記錄檔輸出移至調試程式，可以使用較高的詳細資訊層級。
USMT 錯誤訊息
與相關聯的傳回碼相比，錯誤訊息會提供有關移轉問題的更詳細資訊。 例如，ScanState、LoadState 或 UsmtUtils 工具可能會針對USMT_INVALID_PARAMETERS) 傳回 11 (的程式代碼，以及同時讀取 /key 和 /keyfile 的相關錯誤訊息。 錯誤訊息會顯示在命令提示字元中，並在 ScanState、 LoadState 或 UsmtUtils 記錄檔中識別，以協助您判斷收到傳回碼的原因。
您可以在命令提示字元視窗net.exe helpmsg <error_number>中輸入 ，其中<error_number>是錯誤訊息所產生的錯誤碼編號，以取得任何列出之 Windows 系統錯誤碼的詳細資訊。 如需系統錯誤碼的詳細資訊，請 參閱系統錯誤碼 (0-499) 。
針對傳回碼和錯誤訊息進行疑難解答
下列資訊會依數值列出每個傳回碼，以及相關聯的錯誤訊息和建議的疑難解答動作。
0：USMT_SUCCESS
- 類別：成功或使用者取消
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 成功執行 | NA |
1：USMT_DISPLAY_HELP
- 類別：成功或使用者取消
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 要求命令行說明 | NA |
2：USMT_STATUS_CANCELED
- 類別：成功或使用者取消
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 收集因 EFS 檔案而中止 | NA |
| 用戶選擇取消 (，例如按 CTRL+C) | NA |
3：USMT_WOULD_HAVE_FAILED
- 類別：
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 至少有一個錯誤因為 /c 而略過。 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState、LoadState 或 UsmtUtils 記錄。 |
11：USMT_INVALID_PARAMETERS
- 類別：無效的命令行
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| /all 與 /ui、/ue 或 /uel 衝突 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /auto 需要腳本資料夾的選擇性參數 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /encrypt 無法與 /nocompress 搭配使用 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /encrypt 需要 /key 或 /keyfile | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /genconfig 無法搭配大部分其他選項使用 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /genmigxml 無法搭配大部分其他選項使用 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /hardlink 需要 /nocompress | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 同時指定 /key 和 /keyfile | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /key 或 /keyfile 未啟用加密 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /lae 僅與 /lac 搭配使用 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /listfiles 無法搭配 /p 使用 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /offline 需要描述離線路徑之 XML 檔案的有效路徑 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /offlinewindir 需要離線 Windows 資料夾的有效路徑 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /offlinewinold 需要離線 Windows 資料夾的有效路徑 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 已指定命令 | 確認命令行語法正確無誤，而且沒有重複的命令。 |
| 遺漏選項自變數 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 選項已指定一次以上，而且模棱兩可 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 根據預設，/auto 會選取所有使用者，並使用最高的記錄詳細資訊層級。 不允許像是 /all、/ui、/ue、/v 之類的參數。 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 需要命令行自變數。 指定/？ 適用於選項。 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 命令列選項無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 指定的 EFS 參數對 /efs 無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /genconfig 的檔案自變數無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /genmigxml 的檔案自變數無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 無效的空間估計路徑。 檢查參數和/或檔案系統許可權 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 清單檔案路徑自變數對 /listfiles 無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 重試自變數必須是整數 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 指定的設定存放區自變數無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 請確定可存取存放區路徑，並已設定適當的許可權等級。 |
| 不支援指定的加密演算法 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /efs：hardlink 需要 /hardlink | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| /targetWindows7 選項僅適用於 Windows XP、Windows Vista 和 Windows 7 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 存放區參數是必要參數，但未指定 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 來源對目標網域對應對 /md 無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 來源對目標用戶帳戶對應對 /mu 無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 未定義或不完整的命令行選項 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 使用 /nocompress，或使用 /p“pathtoafile” 提供 XML 檔案路徑，以取得壓縮的存放區大小估計 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 使用者排除自變數無效 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 詳細資訊層級必須指定為所需記錄選項的總和：詳細資訊 (0x01) 、記錄物件 (0x04) 、偵錯埠的回應 (0x08) | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 硬式連結存放區不支援磁碟區陰影複製功能 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 等候延遲自變數必須是整數 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
12：USMT_ERROR_OPTION_PARAM_TOO_LARGE
- 類別：無效的命令行
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 命令行自變數不能超過 256 個字元 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 指定的設定存放區路徑超過允許的最大長度 256 個字元 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
13：USMT_INIT_LOGFILE_FAILED
- 類別：無效的命令行
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 記錄路徑自變數對 /l 無效 | 在 ScanState 命令行中指定時 /l ，USMT 會驗證路徑。 確認磁碟驅動器和其他資訊，例如文件系統字元正確無誤。 |
14：USMT_ERROR_USE_LAC
- 類別：無效的命令行
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 無法建立本機帳戶，因為未指定 /lac | 建立本機帳戶時，應該使用 命令列選項 /lac 和 /lae 。 |
26：USMT_INIT_ERROR
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 找到多個 Windows 安裝 | 無法建立 Listfiles.txt。 確認您為建立此檔案指定的位置有效。 |
| 軟體故障或未知的例外狀況 | 檢查所有載入的 .xml 檔案是否有錯誤，這是使用 /i 載入 Config.xml 檔案時的常見錯誤。 |
| 找不到有效的 Windows 目錄以繼續進行要求的離線作業;檢查離線輸入檔是否存在且具有有效的專案 | 確認離線輸入檔存在，且具有有效的專案。 USMT 找不到有效的離線作業系統。 確認您的離線目錄對應。 |
27：USMT_INVALID_STORE_LOCATION
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 無法使用存放區路徑，因為現有存放區存在;指定 /o 以覆寫 | 指定 /o 覆寫現有的中繼或移轉存放區。 |
| 存放區路徑遺失或數據不完整 | 請確定可存取存放區路徑，並已設定適當的許可權等級。 |
| 建立存放區期間發生錯誤 | 請確定可存取存放區路徑，並已設定適當的許可權等級。 指定 /o 覆寫現有的中繼或移轉存放區。 |
| 已為存放區指定不適當的裝置，例如磁碟片 | 請確定可存取存放區路徑，並已設定適當的許可權等級。 |
| 無效的存放區路徑;檢查存放區參數和/或檔案系統許可權 | 無效的存放區路徑;檢查存放區參數和/或檔案系統許可權。 |
| 檔案配置和/或檔案內容無法辨識為有效的存放區 | 請確定可存取存放區路徑，並已設定適當的許可權等級。 指定 /o 覆寫現有的中繼或移轉存放區。 |
| 存放區路徑保留與目前 USMT 版本不相容的存放區 | 請確定可存取存放區路徑，並已設定適當的許可權等級。 |
| 存放區儲存位置是唯讀的，或不支援要求的記憶體選項 | 請確定可存取存放區路徑，並已設定適當的許可權等級。 |
28：USMT_UNABLE_GET_SCRIPTFILES
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 腳本檔案對 /i 無效 | 檢查所有指定的移轉 .xml 檔案是否有錯誤。 使用 /i 載入 Config.xml 檔案時，這個錯誤很常見。 |
| 找不到 /i 所指定的腳本檔案 | 確認文本檔案的位置，並確定命令行選項正確無誤。 |
29：USMT_FAILED_MIGSTARTUP
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 暫存盤至少需要 250 MB 的可用空間 | 確認系統符合 250 MB 的最小暫存磁碟空間需求。 因應措施是，您可以設定環境變數 USMT_WORKING_DIR=<path> 來重新導向暫存盤工作目錄。 |
| 另一個程式正在防止移轉;一次只能執行一個移轉工具 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤。 |
| 無法開始主要處理、在記錄中尋找系統錯誤或檢查安裝 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤。 |
| 移轉失敗，因為發生 XML 錯誤;查看記錄檔中的特定詳細數據 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤。 |
| 無法自動對應驅動器號以符合在線驅動器號配置;使用 /offline 提供對應數據表 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤。 |
31：USMT_UNABLE_FINDMIGUNITS
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 探索階段期間發生錯誤;記錄應該有更具體的資訊 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤。 |
32：USMT_FAILED_SETMIGRATIONTYPE
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 處理移轉系統時發生錯誤 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤，或在命令行上輸入 /? 來使用在線說明。 |
33：USMT_UNABLE_READKEY
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 存取 /keyfile 參數所指定的檔案時發生錯誤 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤，或在命令行上輸入 /? 來使用在線說明。 |
| 加密金鑰必須至少有一個字元 | 檢查 ScanState 記錄檔是否有移轉 .xml 檔案錯誤，或在命令行上輸入 /? 來使用在線說明。 |
34：USMT_ERROR_INSUFFICIENT_RIGHTS
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 拿掉目錄需要更高的許可權 | 以系統管理員身分登入，並以更高的許可權執行。 |
| 沒有建立使用者配置檔的許可權;以系統管理員身分登入;以提高的許可權執行 | 以系統管理員身分登入，並以更高的許可權執行。 |
| 沒有讀取或刪除使用者配置檔的許可權;以系統管理員身分登入，以較高的許可權執行 | 以系統管理員身分登入，並以更高的許可權執行。 |
35：USMT_UNABLE_DELETE_STORE
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 需要重新啟動才能移除存放區 | 重新啟動以刪除命令執行時無法刪除的任何檔案。 |
| 無法使用存放區路徑，因為它包含無法覆寫的數據 | 無法刪除移轉存放區。 如果您使用硬式連結移轉存放區，其中可能有鎖定的檔案。 您應該手動刪除存放區，或使用 UsmtUtils.exe /rd 命令來刪除存放區。 |
| 拿掉存放區時發生錯誤 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
36：USMT_ERROR_UNSUPPORTED_PLATFORM
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 合規性檢查失敗;如需詳細資訊，請查看記錄 | 調查系統上是否有作用中的暫存配置檔。 |
| 套用期間不支援使用 /offline | 在 /offline Windows 預安裝環境 (WinPE) 中執行時未使用命令。 |
| 使用 /offline 在此平台上執行收集 | 在 /offline WinPE 中執行時未使用命令。 |
37：USMT_ERROR_NO_INVALID_KEY
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 存放區會保存加密的數據，但未提供正確的加密金鑰 | 確認 或選項包含/key/keyfile正確的加密金鑰或keyfile。 |
38：USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 存取存放區期間發生錯誤 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 請確定可存取存放區路徑，並已設定適當的許可權等級。 |
39：USMT_UNABLE_TO_READ_CONFIG_FILE
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 讀取 Config.xml時發生錯誤 | 如需 Config.xml檔案中 命令行錯誤的詳細數據，請檢閱 ScanState 記錄檔或 LoadState 記錄檔。 |
| 檔案自變數對 /config 無效 | 檢查您用來載入 Config.xml 檔案的命令行。 您可以在命令列上輸入 /? ，以使用線上說明。 |
40：USMT_ERROR_UNABLE_CREATE_PROGRESS_LOG
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 寫入進度記錄檔時發生錯誤 | 無法建立進度記錄。 確認位置有效，且您具有寫入許可權。 |
| 進度記錄自變數對 /progress 無效 | 無法建立進度記錄。 確認位置有效，且您具有寫入許可權。 |
41：USMT_PREFLIGHT_FILE_CREATION_FAILED
- 類別：安裝和初始化
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 無法覆寫現有的檔案 | 無法建立進度記錄。 確認位置有效，且您具有寫入許可權。 |
| 無效的空間估計路徑。 檢查參數和/或檔案系統許可權 | 如需命令行錯誤的詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
42：USMT_ERROR_CORRUPTED_STORE
- 類別：
| 錯誤訊息 | 存放區包含一或多個損毀的檔案 |
|---|---|
| 存放區會保存加密的數據，但未提供正確的加密金鑰 | 如需損毀檔案的詳細數據，請檢閱 UsmtUtils 記錄。 如需如何擷取未損毀檔案的資訊，請參閱 從壓縮的USMT移轉存放區擷取檔案。 |
61：USMT_MIGRATION_STOPPED_NONFATAL
- 類別：非嚴重錯誤
| 錯誤訊息 | 存放區包含一或多個損毀的檔案 |
|---|---|
| 處理因 I/O 錯誤而停止 | USMT 已結束，但可以繼續 /c 使用命令行選項，並使用選擇性的可 <設定 ErrorControl> 區段或使用 /vsc 命令行選項。 |
71：USMT_INIT_OPERATING_ENVIRONMENT_FAILED
- 類別：嚴重錯誤
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 發生 Windows Win32 API 錯誤 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 嘗試初始化診斷機制時發生錯誤，例如記錄 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 無法記錄診斷資訊 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 無法啟動。 請確定您以更高的許可權執行 USMT | 結束 USMT，並以更高的許可權再次登入。 |
72：USMT_UNABLE_DOMIGRATION
- 類別：嚴重錯誤
| 錯誤訊息 | 疑難解答、風險降低、因應措施 |
|---|---|
| 關閉存放區時發生錯誤 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 套用程式發生錯誤 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 收集程式中發生錯誤 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 寫入存放區時磁碟空間不足 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
| 本機系統上的暫存磁碟空間不足 | 數據傳輸已開始，且在移轉存放區建立期間或在套用階段期間發生錯誤。 如需詳細資訊，請檢閱 ScanState 記錄或 LoadState 記錄。 |
資料收集
若您需要 Microsoft 支援，建議您按照使用 TSS 收集部署相關問題的資訊所述步驟來收集資訊。