Passar para o conteúdo principal

Instalação Silenciosa do Agent EdgeDNS no Windows (msiexec, Token e Log)

Este artigo descreve como instalar o EdgeDNSAgent.msi em modo silencioso via msiexec. Aprenda a usar /qn ou /qb, aplicar EDGEDNS_TOKEN, gerar log com /l*v e evitar reinício com /norestart.

Atualizado há mais de um mês

Pré-requisitos

  • Arquivo EdgeDNSAgent.msi disponível no Windows

  • (Opcional) Token para instalação com configuração automatizada: EDGEDNS_TOKEN="seu-token"

  • (Opcional) Diretório para log existente (exemplo: C:\Temp\)


Passo a Passo

1. Instalação silenciosa simples (sem interface)

Execute:

msiexec /i EdgeDNSAgent.msi /qn

2. Instalação silenciosa com token

Execute:

msiexec /i EdgeDNSAgent.msi EDGEDNS_TOKEN="seu-token" /qn

3. Instalação silenciosa com token e log detalhado

Execute:

msiexec /i EdgeDNSAgent.msi EDGEDNS_TOKEN="seu-token" /qn /l*v C:\Temp\instalacao.log

4. Instalação com barra de progresso

Execute:

msiexec /i EdgeDNSAgent.msi EDGEDNS_TOKEN="seu-token" /qb


5. 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


6. 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

/i

Instalar

Literal /i

/x

Desinstalar

Literal /x

/qn

Modo silencioso (sem interface)

Literal /qn

/qb

Modo silencioso com barra de progresso

Literal /qb

/l*v arquivo.log

Gerar log detalhado

Caminho de arquivo (ex.: C:\Temp\instalacao.log)

/norestart

Não reiniciar após instalação

Literal /norestart

EDGEDNS_TOKEN="..."

Informar token na instalação

Texto entre aspas (ex.: "seu-token")


Troubleshooting

Sintoma

Causa provável

Ação corretiva

Instalação abre interface (não ficou silenciosa)

Parâmetro /qn ou /qb não foi usado

Reexecutar com /qn (silencioso) ou /qb (barra de progresso)

Log não é gerado

Parâmetro /l*v não foi usado

Reexecutar com /l*v C:\Temp\instalacao.log

Log não é criado em C:\Temp\instalacao.log

Caminho do arquivo de log inválido/indisponível

Ajustar o caminho do arquivo.log para um local existente

Precisa de progresso visual na execução

Uso de /qn (sem interface)

Usar /qb para exibir barra de progresso


Avisos e Boas Práticas

  • Use /qn para automação total (sem interface) e /qb quando precisar de visibilidade do progresso.

  • Gere log com /l*v em instalações automatizadas para facilitar diagnóstico.

  • Padronize um caminho de log (ex.: C:\Temp\instalacao.log) e garanta que o diretório exista antes de executar.

  • Se não quiser reinício após a instalação, inclua /norestart

Respondeu à sua pergunta?