Pré-requisitos
Instalador EdgeDNSAgent.msi
Token do cliente para instalação automatizada
Permissão para executar instalação MSI no Windows (nível de permissão não detalhado no rascunho)
Acesso à API EdgeDNS para validação do token
Passo a Passo
1. Instalar com Token (automatizado)
Abra um terminal no Windows (Prompt/PowerShell) no diretório onde está o
EdgeDNSAgent.msi.Execute a instalação informando o token:
msiexec /i EdgeDNSAgent.msi EDGEDNS_TOKEN="seu-token-aqui"
Exemplo prático
msiexec /i EdgeDNSAgent.msi EDGEDNS_TOKEN="abc123xyz789def456"
2. Gerar log de instalação (diagnóstico)
Use log detalhado para investigação de falhas:
msiexec /i EdgeDNSAgent.msi EDGEDNS_TOKEN="abc123xyz789" /l*v C:\Temp\instalacao.log
3. Como funciona (validação do token)
O instalador valida o token contra a API EdgeDNS
Se válido: a instalação prossegue e o agente já inicia configurado
Se inválido: a instalação é bloqueada com mensagem de erro
Se não fornecido: a instalação prossegue, mas será necessária configuração manual posterior
4. Verificação da Instalação
A) Verificar se o serviço está rodando
Via Prompt de Comando:
sc query EdgeDNSAgentService
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
5. Gerenciamento do Serviço
O Agent roda como serviço Windows: EdgeDNSAgentService.
Iniciar/parar/reiniciar/status via executável:
# 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
Comandos 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
Comandos 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 usado pelo instalador para validar na API e automatizar configuração | Texto (token) |
| Gera log detalhado da instalação para diagnóstico | Caminho de arquivo (ex.: |
API EdgeDNS | Serviço usado para validar o token durante a instalação | Texto (token) |
Troubleshooting
Sintoma | Causa provável | Ação corretiva |
Instalação é bloqueada com mensagem de erro | Token inválido | Validar o token e reinstalar usando |
Instalação conclui, mas exige configuração manual | Token não fornecido | Reexecutar a instalação informando |
Falha sem detalhes suficientes | Ausência de log | Repetir a instalação com |
Avisos e Boas Práticas
Trate o token como informação sensível (não compartilhar em canais inseguros).
Em caso de falha, gere sempre o log com
/l*vantes de novas tentativas.