用戶狀態移轉工具 （USMT） 傳回碼
本文說明 USMT 10.0 傳回碼和錯誤訊息。 此外，也包含一個數據表，其中列出 USMT 傳回碼及其相關聯的風險降低步驟。 此外，本文會提供秘訣，協助您使用記錄檔來判斷您收到錯誤的原因。
瞭解執行 USMT 的需求，有助於將 USMT 移轉中的錯誤降到最低。 如需詳細資訊，請參閱 USMT 需求。
USMT 所使用的傳回碼
如果您在 USMT 移轉中遇到錯誤，您可以使用傳回碼和相關聯 USMT 錯誤訊息中所提供的更具體資訊，以針對問題進行疑難解答，並識別風險降低步驟。
傳回碼會分組為下列廣泛類別，以描述其錯誤報告區域：
成功或使用者取消
無效的命令行
設定和初始化
非嚴重錯誤
嚴重錯誤
最佳做法是，建議您在ScanState.exe、LoadState.exe和UsmtUtils.exe命令行上，將詳細資訊層級設定為 5、v:5，讓個別 USMT 記錄中提供最詳細的報告。 如果您想要將記錄檔輸出移至調試程式，則可以使用較高的詳細資訊層級。
USMT 錯誤訊息
錯誤訊息會提供移轉問題比相關聯傳回碼更詳細的資訊。 例如，ScanState、LoadState 或 UsmtUtils 工具可能會傳回 11 碼（適用於 USMT_INVALID_PARAMETERS），以及讀取 /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 記錄檔。 |
| Retry 自變數必須是整數 | 如需命令行錯誤的詳細數據，請檢閱 ScanState 記錄檔或 LoadState 記錄檔。 |
| 指定的設定存放區自變數無效 | 如需命令行錯誤的詳細數據，請檢閱 ScanState 記錄檔或 LoadState 記錄檔。 請確定可存取存放區路徑，並設定適當的許可權等級。 |
| 不支援指定的加密演算法 | 如需命令行錯誤的詳細數據，請檢閱 ScanState 記錄檔或 LoadState 記錄檔。 |
| /efs：hardlink 需要 /hardlink | 如需命令行錯誤的詳細數據，請檢閱 ScanState 記錄檔或 LoadState 記錄檔。 |
| /targetWindows7 選項僅適用於 Windows XP、Windows Vista 和 Windows 7 | 如需命令行錯誤的詳細數據，請檢閱 ScanState 記錄檔或 LoadState 記錄檔。 |
| 需要 store 參數，但未指定 | 如需命令行錯誤的詳細數據，請檢閱 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 記錄檔。 |
| Wait delay 自變數必須是整數 | 如需命令行錯誤的詳細數據，請檢閱 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 收集部署相關問題的資訊所述步驟來收集資訊。