Adicionar um script personalizado à instalação do Windows

Artigo
06/19/2023

Scripts de instalação do Windows

Setupcomplete.cmd e ErrorHandler.cmd são scripts personalizados executados durante ou após o processo de Instalação do Windows. Eles podem ser usados para instalar aplicativos ou executar outras tarefas usando scripts cscript/wscript .

%WINDIR%\Setup\Scripts\SetupComplete.cmd: esse script é executado com permissões do sistema local e é iniciado imediatamente após o usuário ver a área de trabalho. Essa configuração é desabilitada ao usar chaves de produto OEM, exceto em edições Enterprise e sistemas operacionais Windows Server.
%WINDIR%\Setup\Scripts\ErrorHandler.cmd: esse script é executado automaticamente quando a Instalação encontra um erro fatal. Ele é executado com a permissão do sistema local.

Executar um script após a conclusão da instalação (SetupComplete.cmd)

Ordem de operações

Depois que o Windows é instalado, mas antes da tela de logon aparecer, a Instalação do Windows pesquisa o arquivo SetupComplete.cmd no diretório %WINDIR%\Setup\Scripts\ .
Se um arquivo SetupComplete.cmd for encontrado, a Instalação do Windows executará o script. A Instalação do Windows registra a ação no arquivo C:\Windows\Panther\UnattendGC\Setupact.log .

A instalação não verifica nenhum código de saída ou níveis de erro no script depois de executar SetupComplete.cmd.

Aviso

Não é possível reinicializar o sistema e retomar a execução de SetupComplete.cmd. Você não deve reinicializar o sistema adicionando um comando como shutdown -r. Isso colocará o sistema em um estado ruim.
Se o computador ingressar em um domínio durante a instalação, o Política de Grupo definido no domínio não será aplicado ao computador até que Setupcomplete.cmd seja concluído. Isso é para garantir que a atividade de configuração do Política de Grupo não interfira no script.

Executar um script se a Instalação do Windows encontrar um erro fatal (ErrorHandler.cmd)

ErrorHandler.cmd é útil quando você está instalando muitos sistemas ao mesmo tempo. Isso ajuda você a detectar quando ocorre um erro durante a Instalação do Windows. Quando isso acontece, a Instalação executa automaticamente um script que pode conter comandos ou ações personalizados para resolver a causa do erro.

Se a Instalação do Windows encontrar um erro fatal e for impedida de concluir a instalação, a Instalação do Windows procurará um script de comando no seguinte diretório: %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Uma das duas ações ocorrerá, dependendo se o script for encontrado.

Se o script não for encontrado, uma caixa de diálogo será exibida com o texto do erro. Um usuário deve ignorar a caixa de diálogo antes que a Instalação do Windows seja encerrada.
Se o script for encontrado, o script será executado de forma síncrona. Nenhuma caixa de diálogo ou texto de erro é exibido. Depois que o script ErrorHandler.cmd terminar de ser executado, a Instalação do Windows será encerrada.

Dependendo da fase da Instalação do Windows, o computador retornará ao ambiente do qual a Instalação do Windows foi executada, como uma versão anterior do sistema operacional ou o Windows PE (Ambiente de Pré-Instalação do Windows), por exemplo.

Pode haver instâncias quando a Instalação do Windows encontrar mais de um erro e executar o script ErrorHandler.cmd mais de uma vez. Ao desenvolver o código para ErrorHandler.cmd, verifique se você pode executar esse script várias vezes.

Usar ErrorHandler.cmd

Para usar ErrorHandler.cmd, você pode fazer um dos seguintes procedimentos:

Monte a imagem e adicione-a à imagem em %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Desmonte a imagem.

-ou-
Adicione ErrorHandler.cmd a um local de arquivo temporário (por exemplo, C:\Temp\ErrorHandler.cmd) e execute a Instalação do Windows usando a opção /m .
```
Setup /m:C:\Temp
```
Para saber mais, confira Opções de Command-Line de Instalação do Windows.

Usar Unattend para executar scripts

Crie um arquivo Unattend.xml com uma dessas configurações a serem executadas durante o processo de Instalação do Windows. Isso pode ser usado com chaves de produto OEM.

Para executar serviços ou comandos que podem começar ao mesmo tempo, use RunAsynchronousCommands.

Algumas dessas configurações são executadas no contexto do usuário, outras são executadas no contexto do sistema, dependendo da passagem de configuração.

Adicione Microsoft-Windows-Setup\RunAsynchronousCommand ou RunSynchronousCommand para executar um script conforme a Instalação do Windows é iniciada. Isso pode ser útil para definir partições de disco rígido.
Adicione Microsoft-Windows-Deployment\RunAsynchronousCommand ou RunSynchronousCommand à passagem de configuração auditUser para executar um script que é executado quando o computador entra no modo de auditoria. Isso pode ser útil para tarefas como instalação ou teste automatizado de aplicativos.
Adicione Microsoft-Windows-Shell-Setup\LogonCommands\AsynchronousCommand ou FirstLogonCommands\SynchronousCommand para executar após a OOBE (Experiência Pronta para Uso), mas antes que o usuário veja a área de trabalho. Isso pode ser especialmente útil para configurar aplicativos ou conteúdo específicos do idioma depois que o usuário já tiver selecionado seu idioma.

Use esses scripts com moderação porque scripts longos podem impedir que o usuário chegue à tela Inicial rapidamente. Para versões de varejo do Windows, restrições adicionais se aplicam a esses scripts. Para obter informações, consulte as diretrizes de Licenciamento e Política no OEM Partner Center.

Observação

Quando você adicionar um script usando FirstLogonCommands, ele será disparado na próxima inicialização, mesmo que você inicialize no modo de auditoria usando Ctrl+Shift+F3. Para inicializar no modo de auditoria sem disparar esses scripts, adicione a configuração: Microsoft-Windows-Deployment\Reseal\Mode = Audit.

Referência técnica de instalação do Windows Implante um Windows de inicialização de imagem personalizada para o modo de auditoria ou OOBE Adicionar drivers de dispositivo ao Windows durante a instalação do Windows