Este documento describe cómo agregar scripts personalizados a la configuración de Windows para ejecutar tareas durante o después de la instalación. Se pueden usar scripts como SetupComplete.cmd y ErrorHandler.cmd, ubicados en directorios específicos, para ejecutar aplicaciones u otras acciones. También se pueden agregar comandos a archivos Unattend.xml para automatizar tareas durante la instalación desatendida de Windows.

1. Agregar un script personalizado a la configuración de Windows
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. Pueden usarse para instalar aplicaciones o
ejecutar otras tareas mediante scripts cscript/wscript.
%WINDIR%SetupScriptsSetupComplete.cmd: este script se ejecuta inmediatamente después de que el
usuario ve el escritorio. Esta opción está deshabilitada cuando se usan claves de producto OEM. Se ejecuta con
permisos del sistema local.
%WINDIR%SetupScriptsErrorHandler.cmd: este script se ejecuta automáticamente cuando el programa
de instalación detecta un error irrecuperable. Se ejecuta con permisos del sistema local.
Scripts de instalación desatendida de Windows: crear un archivo Unattend.xml con una de estas opciones de
configuración para que se ejecute durante el proceso de instalación de Windows. Esto puede usarse con claves de
producto OEM.
Para ejecutar servicios o comandos que puedan iniciarse al mismo tiempo, usa comandos asincrónicos. Para ejecutar
comandos que deban finalizar antes de que otros comandos puedan iniciarse, usa RunSynchronousCommands.
Nota A partir de Windows 10, Microsoft‐Window‐Shell‐SetupLogonCommandsAsynchronousCommand
ahora funciona como LogonCommandsAsynchronousCommand: todos los comandos que usen estas opciones
de configuración desatendidas ahora se inician al mismo tiempo y ya no esperan a que el comando anterior
finalice.
Algunas de estas opciones de configuración se ejecutan en el contexto de usuario, otras se ejecutan en el contexto
de sistema, según la fase de configuración.
Agrega Microsoft‐Windows‐SetupRunAsynchronousCommand o RunSynchronousCommand para ejecutar
un script cuando se inicie el programa de instalación de Windows. Esto puede resultar útil para configurar
particiones de disco duro.
Agrega Microsoft‐Windows‐DeploymentRunAsynchronousCommand o RunSynchronousCommand a la fase
de configuración auditUser para ejecutar un script que se inicia cuando el equipo entra en modo auditoría. Esto
puede resultar útil para tareas como la prueba o instalación de aplicaciones automatizadas.
Agrega Microsoft‐Windows‐Shell‐SetupLogonCommandsAsynchronousCommand o
FirstLogonCommandsSynchronousCommand para una ejecución 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 aplicaciones específicas
del idioma o contenido después de que el usuario haya seleccionado su idioma.
Usa estos scripts con moderación porque los scripts largos pueden impedir que el usuario llegue rápidamente a la
pantalla Inicio. Para versiones comerciales de Windows, hay restricciones adicionales para 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 comandos de FirstLogonCommands, se activará en el próximo arranque,
incluso si lo arrancas en modo auditoría mediante Ctrl + Mayús + F3. Para arrancar en modo auditoría sin
activar estos scripts, agrega la opción: Microsoft‐Windows‐DeploymentResealMode = Audit.

2.
Ejecutar un script cuando la instalación se completa ﴾SetupComplete.cmd﴿
Orden de operaciones
1. Una vez instalado Windows pero antes de que aparezca la pantalla de inicio de sesión, la configuración de
Windows busca el archivo SetupComplete.cmd en el %WINDIR%SetupScripts directory.
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:WindowsPantherUnattendGCSetupact.log.
La configuración no comprueba los códigos de salida o niveles de error en el script después de que ejecuta
SetupComplete.cmd.
Nota No se puede reiniciar el sistema y reanudar la ejecución de SetupComplete.cmd.
3. Si el equipo se une a un dominio durante la instalación, la directiva de grupo definida en el dominio no se aplica
al equipo hasta que Setupcomplete.cmd haya finalizado. Esto sirve para garantizar que la actividad de
configuración de la directiva de grupo no interfiere con el script.
Ejecutar un script si se produce un error irrecuperable durante la instalación
de Windows
Este script es útil cuando se instalan muchos sistemas a la vez. 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 acciones o comandos personalizados para solucionar la causa del error.
Si la configuración de Windows encuentra un error irrecuperable y no se puede completar la instalación, la
configuración de Windows busca un script de comandos en el siguiente directorio:
%WINDIR%SetupScriptsErrorHandler.cmd. Se producirá una de estas 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. El usuario debe descartar el
cuadro de diálogo antes de que se cierre la configuració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. Cuando haya terminado la ejecución del script ErrorHandler.cmd, se cierra la configuración de Windows.
Según la fase de configuración de Windows, el equipo volverá al entorno desde el que se ejecutó la configuración
de Windows, tal como una versión anterior del sistema operativo o el Entorno de preinstalación de Windows
﴾Windows PE﴿, por ejemplo.
En algunos casos, la configuració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úrate de que puedas ejecutar este script
varias veces.
Para usar ErrorHandler.cmd, puedes realizar una de las siguientes acciones:
Monta la imagen y agrégalo a la imagen, en %WINDIR%SetupScriptsErrorHandler.cmd. Desmonta la
imagen.

3. ‐ o bien ‐
Agrega ErrorHandler.cmd a una ubicación de archivo temporal ﴾por ejemplo, C:TempErrorHandler.cmd﴿ y
después ejecuta el programa de instalación de Windows con la opción /m.
Para obtener más información, consulta Opciones de línea de comandos del programa de instalación de
Windows.
Temas relacionados
Referencia técnica de la configuración de Windows
Arrancar desde un DVD
Usar un conjunto de configuración con la configuración de Windows
Implementar una imagen personalizada
Arrancar Windows en modo auditoría o configuración rápida
Agregar controladores de dispositivos a Windows durante la configuración de Windows
© 2017 Microsoft
Setup /m:C:Temp