Converter script do PowerShell em EXE

Teste o script antes de convertê-lo

Nunca converta um script não testado. Depois que o script fica dentro de um EXE, o console e as mensagens de erro ficam ocultos, de modo que cada bug se torna lento e difícil de encontrar. Execute o arquivo .ps1 como um usuário normal e como administrador, alimente-o com a entrada errada uma vez propositalmente e converta-o apenas quando ele se comportar da mesma maneira todas as vezes.

Instale o módulo PS2EXE

PS2EXE é um módulo gratuito publicado na Galeria do PowerShell. Você instala uma vez, no PC que constrói o EXE - as pessoas que recebem o EXE finalizado não instalam nada. Abra o PowerShell e execute:

Install-Module -Name ps2exe

Na primeira vez, o PowerShell pode pedir que você confie no repositório PSGallery - responda Sim se você mesmo iniciou a instalação. Se as instalações de módulos estiverem bloqueadas pela política em sua máquina, permita-as somente para sua própria conta:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Converter com o comando Invoke-PS2EXE

Um comando faz a conversão. Ele nomeia o script de entrada e o arquivo de saída - substitua os nomes dos exemplos pelo seu próprio script:

Invoke-PS2EXE -inputFile ".\DiskCleanup.ps1" -outputFile ".\DiskCleanup.exe"

Execute-o na pasta que contém seu script e o EXE aparecerá próximo ao arquivo .ps1. Essa é toda a conversão: as opções na Etapa 5 são adicionadas nesta mesma linha quando você precisar delas.

Ou use a GUI do Win-PS2EXE

Prefere clicar a digitar? O módulo também vem com um front end gráfico:

Win-PS2EXE

Escolha o arquivo de entrada, escolha o arquivo de saída, marque as opções desejadas e pressione Compilar. A GUI produz exatamente o mesmo EXE que a linha de comando - é a mesma ferramenta com um formulário no topo, então use o que achar mais claro.

Adicionar um ícone, informações de versão e direitos de administrador

Se o EXE for compartilhado, atribua uma identidade a ele. Adicione -iconFile ".\tool.ico" para um ícone personalizado e -title, -product, -company e -version para preencher a guia Detalhes das propriedades do arquivo - arquivos nomeados parecem mais confiáveis ​​para usuários e scanners do que os anônimos. Se o script alterar as configurações do sistema, adicione -requireAdmin para que o Windows solicite elevação quando o EXE for iniciado, em vez de o script falhar no meio do caminho. E se o script mostrar sua própria janela ou formulário, -noConsole impedirá que uma janela preta do console apareça atrás dele - mas nunca use-a para um script que faça perguntas ao usuário no console, ou o EXE parecerá congelado enquanto espera por uma entrada que ninguém pode digitar.

Teste o EXE como um usuário real

Copie o EXE em algum lugar neutro - na área de trabalho ou em uma pasta compartilhada - e clique duas vezes nele. Não julgue pela janela do PowerShell. Se precisar de direitos de administrador, confirme se o prompt do UAC aparece e o trabalho é concluído depois disso. Em seguida, mantenha o par junto: script e EXE na mesma pasta. Quando o script mudar, execute novamente a conversão e substitua o EXE - nunca distribua uma compilação obsoleta.

Os limites honestos – leia antes de compartilhar

Esse fato fornece a regra que mantém você seguro: nunca coloque um segredo em um script que você converte - nenhuma senha de administrador, nenhuma senha de conta de serviço, nenhuma chave de API ou token, nenhuma chave de Wi-Fi que você não imprimiria em um pôster. Se um script precisar de uma senha, ele deverá solicitá-la ou lê-la em um armazenamento de credenciais adequado em tempo de execução, nunca carregue-a dentro do arquivo.

Mais um limite honesto: um EXE totalmente novo e não assinado que decodifica e executa texto dentro de si tem o mesmo formato da entrega de malware real, portanto, antivírus e SmartScreen podem sinalizar seu arquivo convertido mesmo que seu script esteja limpo. As correções honestas são de identidade, não de truques: preencha as informações de versão da Etapa 5, distribua o arquivo sempre no mesmo local e assine-o com um certificado de assinatura de código se você compartilha ferramentas regularmente. Nunca responda a um aviso dizendo aos usuários para desativarem o antivírus.