Коды возврата средства миграции пользовательской среды (USMT)

В этой статье описаны коды возврата и сообщения об ошибках USMT 10.0. Также включается таблица с кодами возврата USMT с соответствующими шагами по устранению рисков. Кроме того, в этой статье содержатся советы по использованию файлов журналов для определения причин возникновения ошибки.

Понимание требований для запуска USMT поможет свести к минимуму ошибки при миграции USMT. Дополнительные сведения см. в разделе Требования USMT.

Коды возврата, используемые USMT

При возникновении ошибки при миграции USMT можно использовать коды возврата и более подробную информацию, указанную в связанных сообщениях об ошибках USMT, чтобы устранить проблему и определить шаги по ее устранению.

Коды возврата сгруппированы в следующие широкие категории, описывающие область их отчетности об ошибках:

• Успешное выполнение или отмена пользователем

• Недопустимые командные строки

• Настройка и инициализация

• Неустранимые ошибки

• Неустранимая ошибка

Рекомендуется задать уровень детализации 5, v:5в ScanState.exe, LoadState.exeи UsmtUtils.exe командных строк, чтобы наиболее подробные отчеты были доступны в соответствующих журналах USMT. Вы можете использовать более высокий уровень детализации, если требуется, чтобы выходные данные файлов журнала отправялись в отладчик.

Сообщения об ошибках USMT

Сообщения об ошибках содержат более подробные сведения о проблеме миграции, чем связанный код возврата. Например, средство ScanState, LoadState или UsmtUtils может возвращать код 11 (для USMT_INVALID_PARAMETERS) и связанное с ним сообщение об ошибке, которое считывает значения /key и /keyfile. Сообщение об ошибке отображается в командной строке и определяется в файлах журнала ScanState, LoadState или UsmtUtils , чтобы определить причину получения кода возврата.

Дополнительные сведения о любых перечисленных кодах системных ошибок Windows можно получить, введя в окне net.exe helpmsg <error_number> командной строки, где <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.
Аргумент file недопустим для /genconfig	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState.
Аргумент file недопустим для /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.
Параметр store является обязательным, но не указан	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState.
Недопустимое сопоставление доменов источника и целевого объекта для /md	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState.
Сопоставление учетных записей пользователя из источника и целевого объекта недопустимо для /mu	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState.
Неопределенный или неполный параметр командной строки	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState.
Используйте /nocompress или укажите путь к XML-файлу с параметром /p "pathtoafile", чтобы получить оценку размера сжатого хранилища.	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState.
Недопустимый аргумент исключения пользователя	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState.
Уровень детализации должен быть указан в виде суммы требуемых параметров журнала: Подробный (0x01), Объекты записи (0x04), Порт отладки echo to debug (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	Если /l параметр указан в командной строке ScanState, средство 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 МБ свободного места	Убедитесь, что система соответствует минимальному требованию временного места на диске в 250 МБ. В качестве обходного решения можно задать переменную 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

• Категория: Настройка и инициализация

Сообщение об ошибке	Устранение неполадок, устранение рисков, обходные решения
Хранилище содержит зашифрованные данные, но правильный ключ шифрования не предоставлен.	Убедитесь, что в параметр или /keyfile включен правильный /key ключ шифрования или файл ключа.

38: USMT_ERROR_CORRUPTED_NOTENCRYPTED_STORE

• Категория: Настройка и инициализация

Сообщение об ошибке	Устранение неполадок, устранение рисков, обходные решения
Ошибка при доступе к хранилищу	Дополнительные сведения об ошибках командной строки см. в разделе Журнал ScanState или LoadState. Убедитесь, что путь к хранилищу доступен и установлены соответствующие уровни разрешений.

39: USMT_UNABLE_TO_READ_CONFIG_FILE

• Категория: Настройка и инициализация

Сообщение об ошибке	Устранение неполадок, устранение рисков, обходные решения
Ошибка при чтении Config.xml	Дополнительные сведения об ошибках командной строки в файле Config.xml см. в разделе Журнал ScanState или LoadState.
Аргумент file недопустим для /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

• Категория: Неустранимые ошибки

Сообщение об ошибке	Хранилище содержит один или несколько поврежденных файлов
Обработка остановлена из-за ошибки ввода-вывода	USMT завершено, но можно продолжить с параметром /c командной строки с дополнительным настраиваемым <разделом ErrorControl> или с помощью /vsc параметра командной строки.

71: USMT_INIT_OPERATING_ENVIRONMENT_FAILED

• Категория: Неустранимая ошибка

Сообщение об ошибке	Устранение неполадок, устранение рисков, обходные решения
Произошла ошибка API Windows Win32	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.
Ошибка при попытке инициализации механизмов диагностики, таких как журнал	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.
Не удалось записать диагностические сведения	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.
Не удается запустить. Убедитесь, что вы используете USMT с повышенными привилегиями.	Закройте USMT и снова войдите с повышенными привилегиями.

72: USMT_UNABLE_DOMIGRATION

• Категория: Неустранимая ошибка

Сообщение об ошибке	Устранение неполадок, устранение рисков, обходные решения
Произошла ошибка при закрытии хранилища	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.
Произошла ошибка в процессе применения	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.
Произошла ошибка в процессе сбора	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.
Свободное место на диске при записи хранилища	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.
Отсутствие временного места на диске в локальной системе	Передача данных началась, и во время создания хранилища миграции или на этапе применения произошла ошибка. Дополнительные сведения см. в журнале ScanState или LoadState.

Сбор данных

Если вам нужна помощь службы поддержки Microsoft, мы рекомендуем собирать информацию путем выполнения действий, описанных в разделе Сбор информации с помощью TSS для решения проблем, связанных с развертыванием.

Связанные статьи

Устранение неполадок средства миграции пользовательской среды (USMT)

Файлы журнала USMT