Windows Automation Tool

Ferramenta completa de automação para profissionais de TI que trabalham com estações Windows em ambiente corporativo. Padroniza setup, manutenção, diagnóstico e desinstalação de aplicativos em uma única solução portátil baseada em .bat + .ps1.

 ================================================================================

   ████████╗███████╗ ██████╗██████╗ ██╗      █████╗ ██╗   ██╗
   ╚══██╔══╝██╔════╝██╔════╝██╔══██╗██║     ██╔══██╗╚██╗ ██╔╝
      ██║   █████╗  ██║     ██████╔╝██║     ███████║ ╚████╔╝
      ██║   ██╔══╝  ██║     ██╔═══╝ ██║     ██╔══██║  ╚██╔╝
      ██║   ███████╗╚██████╗██║     ███████╗██║  ██║   ██║
      ╚═╝   ╚══════╝ ╚═════╝╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝

                     W I N D O W S   A U T O M A T I O N   T O O L
                                  v1.4.0
 ================================================================================

---

Sumário

• O que é
• Para quem foi pensada
• Recursos
• Pré-requisitos
• Instalação
• Como usar
• Preview do menu
• Estrutura do projeto
• Customizando para sua empresa
• Modo CLI / automação
• Documentação
• Contribuindo
• Créditos
• Licença
• English summary

---

O que é

Uma ferramenta de linha única para o dia a dia da TI em ambientes Windows corporativos. Reúne, em um único .bat portátil, dezenas de tarefas que todo técnico já fez separadas em scripts soltos pela rede:

• Padronizar máquina nova (setup wizard guiado em etapas)
• Instalar pacote de apps via winget (catálogo curado de 77 apps em 10 categorias, incluindo VPN)
• Remover bloatware do Windows 11 (perfil aplicado via Win11Debloat embarcado)
• Diagnóstico de máquina (saúde geral, disco SMART, eventos críticos, drivers com problema, atualizações pendentes)
• Manutenção rotineira (limpadores de cache, reparo SFC/DISM, reset de serviços que travam, relatório de bateria de notebooks)
• Desinstalação profunda estilo Revo (McAfee, Norton, OEM bloatware) ou por busca livre
• Wizards guiados pros chamados que a TI mais recebe (impressora não imprime, sem internet, não loga no AD)
• Auto-update via share de rede corporativo

Funciona offline (exceto o catálogo winget e os apps que ele baixa). Não exige instalação. Não exige internet pra rodar a maior parte das operações de diagnóstico/reparo.

Para quem foi pensada

• Técnicos de TI que atendem estações Windows no dia a dia.
• Empresas pequenas e médias que não têm SCCM/Intune mas precisam de um padrão de setup repetível.
• Profissionais em formação que querem estudar um projeto real de automação Windows com batch + PowerShell.
• Administradores de fleet que querem um ponto de entrada único pros scripts de manutenção que costumavam estar espalhados.

Não substitui ferramentas pagas como PDQ Deploy, Intune ou SCCM. Complementa, ou serve onde essas ferramentas não chegaram ainda.

---

Recursos

Instalação de aplicativos

Recurso	Detalhes
Catálogo local	Apps em Apps/<categoria>/<sub>/<app>/ com config.cmd opcional pra detecção de "já instalado"
Catálogo winget	77 apps em 10 categorias: Navegadores, Comunicação, Produtividade, Mídia, Desenvolvimento, Virtualização e Boot, Utilitários, TI/Redes, VPN, Segurança
Por setor	Perfis configuráveis (Produção, Administrativo, Financeiro, TI, Desenvolvimento, Gestão)
Instalar tudo	Loop por todos os apps configurados em Apps/

Manutenção e diagnóstico (17 opções)

• Diagnóstico: hardware, drivers, processos, BSOD, relatório TXT completo
• Disco: espaço, SMART, limpeza, defrag/TRIM, top arquivos
• EventLog: erros System/Application, busca por ID, export .evtx
• Serviços: listar, start/stop/restart, alterar tipo de inicialização
• Rede: IP, ping, tracert, netstat, SSL, Wi-Fi salvas com senha
• Impressoras: listar, adicionar por IP, fila, spooler
• Reparo: SFC, DISM, CHKDSK, WinSxS Cleanup, reset Windows Update
• Segurança: Defender status/scan, Firewall, BitLocker, admins locais
• Usuários: criar, senha, admin, ativar/desativar
• Backup: perfil do usuário com ROBOCOPY (resistente a falhas)
• Limpadores: Outlook OST, Teams cache, navegadores, Office cache, SSO M365, TEMP
• Wizards guiados: impressora não imprime, sem internet, não loga AD
• Bateria: relatório powercfg /batteryreport completo (notebooks)
• Reset rápido de serviços: Spooler, WU+BITS, Search, Themes, Audio, Network Stack, Explorer
• Atalhos rápidos: 20 destinos comuns (AppData, hosts, devmgmt, gpedit, msinfo32...)
• Painel de saúde + export TXT: pronto pra anexar em ticket
• Auto-update: sincroniza com share corporativo

Desinstalação

• Simples: via winget uninstall
• Profunda: catálogo curado de OEM bloatware (McAfee, Norton, Avast, Lenovo Vantage, HP Wolf, Dell Support, Acer Care, etc.) — limpa registro, serviços, tarefas, pastas residuais
• Por busca livre: qualquer app, escaneia tudo e remove (com blacklist do SO pra segurança)

Modo CLI

13 flags pra automação via Task Scheduler, atalho de Desktop, ou GPO. Detalhes em docs/10-modo-cli.md.

---

Pré-requisitos

• Windows 10 (1809+) ou Windows 11
• PowerShell 5.1 (incluso no Windows) — alguns módulos preferem PS 7+ se disponível
• App Installer / winget (vem nativo no Windows 11; no 10 pode precisar atualizar pela Microsoft Store)
• Direitos de administrador (o .bat faz auto-elevação via UAC)

---

Instalação

Não tem instalador. É portátil.

1. Baixe o projeto (clone ou download do .zip):

   git clone https://github.com/TecPlayBR/WindowsAutomationTool.git

2. Mova a pasta para onde preferir (ex.: C:\Tools\WindowsAutomation\).

3. (Opcional) Crie um atalho na Área de Trabalho com "Executar como administrador":

   powershell -ExecutionPolicy Bypass -File Scripts\Build-Shortcut.ps1 -PublicDesktop

4. Pronto. Use clicando duplo no .bat ou via linha de comando.

Para deploy em massa em ambiente corporativo, veja docs/04-gpo.md (atalho via GPO, AppLocker, share de rede).

---

Como usar

Pelo menu interativo

1. Clique com botão direito em WindowsAutomation.bat.
2. Executar como administrador.
3. Aceite o UAC.
4. Escolha a opção do menu.

A primeira tela mostra um bloco INFO DA MAQUINA com Serial BIOS, Patrimônio (SMBIOS Asset Tag), Modelo, BIOS, CPU, RAM, edição do Windows, chave de produto, status de ativação e Office. Útil pra TI chegar e já ter as informações relevantes da máquina à mão.

Pelo CLI

WindowsAutomation.bat /health        :: painel de saúde direto
WindowsAutomation.bat /wizard        :: setup wizard de máquina nova
WindowsAutomation.bat /catalog       :: catálogo winget
WindowsAutomation.bat /debloat       :: aplica perfil de debloat
WindowsAutomation.bat /install-all   :: instala todos apps de Apps/
WindowsAutomation.bat /help          :: lista completa de flags

---

Preview do menu

 ================================================================================

   ████████╗███████╗ ██████╗██████╗ ██╗      █████╗ ██╗   ██╗
   ╚══██╔══╝██╔════╝██╔════╝██╔══██╗██║     ██╔══██╗╚██╗ ██╔╝
      ██║   █████╗  ██║     ██████╔╝██║     ███████║ ╚████╔╝
      ██║   ██╔══╝  ██║     ██╔═══╝ ██║     ██╔══██║  ╚██╔╝
      ██║   ███████╗╚██████╗██║     ███████╗██║  ██║   ██║
      ╚═╝   ╚══════╝ ╚═════╝╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝

                     W I N D O W S   A U T O M A T I O N   T O O L
                                  v1.4.0
 ================================================================================

   Criado por : Bryan Paim Garcia
   Empresa    : Tecplay
   Versao     : v1.4.0

 ================================================================================

   INFO DA MAQUINA  (auditoria / inventario)

     Serial BIOS  : XXXXXXX
     Patrimonio   : N/D
     Modelo       : Dell Inc. Latitude 5520
     BIOS         : 1.20.0 (2025-04-12)
     CPU          : Intel(R) Core(TM) i5-1145G7
     RAM          : 16.0 GB
     Windows      : Microsoft Windows 11 Pro
     Chave Win    : XXXXX-XXXXX-XXXXX-XXXXX-XXXXX   [Ativado]
     Office       : N/I

 ================================================================================

   INSTALAR

     [1]  Catalogo TECPLAY (apps em Apps/)
     [2]  Instalar TUDO do catalogo TECPLAY
     [3]  Instalar por SETOR (Producao, Admin, Financeiro, TI...)
     [4]  Catalogo winget (10 categorias, 77 apps)

   MANUTENCAO

     [5]  Verificar atualizacoes (winget upgrade)
     [6]  Desinstalar aplicativo
     [7]  Limpar Bloatware (Debloat Win11)
     [8]  Manutencao e Diagnostico (17 opcoes)

   DIAGNOSTICO E SETUP

     [9]  Painel de Saude da maquina
     [10] Setup nova maquina (wizard guiado)
     [11] Reiniciar / Desligar / Logoff
     [12] Abrir pasta de Logs

     [0]  Sair

Nota visual: o menu usa apenas ASCII + box-drawing 3-byte (BMP) para garantir renderização consistente em qualquer instalação do Windows 10/11. Emojis 4-byte (rocket, folder, etc.) foram evitados porque o conhost.exe padrão não renderiza esses code points mesmo com chcp 65001 ativo.

---

Estrutura do projeto

WindowsAutomation/
├── WindowsAutomation.bat    # entry point (menu interativo + CLI)
├── version.txt              # versao corrente (lida pelo Self-Update)
├── LICENSE                  # licenca de uso livre nao-comercial
├── README.md                # este arquivo
├── Apps/                    # apps locais opcionais (vazio por padrao)
│   └── <CATEGORIA>/<SUB>/<App>/config.cmd
├── Scripts/                 # 22 modulos
│   ├── Core/                # install_app, ui_header, MachineInfo
│   ├── Catalog/             # catalog.json + Catalog.ps1 (winget)
│   ├── HealthCheck/         # Health.ps1 (painel + export)
│   ├── Debloat/             # wrapper + Win11Debloat embarcado
│   ├── Limpadores/          # cache de Outlook/Teams/navegadores/etc.
│   ├── Wizards/             # impressao, internet, login AD
│   ├── Bateria/             # powercfg /batteryreport
│   ├── Atalhos/             # 20 destinos comuns
│   ├── Servicos/            # listar + reset rapido
│   ├── Setores/             # instalacao por setor (json + ps1)
│   ├── Uninstall/           # simples, profunda, scan
│   ├── Self-Update/         # sincroniza com share corporativo
│   └── ...
├── Tools/Smoke-Test.ps1     # validador de estrutura/encoding/parse
├── Template/                # scaffolding pra adicionar novos apps
└── docs/                    # 16 documentos guia

---

Customizando para sua empresa

A ferramenta vem com a marca TECPLAY apenas como exemplo visual. Pra adaptar para sua organização:

1. Trocar o nome no ASCII art

Edite WindowsAutomation.bat e troque os blocos com a logo TECPLAY por sua marca. Use um gerador online de ASCII art tipo "ANSI Shadow" e cole no lugar.

2. Trocar nome da empresa nos cabeçalhos

Procure por TECPLAY (case-sensitive) no .bat e nos .cmd de Scripts/ e substitua. Sugestão de comando PowerShell:

Get-ChildItem -Recurse -Include *.bat,*.cmd,*.ps1,*.md | ForEach-Object {
    (Get-Content $_.FullName -Raw) -replace 'TECPLAY','SUAEMPRESA' |
        Set-Content $_.FullName -Encoding utf8
}

3. Configurar share corporativo (auto-update)

Edite Scripts/Self-Update/update.config apontando para sua pasta de rede que terá a versão mestre. Detalhes em docs/12-self-update.md.

4. Definir setores específicos da sua empresa

Edite Scripts/Setores/setores.json listando os setores e os apps (local ou via winget ID) que cada um deve ter por padrão. Detalhes em docs/11-setores.md.

5. Perfil de Debloat customizado

Edite ou copie Scripts/Debloat/Appslist-Tecplay.txt listando os apps do Windows 11 que devem ser removidos no perfil corporativo. Detalhes em docs/02-debloat.md.

---

Modo CLI / automação

Útil pra agendar via Task Scheduler, ou criar atalhos diretos no Desktop pros operadores:

Flag	Ação
/health	Abre o Painel de Saúde direto
/wizard	Abre o Setup Wizard de máquina nova
/catalog	Abre o Catálogo winget
/wizards	Abre os Wizards de diagnóstico
/limpadores	Abre os Limpadores de cache
/debloat	Aplica perfil de Debloat (silencioso)
/update	Verifica e aplica winget upgrade
/uninstall	Interface de desinstalação
/install-all	Instala todos apps de Apps/
/install <path>	Instala app específico
/setores [SETOR]	Abre Setores (direto se passar SETOR)
/update-self	Sincroniza ferramenta com share corporativo
/check-update	Só verifica (exit 10 = update disponível)
/deep-uninstall [ID]	Desinstalação profunda (MCAFEE, NORTON...)
/scan-uninstall [nome]	Scan + limpeza por busca livre

Detalhes completos em docs/10-modo-cli.md.

---

Documentação

A pasta docs/ tem material técnico completo:

Documento	Tópico
00-comece-aqui.md	Comece por aqui — fluxograma por objetivo
01-instalacao.md	Instalação de apps, adicionar novos, config.cmd
02-debloat.md	Limpeza de bloatware, perfil customizável
03-manutencao.md	Os 17 módulos de manutenção em detalhe
04-gpo.md	Deploy via Group Policy, atalhos, share
05-desenvolvimento.md	Como estender, convenções, smoke test
06-saude-e-setup.md	Painel de Saúde + Setup Wizard + auto-discovery
07-catalogo-winget.md	Catálogo winget (77 apps em 10 categorias)
08-limpadores.md	Limpadores (Outlook, Teams, navegadores, SSO, TEMP)
09-wizards.md	Wizards guiados (Impressão, Internet, Login AD)
10-modo-cli.md	Modo CLI completo (flags + exit codes)
11-setores.md	Instalação por setor (PRODUCAO, TI, etc.)
12-self-update.md	Self-update via share corporativo
13-seguranca.md	Hardening via GPO (NTFS + AppLocker + Audit)
14-uninstall-profundo.md	Limpeza profunda estilo Revo
99-faq-troubleshooting.md	FAQ + soluções pros problemas mais comuns

---

Contribuindo

Contribuições são muito bem-vindas, especialmente:

• Wizards adicionais pros chamados que sua TI mais recebe
• Targets novos pro Deep Uninstall (OEMs específicos)
• Apps no catálogo winget que faltaram
• Traduções (a maior parte está em pt-BR)
• Bugfixes e melhorias de UX
• Documentação

Como contribuir

1. Faça um fork.
2. Crie um branch (git checkout -b feature/minha-feature).
3. Rode o smoke test antes de commitar:

   powershell -ExecutionPolicy Bypass -File Tools\Smoke-Test.ps1

4. Commit com mensagem descritiva em português ou inglês.
5. Abra PR no branch main.

Convenções rápidas

• .bat/.cmd devem ser CRLF + UTF-8 sem BOM.
• .ps1 evita emojis 4-byte em strings (parser pode quebrar).
• Cada módulo novo em Scripts/<Modulo>/ com entrada no menu Manutenção.
• Apps novos em Apps/<CATEGORIA>/<SUB>/<App>/ com config.cmd opcional.
• Smoke test verde antes de PR.

---

Créditos

Este projeto seria impossível sem o trabalho de outros desenvolvedores. Crédito devido onde é devido:

Win11Debloat

Toda a parte de remoção de bloatware do Windows 11 é feita pelo Win11Debloat, do Raphire. O projeto é embarcado integralmente em Scripts/Debloat/Win11Debloat/ sob a licença MIT original. Este projeto apenas adiciona um wrapper (Scripts/Debloat/Debloat.cmd) e um perfil de apps (Scripts/Debloat/Appslist-Tecplay.txt) que você pode customizar pra sua organização.

Se você usa esta ferramenta para limpar bloatware, considere também:

• Dar uma ⭐ no repo do Raphire.
• Contribuir lá com bugs/features relacionados ao próprio Win11Debloat.

Microsoft winget

O catálogo de apps usa o winget (App Installer) da Microsoft. Os IDs no Scripts/Catalog/catalog.json apontam pra pacotes oficiais do repositório público winget-pkgs.

Comunidade brasileira de TI

A motivação pra fazer isso aberto veio de ver tantos colegas de profissão reinventando os mesmos scripts em cada empresa. Espero que sirva.

---

Licença

Software gratuito para uso não-comercial. Pode ser estudado, modificado, redistribuído. Não pode ser vendido.

Atribuição ao autor (Bryan Paim Garcia / Tecplay) e aos componentes de terceiros (Win11Debloat / Raphire) deve ser mantida.

Texto completo em LICENSE.

Não tem versão paga. Não tem licenciamento comercial alternativo. É livre mesmo, feito pra ajudar a galera da TI. Se for útil, deixa uma ⭐ e compartilha.

---

English summary

Windows Automation Tool is an open-source toolkit for IT professionals managing Windows workstations in corporate environments. Built with batch

• PowerShell, fully portable, no installation required.

Features

• New machine setup wizard (5-step guided)
• Curated winget catalog (77 apps in 10 categories including VPN)
• Local installer support (Apps/<category>/<subcategory>/<app>/)
• Sector-based installation profiles
• Windows 11 debloat (using Win11Debloat by Raphire, embedded)
• 17 maintenance/diagnostic modules (disk, network, services, events, Defender, BitLocker, drivers, repair, backup, cache cleaners, etc.)
• Battery health report (notebooks)
• Quick service reset (Spooler, WU, Search, Audio, Network)
• Deep uninstall (Revo-style, curated targets + free search)
• Self-update from corporate share
• Health dashboard with TXT export for tickets
• 13 CLI flags for automation

Quick start

1. Clone or download.
2. Right-click WindowsAutomation.bat → Run as Administrator.

License

Free for non-commercial use (personal, educational, internal corporate). Cannot be sold. Attribution required.

Third-party components retain their original licenses:

• Win11Debloat by Raphire (MIT)

This is truly free — no paid version, no commercial license, no "premium" tier. Star the repo if you find it useful.

---

Bryan Paim Garcia — Tecplay 🇧🇷 Brazil — 2026