Коды возврата средства миграции пользовательской среды (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)