Pré-requisitos

Instalador MSI disponível em compartilhamento (ex.: \\servidor\compartilhamento\EdgeDNSAgent.msi)
Token do cliente para instalação automatizada: EDGEDNS_TOKEN="..."
Permissão para criar pasta de log (ex.: C:\Temp)
Para GPO:
- Ambiente com Active Directory
- Acesso ao Group Policy Management Console (gpmc.msc)
Para SCCM/Intune:
- Capacidade de executar linha de comando com msiexec
- Método de detecção por arquivo (conforme rascunho)
Conectividade com a API para teste (conforme rascunho): https://app.edgedns.com.br/api

Passo a Passo

1. Implantação via Script PowerShell (execução remota/gerenciador)

Ajuste as variáveis de configuração no script:
- $Token
- $MsiPath
- $LogPath
Garanta a criação do diretório de log C:\Temp (o script já cria, se não existir).
Execute o script PowerShell para instalar com modo silencioso (/qn) e log detalhado (/l*v).
Verifique o resultado pelo ExitCode:
- ExitCode -eq 0: sucesso
- Caso contrário: falha e consultar o log em $LogPath

Script PowerShell

# ============================================================
# Implantação EdgeDNS Agent - PowerShell
# ============================================================

# CONFIGURAÇÃO - Altere conforme necessário
$Token = "SEU-TOKEN-AQUI"
$MsiPath = "\\servidor\compartilhamento\EdgeDNSAgent.msi"
$LogPath = "C:\Temp\edgedns-install.log"

# Criar diretório de log
if (-not (Test-Path "C:\Temp")) {
New-Item -ItemType Directory -Path "C:\Temp" -Force | Out-Null
}

# Executar instalação
$args = "/i `"$MsiPath`" EDGEDNS_TOKEN=`"$Token`" /qn /l*v `"$LogPath`""
$process = Start-Process msiexec.exe -ArgumentList $args -Wait -PassThru

# Verificar resultado
if ($process.ExitCode -eq 0) {
Write-Host "Instalacao concluida com sucesso!" -ForegroundColor Green
} else {
Write-Host "Falha na instalacao. Codigo: $($process.ExitCode)" -ForegroundColor Red Write-Host "Verifique o log: $LogPath"
}

2. Implantação via Script Batch (.bat)

Ajuste as variáveis:
- TOKEN
- MSI_PATH
- LOG_PATH
Execute o .bat.
Verifique o retorno pelo %ERRORLEVEL% e consulte o log em %LOG_PATH%.

Script Batch (.bat)

@echo off
REM ============================================================
REM Implantação EdgeDNS Agent - Batch
REM ============================================================

REM CONFIGURAÇÃO - Altere conforme necessário SET TOKEN=SEU-TOKEN-AQUI
SET MSI_PATH=\\servidor\compartilhamento\EdgeDNSAgent.msi SET LOG_PATH=C:\Temp\edgedns-install.log

REM Criar diretório de log
if not exist "C:\Temp" mkdir "C:\Temp"

echo Instalando EdgeDNS Agent...
msiexec /i "%MSI_PATH%" EDGEDNS_TOKEN="%TOKEN%" /qn /l*v "%LOG_PATH%"

if %ERRORLEVEL% EQU 0 (
echo Instalacao concluida com sucesso!
) else (
echo Falha na instalacao. Codigo: %ERRORLEVEL% echo Verifique o log: %LOG_PATH%
)

pause

3. Implantação via GPO (Group Policy)

Preparar o MSI
- Copie o instalador para um compartilhamento acessível:
  - \\servidor\NETLOGON\EdgeDNS\EdgeDNSAgent.msi
Criar a GPO
- Abra o Group Policy Management Console (gpmc.msc)
- Crie uma nova GPO ou edite uma existente
- Navegue até:
  - Configuração do Computador → Políticas → Configurações de Software → Instalação de software
Adicionar o pacote
- Clique com botão direito → Novo → Pacote
- Selecione o MSI no compartilhamento
- Escolha Atribuído
Configurar o token (via script de inicialização)
- Em Configuração do Computador → Políticas → Configurações do Windows → Scripts → Inicialização
- Adicione um script PowerShell para configurar o token após a instalação
Aplicar a política
- Execute: bat gpupdate /force

4 Implantação via SCCM / Intune

1. Para instalação, use a linha de comando:

msiexec /i EdgeDNSAgent.msi EDGEDNS_TOKEN="seu-token" /qn /l*v %TEMP%\edgedns.log

2. Para desinstalação, use a linha de comando:

msiexec /x EdgeDNSAgent.msi UNINSTALL_PASSWORD="EdgeDNS@2025!Secure#Uninstall" /qn

3. Configure o método de detecção (conforme rascunho):

Verificar existência do arquivo:
- C:\Program Files (x86)\EdgeDNS Agent\edgedns-agent-service.exe

Observação: a senha UNINSTALL_PASSWORD é sensível e deve ser tratada como credencial operacional.

5 Verificação da Instalação

A) Verificar se o serviço está rodando

1. Via Prompt de Comando:

sc query EdgeDNSAgentService

2. Via PowerShell:

Get-Service -Name "EdgeDNSAgentService"

Resultado esperado: Status = RUNNING

B) Verificar se o produto está instalado

wmic product where "name like '%%EdgeDNS%%'" get Name,Version

C) Testar conectividade com a API

curl -I https://app.edgedns.com.br/api

6. Gerenciamento do Serviço (EdgeDNSAgentService)

A) Via executável (`edgedns-agent-service.exe`)

# REM Iniciar o serviço
edgedns-agent-service.exe start

# REM Parar o serviço
edgedns-agent-service.exe stop

# REM Reiniciar o serviço
edgedns-agent-service.exe restart

# REM Verificar status
edgedns-agent-service.exe status

B) Via SC (Service Control)

# REM Verificar status
sc query EdgeDNSAgentService

# REM Iniciar
sc start EdgeDNSAgentService

# REM Parar
sc stop EdgeDNSAgentService

# REM Reiniciar (parar + iniciar)
sc stop EdgeDNSAgentService && sc start EdgeDNSAgentService

C) Via PowerShell

# Verificar status
Get-Service EdgeDNSAgentService

# Iniciar
Start-Service EdgeDNSAgentService

# Parar
Stop-Service EdgeDNSAgentService

# Reiniciar
Restart-Service EdgeDNSAgentService

Referência de Campos

Campo	Função	Valores aceitos
`$Token` (PowerShell)	Token usado na instalação	Texto (ex.: `"SEU-TOKEN-AQUI"`)
`$MsiPath` (PowerShell)	Caminho do MSI em rede	UNC (ex.: `\\servidor\compartilhamento\EdgeDNSAgent.msi`)
`$LogPath` (PowerShell)	Caminho do log	Caminho Windows (ex.: `C:\Temp\edgedns-install.log`)
`TOKEN` (Batch)	Token usado na instalação	Texto (ex.: `SEU-TOKEN-AQUI`)
`MSI_PATH` (Batch)	Caminho do MSI em rede	UNC (ex.: `\\servidor\compartilhamento\EdgeDNSAgent.msi`)
`LOG_PATH` (Batch)	Caminho do log	Caminho Windows (ex.: `C:\Temp\edgedns-install.log`)
`EDGEDNS_TOKEN="..."`	Propriedade MSI para configurar com token	Texto entre aspas
`/qn`	Instalação silenciosa (sem interface)	Literal `/qn`
`/l*v <arquivo>`	Log detalhado do MSI	Caminho (ex.: `C:\Temp\edgedns-install.log`, `%TEMP%\edgedns.log`)
`%TEMP%`	Pasta temporária do Windows (usada no exemplo SCCM/Intune)	Variável de ambiente
`UNINSTALL_PASSWORD="..."`	Senha exigida na desinstalação	Texto entre aspas (`"EdgeDNS@2025!Secure#Uninstall"`)
`EdgeDNSAgentService`	Nome do serviço Windows do Agent	Literal `EdgeDNSAgentService`
Arquivo de detecção (SCCM/Intune)	Evidência de instalação	`C:\Program Files (x86)\EdgeDNS Agent\edgedns-agent-service.exe`

Troubleshooting

Sintoma	Causa provável	Ação corretiva
Script indica falha e mostra “Codigo: ”	`msiexec` retornou erro	Verificar o log em `C:\Temp\edgedns-install.log` (PowerShell/Batch) ou `%TEMP%\edgedns.log` (SCCM/Intune)
Log não é criado em `C:\Temp\...`	Pasta `C:\Temp` não existe	Criar `C:\Temp` (scripts já tentam criar)
Serviço não fica `RUNNING`	Serviço não iniciado/validado	Rodar `sc query EdgeDNSAgentService` e `Get-Service -Name "EdgeDNSAgentService"`
SCCM/Intune não detecta instalação	Regra de detecção não encontra o arquivo	Validar existência de `C:\Program Files (x86)\EdgeDNS Agent\edgedns-agent-service.exe`
GPO aplicada, mas token não configurado	Token depende de script de inicialização pós-instalação	Em Scripts → Inicialização, confirmar o script PowerShell que configura o token e reaplicar com `gpupdate /force`

Avisos e Boas Práticas

Proteja o token (EDGEDNS_TOKEN) e a senha de desinstalação (UNINSTALL_PASSWORD), pois são dados sensíveis.
Em implantações em massa, sempre habilite log (/l*v) para diagnóstico rápido.
Padronize o caminho de log (ex.: C:\Temp\...) e garanta que o diretório exista.
Após implantar, valide serviço RUNNING, produto instalado (wmic) e conectividade (curl -I).

Implantação em Massa do Agent EdgeDNS no Windows (PowerShell, Batch, GPO e SCCM/Intune)