# Gerando um agente Windows

{% stepper %}
{% step %}

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

Clique em AGENTS >> INSTALL

<figure><img src="/files/ogv4qz9p7zqSCjQYpwZm" alt=""><figcaption></figcaption></figure>

Defina os parametros desejados e clique em Download.

<figure><img src="/files/LB0tAtolttP2DoZ6BCGE" 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="/files/82BNYkPvTNkdimspd8e9" 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="/files/OeUXJw9bXNdYFwjSXrG0" 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-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="/files/LcnwbhULIVBPzLpgrsK5" 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="/files/Rd2EXjkHiFFqMIwoL17C" 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="/files/7YDJRN9f7uCTDdH4j8MJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/sYfqB61XbyQpUY7okp1N" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.datadike.com/product-guide/configuracoes/sonar/rmm/how-to/implementar-agentes/gerando-um-agente-windows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
