用户状态迁移工具 (USMT) 返回代码
本文介绍 USMT 10.0 返回代码和错误消息。 还包括一个表，其中列出了 USMT 返回代码及其关联的缓解步骤。 此外，本文还提供了一些提示，帮助你使用日志文件来确定收到错误的原因。
了解运行 USMT 的要求有助于最大程度地减少 USMT 迁移中的错误。 有关详细信息，请参阅 USMT 要求。
USMT 使用的返回代码
如果在 USMT 迁移中遇到错误，可以使用返回代码和关联的 USMT 错误消息中提供的更具体的信息来排查问题并确定缓解步骤。
返回代码分为以下大类，用于描述其错误报告区域：
成功或用户取消
命令行无效
设置和初始化
非严重错误
严重错误
作为最佳做法，我们建议在 ScanState.exe、 v:5LoadState.exe 和 命令行上将详细级别设置为 5、、，UsmtUtils.exe命令行，以便在相应的 USMT 日志中提供最详细的报告。 如果希望日志文件输出转到调试器，则可以使用更高的详细级别。
USMT 错误消息
与关联的返回代码相比，错误消息提供了有关迁移问题的详细信息。 例如，ScanState、LoadState 或 UsmtUtils 工具可能会为USMT_INVALID_PARAMETERS) 返回 11 (代码，并返回读取 /key 和 /keyfile 这两个指定的 /key 和 /keyfile 的相关错误消息。 错误消息显示在命令提示符处，并在 ScanState、 LoadState 或 UsmtUtils 日志文件中标识，以帮助确定收到返回代码的原因。
可以通过在命令提示符窗口中net.exe helpmsg <error_number>键入有关任何列出的 Windows 系统错误代码的详细信息，其中<error_number>是错误消息生成的错误代码号。 有关系统错误代码的详细信息，请参阅 系统错误代码 (0-499) 。
排查返回代码和错误消息问题
以下信息按数值列出每个返回代码，以及关联的错误消息和建议的故障排除操作。
0：USMT_SUCCESS
- 类别：成功或用户取消
| 错误消息 | 故障排除、缓解、解决方法 |
|---|---|
| 成功运行 | 不适用 |
1：USMT_DISPLAY_HELP
- 类别：成功或用户取消
| 错误消息 | 故障排除、缓解、解决方法 |
|---|---|
| 请求的命令行帮助 | 不适用 |
2：USMT_STATUS_CANCELED
- 类别：成功或用户取消
| 错误消息 | 故障排除、缓解、解决方法 |
|---|---|
| 由于 EFS 文件，收集被中止 | 不适用 |
| 用户选择取消 (，例如按 CTRL+C) | 不适用 |
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 日志。 |
| 等待延迟参数必须为整数 | 有关命令行错误的详细信息，请查看 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 文件错误。 |
| 无法启动main处理、在日志中查找系统错误或检查安装 | 检查 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 针对与部署相关的问题收集信息中所述的步骤收集信息。
相关文章
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈