Pacote completo de exemplos de scripts power shell

??

Vou montar o Manual de Uso v4.5 do WAS Orchestrator Kit — organizado, claro, didático e pronto para operação diária.

?

?? Manual de Uso – WAS Orchestrator Kit v4.5

?

?? Índice
1. Introdução
2. Pré-requisitos
3. Estrutura do Kit
4. Fluxo de Instalação
5. Menu Principal e Modos
6. Funcionalidades por Categoria
• Instalação & Setup
• Segurança & Hardening
• Monitoramento & Auditoria
• Automação & DR-Plan
• Métricas & Observabilidade
7. Operação Diária
8. Exemplos de Uso
9. Validação & Troubleshooting
10. Conclusão
11. Referências

?

1. Introdução

O WAS Orchestrator Kit é um conjunto de scripts e utilitários para gerenciar o WEBDEV Application Server (W.A.S.) e o Microsoft IIS (Msiis).
Ele cobre instalação, configuração, auditoria, segurança, monitoramento, backup, DR e métricas observáveis (Prometheus/Grafana).

Versão atual: v4.5
Autor: Adriano José Boller

?

2. Pré-requisitos
• Windows Server 2016+
• PowerShell 5.1 ou 7+
• IIS habilitado
• WEBDEV Application Server instalado
• Permissão de Administrador Local

?

3. Estrutura do Kit

C:\WAS\Bundle\
+-- Scripts\
¦ +-- Start-CompleteWASConfiguration.ps1
¦ +-- Metrics-Exporter.ps1
¦ +-- Metrics-Exporter-Service.ps1
¦ +-- DR-Plan.ps1
¦ +-- Sign-All.ps1
¦ +-- Validate-Install.ps1
+-- Profiles\
¦ +-- DR-Plan.yaml
+-- Installer\
¦ +-- Build-Installer-EXE.cmd
+-- Reports\
¦ +-- WAS-Audit.html
+-- Docs\
+-- WAS-Orchestrator-Addendum-v4.5.pdf


?

4. Fluxo de Instalação
1. Copiar o bundle para C:\WAS\Bundle
2. Rodar:

C:\WAS\Bundle\Scripts\Start-CompleteWASConfiguration.ps1 -RunDiagnostics


3. Instalar exporter como serviço:

C:\WAS\Bundle\Scripts\Metrics-Exporter-Service.ps1 -Action Install


4. (Opcional) Build .EXE instalador completo:

C:\WAS\Bundle\Installer\Build-Installer-EXE.cmd



?

5. Menu Principal e Modos

O kit apresenta menus interativos em PowerShell:
• Modo Normal ? instalação, auditoria e correções básicas.
• Modo Hardening Max ? segurança reforçada (TLS forte, idle=0, alwaysRunning).
• Modo Safe Test ? abre portas + desliga firewall para testes, depois reverte.
• DR-Plan ? ativa contingência conforme YAML.

?

6. Funcionalidades por Categoria

?? Instalação & Setup
• Instalar IIS (Install-IISFeatures)
• Criar Application Pools dedicados (WebdevAppPool)
• Configurar Handlers (*.awp, *.awws, *.wb)
• Criar sites virtuais

?? Segurança & Hardening
• Desativar UAC (opcional)
• Ajustar permissões NTFS para System32, IIS, WAS
• Habilitar/desabilitar firewall
• Forçar HTTPS + HSTS headers

?? Monitoramento & Auditoria
• WAS-Audit.html gera relatório colorido (verde/vermelho)
• Testes de integridade IIS + WAS
• Listagem de sites/pools/bindings

? Automação & DR-Plan
• DR-Plan.yaml define prioridades
• Suspensão automática de sites secundários
• Criação de banners temporários
• Tarefas agendadas (Task Scheduler) para auditorias/backup

?? Métricas & Observabilidade
• Exporter HTTP (http://localhost:4900/metrics)
• Métricas:
• Sites/pools up/down
• Última auditoria OK
• TLS (10/11/12/13 habilitados)
• HTTPS bindings ativos

?

7. Operação Diária
• Rodar auditoria manual

C:\WAS\Bundle\Scripts\Start-CompleteWASConfiguration.ps1 -RunDiagnostics


• Aplicar DR-Plan

C:\WAS\Bundle\Scripts\DR-Plan.ps1 -PlanFile C:\WAS\Bundle\Profiles\DR-Plan.yaml


• Validar integridade

C:\WAS\Bundle\Scripts\Validate-Install.ps1



?

8. Exemplos de Uso

Exemplo 1 – Instalação limpa do IIS + WAS

Start-CompleteWASConfiguration.ps1 -Force -RunDiagnostics

Exemplo 2 – Rodar em modo Safe Test

Start-CompleteWASConfiguration.ps1 -SafeTest

?? Abre portas 4900–4920, desliga firewall, testa, depois restaura.

Exemplo 3 – Exportar métricas Prometheus

Invoke-WebRequest http://localhost:4900/metrics

Exemplo 4 – Forçar restart do IIS

iisreset /restart

Exemplo 5 – Validar TLS ativo

(Get-Content http://localhost:4900/metrics) -match "tls"


?

9. Validação & Troubleshooting
• IIS parado ? Start-Service W3SVC
• WAS parado ? reiniciar serviço WDXXAWP correspondente
• Exporter não responde ? Metrics-Exporter-Service.ps1 -Action Restart
• Validação hashes ? Validate-Install.ps1

?

10. Conclusão

O kit não é apenas setup — é um orquestrador de infraestrutura completo:
instala, protege, monitora, automatiza, integra e gera métricas para observabilidade.

?

11. Referências
• PC SOFT Fóruns (WINDEV/WEBDEV/WAS)
• Microsoft IIS Documentation
• Prometheus / Grafana Docs
• Windows Security & Schannel Registry Keys