Agregar un script personalizado al programa de instalación de Windows

  • Artículo

Scripts de instalación de Windows

Setupcomplete.cmd y ErrorHandler.cmd son scripts personalizados que se ejecutan durante o después del proceso de instalación de Windows. Se pueden usar para instalar aplicaciones o ejecutar otras tareas mediante scripts cscript/wscript .

  • %WINDIR%\Setup\Scripts\SetupComplete.cmd: este script se ejecuta con permisos del sistema local y se inicia inmediatamente después de que el usuario vea el escritorio. Esta configuración se deshabilita cuando se usan claves de producto OEM, excepto en las ediciones Enterprise y los sistemas operativos Windows Server.
  • %WINDIR%\Setup\Scripts\ErrorHandler.cmd: este script se ejecuta automáticamente cuando el programa de instalación encuentra un error irrecuperable. Se ejecuta con el permiso del sistema local.

Ejecutar un script una vez completada la instalación (SetupComplete.cmd)

Orden de las operaciones

  1. Después de instalar Windows, pero antes de que aparezca la pantalla de inicio de sesión, el programa de instalación de Windows busca el archivo SetupComplete.cmd en el directorio %WINDIR%\Setup\Scripts\ .

  2. Si se encuentra un archivo SetupComplete.cmd , el programa de instalación de Windows ejecuta el script. El programa de instalación de Windows registra la acción en el archivo C:\Windows\Panther\UnattendGC\Setupact.log .

    El programa de instalación no comprueba los códigos de salida ni los niveles de error del script después de ejecutar SetupComplete.cmd.

    Advertencia

    No se puede reiniciar el sistema ni reanudar la ejecución de SetupComplete.cmd. No debe reiniciar el sistema agregando un comando como shutdown -r. Esto pondrá el sistema en un estado incorrecto.

  3. Si el equipo se une a un dominio durante la instalación, el directiva de grupo definido en el dominio no se aplica al equipo hasta que finalice Setupcomplete.cmd. Esto es para asegurarse de que la actividad de configuración de directiva de grupo no interfiere con el script.

Ejecute un script si el programa de instalación de Windows encuentra un error irrecuperable (ErrorHandler.cmd)

ErrorHandler.cmd es útil cuando se instalan muchos sistemas al mismo tiempo. Esto le ayuda a detectar cuándo se produce un error durante la instalación de Windows. Cuando lo hace, el programa de instalación ejecuta automáticamente un script que puede contener comandos o acciones personalizados para solucionar la causa del error.

Si el programa de instalación de Windows encuentra un error irrecuperable y no se puede completar la instalación, el programa de instalación de Windows busca un script de comando en el siguiente directorio: %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Se producirá una de las dos acciones, en función de si se encuentra el script.

  • Si no se encuentra el script, aparece un cuadro de diálogo con el texto del error. Un usuario debe descartar el cuadro de diálogo antes de que se cierre el programa de instalación de Windows.
  • Si se encuentra el script, se ejecuta de forma sincrónica. No se muestra ningún cuadro de diálogo o texto de error. Una vez que el script ErrorHandler.cmd haya terminado de ejecutarse, se cierra el programa de instalación de Windows.

Según la fase de instalación de Windows, el equipo volverá al entorno desde el que se ejecutó el programa de instalación de Windows, como una versión anterior del sistema operativo o el entorno de preinstalación de Windows (Windows PE), por ejemplo.

En algunos casos la instalación de Windows detecta más de un error y ejecuta más de una vez el script ErrorHandler.cmd. Al desarrollar el código para ErrorHandler.cmd, asegúrese de que puede ejecutar este script varias veces.

Usar ErrorHandler.cmd

Para usar ErrorHandler.cmd, puede realizar una de las siguientes acciones:

  • Monte la imagen y agréguela a la imagen, en %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Desmonte la imagen.

    O bien

  • Agregue ErrorHandler.cmd a una ubicación de archivo temporal (por ejemplo, C:\Temp\ErrorHandler.cmd) y, a continuación, ejecute el programa de instalación de Windows con la opción /m .

    Setup /m:C:\Temp

    Para obtener más información, consulte Configuración de Windows Command-Line Opciones.

Uso de unasatendida para ejecutar scripts

Cree un archivo Unattend.xml con una de estas opciones para ejecutarse durante el proceso de instalación de Windows. Esto se puede usar con claves de producto OEM.

Para ejecutar servicios o comandos que se pueden iniciar al mismo tiempo, use RunAsynchronousCommands.

Algunas de estas opciones se ejecutan en el contexto de usuario, otras se ejecutan en el contexto del sistema en función del paso de configuración.

  • Agregue Microsoft-Windows-Setup\RunAsynchronousCommand o RunSynchronousCommand para ejecutar un script a medida que se inicia el programa de instalación de Windows. Esto puede resultar útil para establecer particiones de disco duro.

  • Agregue Microsoft-Windows-Deployment\RunAsynchronousCommand o RunSynchronousCommand a la configuración auditUser para ejecutar un script que se ejecuta cuando el equipo entra en modo auditoría. Esto puede resultar útil para tareas como la instalación o las pruebas automatizadas de aplicaciones.

  • Agregue Microsoft-Windows-Shell-Setup\LogonCommands\AsynchronousCommands o FirstLogonCommands\SynchronousCommand para que se ejecute después de la configuración rápida (OOBE), pero antes de que el usuario vea el escritorio. Esto puede ser especialmente útil para configurar contenido o aplicaciones específicas del idioma después de que el usuario ya haya seleccionado su idioma.

    Use estos scripts con moderación porque los scripts largos pueden impedir que el usuario llegue rápidamente a la pantalla Inicio. En el caso de las versiones comerciales de Windows, se aplican restricciones adicionales a estos scripts. Para obtener información, consulta la Guía de directivas y licencias en el Centro de partners de OEM.

    Nota

    Al agregar un script mediante FirstLogonCommands, se desencadenará en el siguiente arranque, incluso si arranca en modo auditoría mediante Ctrl+Mayús+F3. Para iniciar el modo de auditoría sin desencadenar estos scripts, agregue la configuración Microsoft-Windows-Deployment\Reseal\Mode = Audit.

Referencia técnica de instalación de WindowsImplementación de una ventana de arranque de imagen personalizada en modo auditoría o OOBEAgregar controladores de dispositivo a Windows durante la instalación de Windows