> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-windows.md).

# Instalar o agente no Windows

Gere um instalador Windows em Agents › Install Agent, execute-o de forma interativa ou silenciosa e confirme que o dispositivo aparece em Sysadmin.

## O que é e quando usar

**Agents › Install Agent** gera um instalador para um cliente e um site. O instalador registra o dispositivo nesse site, instala o serviço do agente do SONAR e o agente de acesso remoto, e aplica os recursos opcionais que você selecionou. Use-o para cadastrar um único dispositivo Windows ou alguns poucos. Para centenas de dispositivos, reutilize um mesmo instalador pela sua ferramenta de distribuição de software ou use um link de implantação: veja [Implantar agentes em escala](https://wiki.datadike.com/pt/sonar/deploy-operate/mass-deployment.md).

## Antes de começar

* O seu papel tem a permissão **Install Agents** em **Admin Center › Roles**. Sem ela, o botão de geração fica desabilitado com *You don't have permission for this action*.
* O cliente e o site existem, e o seu papel dá acesso a esse site. Veja [Clientes e sites](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md).
* O dispositivo atende aos [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md): Windows 10, Windows 11 ou Windows Server 2016 e posteriores, e você tem direitos de administrador local nele.
* O dispositivo consegue alcançar os endereços da API e de acesso remoto do SONAR na 443/tcp. Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md).
* As exclusões de antivírus e EDR estão configuradas para `C:\Program Files\Sonar\`, `C:\Program Files\Mesh Agent\` e `C:\ProgramData\Sonar\`.

## Passos

### Gerar o instalador

1. Abra **Agents › Install Agent** no cabeçalho, ou clique em **New Agent** na lista de dispositivos de **Dashboard › Sysadmin**. O painel **Add an agent** se abre.
2. Escolha o **Client** e o **Site**.
3. Em **Operating system**, selecione **Windows**.
4. Em **Agent type**, selecione **Workstation** ou **Server**.
5. Em **Architecture**, selecione **64-bit** ou **32-bit**, de acordo com o sistema operacional do dispositivo.
6. Em **Optional features**, ligue ou desligue cada recurso. O que cada um altera no dispositivo está na referência de campos abaixo.
7. Em **Installation method**, escolha **Dynamic (.exe)**, **PowerShell** ou **Manual**.
8. Para limitar por quanto tempo o instalador funciona, ligue **Enable token expiration (hours)** e informe o número de horas em **Hours**.
9. Confira o resumo **Target** na parte de baixo do painel e clique no botão do método escolhido:
   * **Download Windows installer (.exe)** baixa `sonar-<client>-<site>-<type>-<architecture>.exe`;
   * **Get Powershell install script** baixa `sonar-<client>-<site>-<type>.ps1`;
   * **View manual setup instructions** abre a caixa de diálogo **Manual Installation**.

### Executar o instalador Dynamic (.exe) de forma interativa

1. Copie o arquivo para o dispositivo e execute-o. Aceite o pedido de elevação de privilégios.
2. Siga as páginas do instalador. Perto do fim, o agente mostra *Installation was successful! Allow a few minutes for the agent to properly display in the RMM*. Clique em **OK**.
3. Quando o instalador termina, uma caixa de status **Sonar RMM** mostra o estado do agente e do agente de acesso remoto.

### Executar o instalador Dynamic (.exe) em modo silencioso

Execute o arquivo com `/S` a partir de um prompt com privilégios elevados ou da sua ferramenta de implantação:

```
sonar-<client>-<site>-<type>-<architecture>.exe /S
```

`/S` oculta as páginas do instalador. O arquivo carrega todas as configurações escolhidas no console, então nenhum outro argumento é necessário.

{% hint style="info" %}
Executado a partir de uma sessão interativa, com um usuário conectado, o agente ainda mostra a caixa de mensagem final e espera o **OK**, mesmo com `/S`. Ferramentas que executam o arquivo como Local System em segundo plano, como um script de inicialização de GPO ou a maioria das ferramentas de distribuição de software, não mostram nada. Para uma execução sem intervenção dentro de uma sessão de usuário, use o script PowerShell ou o comando manual com `-silent`.
{% endhint %}

### Executar o script PowerShell

1. Copie o arquivo `.ps1` para o dispositivo.
2. Em uma janela do PowerShell com privilégios elevados, execute-o:

   ```
   powershell -ExecutionPolicy Bypass -File .\sonar-<client>-<site>-<type>.ps1
   ```

O script se encerra imediatamente com *Sonar RMM Is Already Installed* se o serviço `sonarrmm` existir. Caso contrário, ele espera o endereço da API responder na 443 (até três tentativas, exibindo *Waiting for network*), adiciona as pastas do SONAR às exclusões do Microsoft Defender quando o Defender está ativo, baixa o instalador, instala-o em modo silencioso e registra o agente com `-silent`, de modo que nenhuma caixa de mensagem aparece.

### Executar o comando manual

1. Na caixa de diálogo **Manual Installation**, clique em **Download Agent** para baixar `sonaragent-v<version>-windows-<architecture>.exe`.
2. Clique em **Copy Command Line**.
3. No dispositivo, abra um Prompt de Comando com privilégios elevados na pasta que contém o arquivo baixado.
4. Cole o comando, acrescente os **Optional Arguments** de que precisar (por exemplo `-silent` ou `-desc "Front desk PC"`) e pressione Enter.

O comando instala o arquivo baixado em modo silencioso, espera cerca de dez segundos e então executa o registro do agente com o cliente, o site, o tipo, o token e os recursos opcionais escolhidos no console.

## O que você deve ver

No dispositivo, três serviços quando o módulo de produtividade é selecionado, e dois nos demais casos:

| Nome do serviço            | Nome de exibição           | O que é                                                                                                                                                                                 |
| -------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sonarrmm`                 | Sonar Agent Service        | O agente do SONAR. Executa `C:\Program Files\Sonar\sonarrmm.exe -m svc` como Local System                                                                                               |
| `Mesh Agent`               | Mesh Agent                 | O agente de acesso remoto, em `C:\Program Files\Mesh Agent\`                                                                                                                            |
| `SonarProductivityService` | Sonar Productivity Service | O módulo de produtividade, instalado apenas quando **Sessions** está ligado. Veja [O módulo de produtividade](https://wiki.datadike.com/pt/sonar/deploy-operate/productivity-module.md) |

**Sonar**, editor **DataDike®**, aparece na lista de programas instalados.

No console, o dispositivo aparece em **Dashboard › Sysadmin**, sob o cliente e o site dele, em poucos minutos, com **Agent Status** **Online**.

### O que o instalador altera no dispositivo

| Alteração                                                                                                                                                                                                                                                                                     | Quando                             |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| O Windows Update é configurado para não instalar atualizações automaticamente (política `AUOptions` em `HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU`), para que a aplicação de atualizações seja conduzida pelo SONAR. Desinstalar o agente reativa as atualizações automáticas | Sempre                             |
| Configuração do agente gravada em `HKLM\SOFTWARE\Sonar`                                                                                                                                                                                                                                       | Sempre                             |
| Tempos limite de suspensão, hibernação, disco e monitor definidos como nunca, ação ao fechar a tampa definida como não fazer nada, inicialização rápida desativada                                                                                                                            | **Disable sleep/hibernate** ligado |
| Área de Trabalho Remota do Windows habilitada, e o grupo de regras de firewall da Área de Trabalho Remota habilitado                                                                                                                                                                          | **Remote access** ligado           |
| Regra de firewall *ICMP Allow incoming V4 echo request* adicionada                                                                                                                                                                                                                            | **Ping** ligado                    |
| Serviços de localização do Windows ativados, para que o agente possa informar a posição do dispositivo                                                                                                                                                                                        | **Geolocation** ligado             |
| Módulo de produtividade instalado como `SonarProductivityService`                                                                                                                                                                                                                             | **Sessions** ligado                |

## Como verificar se funcionou

1. No dispositivo, execute `"C:\Program Files\Sonar\sonarrmm.exe"` sem argumentos. A caixa de status **Sonar RMM** lista **Agent** e **Mesh Agent** com o estado de cada um. Os dois precisam estar em execução. `sc query sonarrmm` dá a mesma resposta a partir de um prompt.
2. No console, abra **Dashboard › Sysadmin**, escolha o cliente e pesquise o nome do host. A linha mostra **Agent Status** **Online**, o **Client** e o **Site** que você escolheu, o **Type** que você escolheu e a data de hoje em **First Seen**.
3. Selecione a linha. O cabeçalho do painel de detalhes mostra a versão do agente, e nenhum indicador **Remote Offline** depois que o agente de acesso remoto se conecta.
4. Em **Reports & Audits › Audits**, uma entrada **Agent Install** registra o novo agente com o nome do host dele.

## Erros comuns

| Sintoma                                                                                                                                                         | Causa                                                                                  | Correção                                                                                                                                                       |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *This application requires a 64-bit Windows operating system.*                                                                                                  | O instalador de 64 bits foi executado em um Windows de 32 bits                         | Gere o instalador de novo com **Architecture** **32-bit**                                                                                                      |
| *Installer token has expired. Please generate a new one.*                                                                                                       | O instalador foi gerado com **Enable token expiration (hours)** e esse prazo já passou | Gere um novo instalador                                                                                                                                        |
| *Old installer detected (version …). Latest version is … Please generate a new installer from the RMM*                                                          | O instalador foi salvo antes de a versão do agente do SONAR mudar                      | Gere um novo instalador                                                                                                                                        |
| Uma caixa de mensagem diz *Existing installation found*, com **OK** para removê-la e **Cancel** para abortar                                                    | O dispositivo já tem um agente                                                         | Clique em **OK** para desinstalá-lo e execute o instalador de novo. Veja [Remover agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/remove-agents.md) |
| Uma execução silenciosa termina imediatamente e nada é instalado; a saída diz *Existing installation found and must be removed before attempting to reinstall.* | O dispositivo já tem um agente, ou o que restou de um                                  | Execute `"C:\Program Files\Sonar\uninstall.exe" /S` e depois execute o instalador de novo                                                                      |
| *Sonar RMM Is Already Installed* (PowerShell)                                                                                                                   | O serviço `sonarrmm` existe                                                            | Desinstale primeiro e depois execute o script de novo                                                                                                          |
| *Unable to connect to server* (PowerShell)                                                                                                                      | A 443/tcp para o endereço da API está bloqueada                                        | Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md)                                                           |
| *Unable to download the mesh agent from the RMM.* ou *Failed to download mesh agent*                                                                            | O instalador não conseguiu obter o agente de acesso remoto pelo endereço da API        | Confira a conectividade com o endereço da API e execute o instalador de novo                                                                                   |
| O botão de geração está desabilitado                                                                                                                            | Nenhum cliente ou site está selecionado, ou o seu papel não tem **Install Agents**     | Selecione os dois, ou solicite a permissão                                                                                                                     |
| O dispositivo está instalado, mas não aparece em Sysadmin                                                                                                       | O agente não consegue manter a conexão com o endereço da API                           | Veja [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md)                                                  |

## Referência de campos

| Campo                               | O que faz                                                                                                                                                                               | Valores aceitos                                | Padrão                            |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | --------------------------------- |
| **Client**                          | Cliente em que o dispositivo é registrado                                                                                                                                               | Clientes aos quais o seu papel dá acesso       | Primeiro cliente da lista         |
| **Site**                            | Site em que o dispositivo é registrado                                                                                                                                                  | Sites do cliente escolhido                     | Primeiro site do cliente          |
| **Operating system**                | Plataforma do instalador                                                                                                                                                                | **Windows**, **Linux**, **macOS**              | **Windows**                       |
| **Agent type**                      | Registra o dispositivo como estação de trabalho ou como servidor. Define a coluna **Type** e o agendamento padrão do Windows Update do dispositivo                                      | **Workstation**, **Server**                    | **Workstation**                   |
| **Architecture**                    | Arquitetura de processador do instalador                                                                                                                                                | **64-bit**, **32-bit**                         | **64-bit**                        |
| **Sessions**                        | Instala o módulo de produtividade, que reporta a atividade e as sessões dos usuários e aplica as políticas de acesso                                                                    | Ligado, desligado                              | Ligado                            |
| **Geolocation**                     | Ativa os serviços de localização do Windows e informa a posição do dispositivo cerca de uma vez por hora                                                                                | Ligado, desligado                              | Ligado                            |
| **Remote access**                   | Habilita a Área de Trabalho Remota do Windows no dispositivo e as regras de firewall correspondentes. O agente de acesso remoto do SONAR é instalado com esta opção ligada ou desligada | Ligado, desligado                              | Ligado                            |
| **Ping**                            | Adiciona uma regra de firewall para que o dispositivo responda ao ping (eco ICMPv4)                                                                                                     | Ligado, desligado                              | Ligado                            |
| **Disable sleep/hibernate**         | Impede o dispositivo de entrar em suspensão ou hibernação. Exibido apenas para **Workstation**                                                                                          | Ligado, desligado                              | Ligado                            |
| **Installation method**             | Saída que o console produz                                                                                                                                                              | **Dynamic (.exe)**, **PowerShell**, **Manual** | **Dynamic (.exe)**                |
| **Enable token expiration (hours)** | Quando ligado, o instalador deixa de funcionar depois do número de horas informado                                                                                                      | Ligado, desligado; **Hours** de 1 a 999999     | Desligado; 24 horas quando ligado |

Os recursos opcionais são fixados na instalação. Para alterá-los em um dispositivo, gere um novo instalador e reinstale o agente.

### Argumentos opcionais do comando manual

| Argumento                                          | O que faz                                                                                                                       |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `-log debug`                                       | Saída detalhada durante a instalação                                                                                            |
| `-silent`                                          | Nenhuma caixa de mensagem durante a instalação                                                                                  |
| `-local-mesh "C:\<folder>\meshagent.exe"`          | Instala o agente de acesso remoto a partir de um arquivo local, em vez de baixá-lo                                              |
| `-meshdir "C:\Program Files\<company>\Mesh Agent"` | Pasta de um agente de acesso remoto já instalado, com identidade visual personalizada                                           |
| `-nomesh`                                          | Não instala o agente de acesso remoto. O controle remoto fica então indisponível no dispositivo                                 |
| `-cert "C:\<folder>\ca.pem"`                       | Usa uma autoridade certificadora do domínio                                                                                     |
| `-desc "<text>"`                                   | Define a **Description** do dispositivo                                                                                         |
| `-proxy "http://proxyserver:port"`                 | Usa um proxy HTTP. Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md#proxies) |

## Páginas relacionadas

* [Implantar agentes em escala](https://wiki.datadike.com/pt/sonar/deploy-operate/mass-deployment.md)
* [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md)
* [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md)
* [O módulo de produtividade](https://wiki.datadike.com/pt/sonar/deploy-operate/productivity-module.md)
* [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md)
