> 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/product-docs/product-guide/configuracoes/sonar/rmm/how-to/implementar-agentes/gerando-um-agente-windows.md).

# Gerando um agente Windows

Nesta sessão iremos abordar como gerar um agente do SonarRMM para dispositivos Windows

{% stepper %}
{% step %}

#### Acessar a sessão de geração de agent

Clique em AGENTS >> INSTALL

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-a203a8e99eb8a8e2383286578663eb984827de08%2FCaptura%20de%20Tela%202025-10-22%20a%CC%80s%2015.21.03.png?alt=media" alt=""><figcaption></figcaption></figure>

Defina os parametros desejados e clique em Download.

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-671c3c2f59c4d05ed55a2a2025b7f9c8ac24a690%2FCaptura%20de%20Tela%202025-10-22%20a%CC%80s%2015.11.29.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Siga os passos abaixo se desejar detalhes de cada item da geração de agents
{% endhint %}
{% endstep %}

{% step %}

#### Geração de Agent - Sistema Operacional e Tipo de Agent

Após selecionar Client e Site prossiga para a seleção de sistema operacional e tipo de agente.

{% hint style="info" %}
A definição do tipo de agente (Server ou Workstation) serve apenas para fins de identificação no SonarRMM e não afeta as funcionalidades ou a coleta de dados pelo agente, com exceção da funcionalidade ‘Disable Sleep/Hibernate’, que pode ser habilitada ou desabilitada apenas em estações de trabalho (Workstations).
{% endhint %}

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-c31849efbc7ab8e94382b8c53ee3322de5e0898a%2FCaptura%20de%20Tela%202025-07-31%20a%CC%80s%2014.42.38.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Geração de Agent - Validade do Agent e Arquitetura

No campo Token expiration (hours) defina quanto tempo o agente gerado terá de validade em horas.

{% hint style="warning" %}
Se for definido um tempo curto de validade, a instalação pode falhar caso o prazo expire durante o processo. Em ambientes grandes, especialmente ao utilizar GPO para instalação, recomenda-se configurar um período de validade mais longo (em horas) para evitar falhas.
{% endhint %}

No campo ‘Arch’, selecione a arquitetura desejada para o agente: 64 bits ou 32 bits, conforme o sistema operacional dos dispositivos de destino.

{% hint style="warning" %}
Atente-se ao selecionar a arquitetura do agente: agentes gerados para sistemas 64 bits não funcionarão em dispositivos Windows 32 bits.
{% endhint %}

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-fcf216c94ec87ccd6169a48efd938a3833d914e9%2FCaptura%20de%20Tela%202025-07-31%20a%CC%80s%2014.53.10.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Geração do Agent - Funcionalidades Opcionais

No campo ‘Funcionalidades Opcionais’, selecione os recursos que deseja habilitar na geração do agente.

{% hint style="info" %}
Deseja saber mais sobre as Optional Features (Funcionalidades Opcionais)? [Clique aqui](/product-docs/product-guide/configuracoes/sonar/rmm/how-to/implementar-agentes/funcionalidades-opcionais.md) para acessar a seção explicativa.
{% endhint %}

{% hint style="warning" %}
Uma vez gerado com determinado recurso opcional habilitado, não será possível desativá-lo posteriormente. Para desabilitar um recurso opcional em um dispositivo específico, será necessário gerar um novo agente e o reinstalar.
{% endhint %}
{% endstep %}

{% step %}

#### Geração do Agent - Método de Instalação

Para geração de agents Windows contamos com 3 opções<br>

* **Dynamically generated exe:** Na forma mais simples de geração, o agente é criado como um arquivo .exe que, ao ser executado como administrador, é instalado e configurado automaticamente.

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-decb40a82087ec56f47084428c6c15f6e6dcc48c%2FCaptura%20de%20Tela%202025-07-31%20a%CC%80s%2017.10.55.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Powershell**: O método de instalação via PowerShell gera um script .ps1, que pode ser utilizado para automatizar a instalação do agente em dispositivos Windows. Esse formato é ideal para implantações em massa, como via GPO, scripts de login ou ferramentas de gerenciamento remoto, facilitando a padronização e economizando tempo no processo de instalação.

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-b45a5caebe82d06fa38ed93e36dbf26e4779b88e%2FCaptura%20de%20Tela%202025-07-31%20a%CC%80s%2017.17.00.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Manual:** O método manual gera um script de instalação que pode ser colado diretamente no terminal PowerShell ou CMD do Windows. É a opção com o maior nível de personalização, permitindo:

  * Definir o nível de debug para os logs de instalação;
  * Realizar a instalação de forma silenciosa (silent install);
  * Indicar o caminho de uma instalação pré-existente do MeshCentral, evitando reinstalação;
  * Escolher se o agente do MeshCentral será instalado junto com o agente do Sonar;
  * Definir um certificado CA que será utilizado pelo Agente para se comunir com o servidor Sonar;
  * Atribuir uma descrição personalizada ao agente instalado;
  * Configurar o uso de proxy, se necessário.<br>

  Esse método é ideal para cenários avançados, testes personalizados ou integração com processos existentes de automação e gerenciamento.

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-0a49db9731a67be7507d7fb2830cfb5257b261cb%2FCaptura%20de%20Tela%202025-07-31%20a%CC%80s%2019.43.12.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-02ff1eb04affa85027e8a001cb02a41147879eed%2FCaptura%20de%20Tela%202025-07-31%20a%CC%80s%2019.45.33.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}