用户状态迁移工具 （USMT） 返回代码
本文介绍 USMT 10.0 返回代码和错误消息。 还包括一个表，其中列出了 USMT 返回代码及其关联的缓解步骤。 此外，本文还提供了一些提示，可帮助你使用日志文件来确定收到错误的原因。
了解运行 USMT 的要求有助于最大程度地减少 USMT 迁移中的错误。 有关详细信息，请参阅 USMT 要求。
返回 USMT 使用的代码
如果在 USMT 迁移中遇到错误，可以使用返回代码和关联的 USMT 错误消息中提供的更具体信息来排查问题并识别缓解步骤。
返回代码分为以下大类，这些类别描述其错误报告区域：
成功或用户取消
无效的命令行
设置和初始化
非致命错误
严重错误
最佳做法是，建议在ScanState.exe、LoadState.exe和UsmtUtils.exe命令行上将详细级别设置为 5v: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 文件而中止了 Gather | 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 选项。 |
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 针对与部署相关的问题收集信息中所述的步骤收集信息。