Instalação silenciosa de um Setup.exe: /S, pasta e implantação

Equipes de TI não clicam em assistentes de instalação. Elas executam o instalador a partir de um script ou de uma ferramenta de implantação e esperam que ele termine sozinho. Todo instalador gerado pelo ExeTup é um instalador NSIS, e o NSIS suporta instalação silenciosa há décadas. Este guia cobre os parâmetros, as armadilhas e como as ferramentas de implantação mais comuns os invocam.

Os parâmetros

Setup.exe /S

Instala com os padrões definidos na hora de gerar o instalador: a pasta padrão, os atalhos, o escopo escolhido. Nenhuma janela aparece. O parâmetro diferencia maiúsculas de minúsculas: /S, não /s.

Setup.exe /S /D=C:\Apps\My App

Instala em outra pasta. Regras do /D=:

• precisa ser o último parâmetro da linha de comando;
• o caminho vai sem aspas, mesmo que contenha espaços;
• também diferencia maiúsculas de minúsculas.

Desinstalação silenciosa:

"C:\Program Files\My App\unins000.exe" /S

O desinstalador se chama unins000.exe e fica na pasta de instalação; ele é registrado em Configurações → Aplicativos, então o winget uninstall e a maioria das ferramentas de implantação também o encontram.

O que uma instalação silenciosa ainda faz

• Instala para todos os usuários (em Program Files, exigindo elevação) ou por usuário, conforme escolhido na geração. Um instalador por máquina executado em silêncio a partir de um prompt sem elevação falha sem avisar; execute-o a partir de um shell elevado ou do contexto de sistema da sua ferramenta de implantação.
• Cria os atalhos do Menu Iniciar e da Área de Trabalho, se estavam habilitados.
• Registra o desinstalador e a versão nas Configurações do Windows.
• Não abre o aplicativo ao final, mesmo que a opção "abrir após instalar" esteja ligada. Essa página é pulada no modo silencioso.
• Usa o primeiro idioma quando há vários configurados; a caixa de diálogo de idioma é pulada.

Códigos de saída

Uma instalação silenciosa bem-sucedida termina com 0. Um código diferente de zero significa que ela foi abortada, na maioria das vezes porque a elevação foi negada ou porque o instalador já estava em execução. Os scripts devem verificar o código:

Setup.exe /S
if %errorlevel% neq 0 exit /b %errorlevel%

No PowerShell, use Start-Process -Wait -PassThru e leia .ExitCode, porque caso contrário o Setup.exe retorna imediatamente:

$p = Start-Process -FilePath ".\Setup.exe" -ArgumentList "/S" -Wait -PassThru
exit $p.ExitCode

Ferramentas de implantação

• Microsoft Intune: empacote como aplicativo Win32 (.intunewin) com o comando de instalação Setup.exe /S e o comando de desinstalação "%ProgramFiles%\My App\unins000.exe" /S. Use a entrada do registro em HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall\My App ou o .exe principal como regra de detecção.
• PDQ Deploy, ManageEngine, Chocolatey: uma etapa "Install" que executa Setup.exe /S no contexto de sistema.
• Política de Grupo: a instalação de software por GPO exige arquivos MSI. Use, em vez disso, um script de inicialização que execute Setup.exe /S.
• winget: um manifesto com InstallerType: nullsoft informa os parâmetros ao winget; o instalador precisa estar hospedado em uma URL estável.

Atualizações

Executar um Setup.exe /S mais recente sobre uma versão instalada substitui os arquivos no lugar e atualiza a versão nas Configurações do Windows. Os usuários devem fechar o aplicativo antes; um .exe em execução não pode ser sobrescrito.

Perguntas frequentes

O parâmetro é /S ou /silent?

/S, em maiúscula. Instaladores NSIS ignoram /silent e /verysilent, que pertencem ao Inno Setup.

Posso informar uma pasta com espaços?

Sim, sem aspas: Setup.exe /S /D=C:\Program Files\My App. O parâmetro /D= precisa ser a última coisa na linha.

A instalação silenciosa exige direitos de administrador?

Só para instaladores gerados para todos os usuários. Instaladores por usuário rodam em silêncio sem elevação, o que é útil em notebooks gerenciados onde os usuários não são administradores.

Onde fica o desinstalador?

unins000.exe, na pasta de instalação. Ele aceita o mesmo parâmetro /S para uma desinstalação silenciosa.