Коды ошибок install.bat
Перечень кодов ошибок и действий по их устранению
О чем эта статья
В статье собраны коды ошибок, которые возвращает сценарий install.bat в среде WinPE при сетевой установке Windows и практические шаги для администратора по их диагностике и устранению.
Как это работает
- Сценарий
install.batотносится к стандартному процессу подготовкиWinPEк сетевой установке. - Сценарий запускается из
zobootshell.exeи взаимодействует с ним через процедуру:ZOSHELL. Через эту процедуру выполняются отчеты о ходе исполнения (step,error,wait) и служебные действия (extract,download), недоступные или неудобные в чистомWinPE. - Регистрация запуска
zobootshell.exeиinstall.batпроизводится стандартным дляWinPEобразом - через файлwinpeshl.ini
Важно
Проверьте в первую очередь
Сценарийinstall.batпротестирован на стандартных образахWindows. Если Вы используете модифицированный или кастомный образ, сначала сверяйте состав образа, сетевые компоненты, набор драйверов и порядок инициализации.
Несмотря на то, что в большинстве случаев это не требуется - Вы можете вносить изменения в
install.bat, например добавить дополнительные шаги и действия, увеличить интервалы ожидания и т.д.
Быстрый список кодов
0x00000128- сеть вWinPEне готова к работе.0x00000129- не удалось подключитьSMB-ресурс с установочным контентом.0x00000130- ошибка распаковкиessential-drivers.zip.0x00000131- ошибка загрузки драйвера вWinPE.0x00000132- ошибка инициализацииWinPE.0x00000133- ошибка интеграции драйвера в офлайн-образWindows.0x00000134- ошибка загрузки post-install скриптаfirst-boot.ps1.
Детально по кодам
Код ошибки 0x00000128
| Что означает |
В среде WinPE сеть не перешла в рабочее состояние. |
| Частые причины |
- Отсутствует link на интерфейсе.- Недоступен DHCP в целевом сегменте.- Отсутствует корректный сетевой драйвер. - Используется нестандартный образ с измененными сетевыми компонентами. |
| Что проверить |
| - Проверить физическое подключение и состояние порта. - Проверить выдачу адреса от DHCP в данном сегменте.- Убедиться, что в наборе драйверов есть сетевой драйвер под текущее оборудование. - Проверить связность до шлюза и SMB-сервера. |
Код ошибки 0x00000129
| Что означает |
Не удалось смонтировать SMB-ресурс с контентом установки. |
| Частые причины |
- Ошибка в UNC-пути.- Недоступен SMB-хост.- Неверные учетные данные или права доступа. - Ограничения по версии SMB/политикам безопасности.- Модифицированный образ влияет на сетевой стек/аутентификацию. - SMB-папка не опубликована на стороне инфраструктуры. |
| Что проверить |
- Проверить доступность SMB-сервера по имени и по IP.- Проверить корректность сервисной учетной записи. - Проверить права чтения на опубликованную шару. - Сверить требования к версии SMB и настройкам безопасности.- Учитывать, что этот сценарий не поднимает SMB-шару автоматически: администратор должен заранее опубликовать установочную папку по SMB на Windows или Linux. |
Важно: публикация
SMB-шары и выдача прав доступа - зона ответственности администратора инфраструктуры.
Код ошибки 0x00000130
| Что означает |
Не выполнена распаковка архива essential-drivers.zip. |
| Частые причины |
| - Архив отсутствует или поврежден. - Недостаточно места во временной среде WinPE.- Используется нестандартный образ с измененными компонентами/путями. |
| Что проверить |
- Проверить доступность и целостность essential-drivers.zip.- Проверить, что внутри essential-drivers.zip есть драйверы для целевого оборудования.- Проверить свободное место во временных каталогах WinPE.- При необходимости заменить архив на эталонный и повторить установку. |
Код ошибки 0x00000131
| Что означает |
Один или несколько драйверов не загрузились в WinPE. |
| Частые причины |
| - Несовместимая архитектура драйвера. - Неполный комплект файлов рядом с INF.- Ограничения по подписи. - Измененный образ с конфликтующим драйверным стеком. |
| Что проверить |
| - Оставить только актуальные драйверы под целевую платформу. - Проверить полноту драйверных пакетов ( INF, SYS, CAT и сопутствующие файлы).- Исключить устаревшие/конфликтующие пакеты. - Начинать проверку с минимального набора ( network + storage). |
Код ошибки 0x00000132
| Что означает |
WinPE не завершил штатную инициализацию. |
| Частые причины |
- Нарушен состав образа WinPE.- Проблемы базовых драйверов сети/диска. - Изменен порядок ранней инициализации в кастомном образе. |
| Что проверить |
- Проверить целостность и состав образа WinPE.- Проанализировать журнал wpeinit.- Сверить драйверный набор с эталонной конфигурацией. - Выполнить повторный запуск на стандартном образе для контрольной проверки. |
Код ошибки 0x00000133
| Что означает |
Не выполнено добавление драйвера в офлайн-образ установленной Windows. |
| Частые причины |
| - Некорректно определен целевой раздел. - Драйвер не соответствует версии/архитектуре Windows.- Пакет драйвера неполный или поврежден. - Используется модифицированный установочный образ. |
| Что проверить |
- Проверить корректность определения раздела с установленной Windows.- Использовать драйверы, соответствующие редакции и версии целевой ОС. - Проанализировать журнал DISM и исключить проблемные пакеты.- Удалить дублирующиеся версии драйверов из архива. |
Код ошибки 0x00000134
| Что означает |
Не загружен post-install скрипт first-boot.ps1. |
| Частые причины |
- Недоступен HTTP-источник или сетевой маршрут.- Сервер возвращает ошибочный HTTP-код.- В проекте ОС удален или переименован first-boot.ps1.- Используется нестандартный образ с измененной сетевой конфигурацией. |
| Что проверить |
- Проверить доступность источника и корректность URL.- Проверить HTTP-ответ сервера и стабильность маршрута.- Проверить, что first-boot.ps1 присутствует в проекте ОС под ожидаемым именем и путем.- Предусмотреть резервный источник скрипта (например, на SMB-шаре). |