> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/agente-realmjoin/installation.md).

# Implementação do Agent

Implemente o RealmJoin Agent em clientes Windows com o pacote intunewin pronto a usar da Package Store através do Intune.

O RealmJoin Agent pode ser implantado de forma integrada usando Microsoft Intune. Um pacote pronto para uso está disponível em nossa Package Store, simplificando o processo de configuração.\
Este guia descreve o método recomendado e compatível para instalar o RealmJoin Agent via Intune.

## Implantação Automática

### Microsoft Intune (intunewin)

{% hint style="success" %}
Recomendado
{% endhint %}

RealmJoin integra-se diretamente com o seu tenant do Microsoft Intune, adicionando e atualizando o agente como um pacote intunewin:

1. Abra o nosso **Package Store**.
2. Selecione o banner "RealmJoin Agent" ou use este link direto: [pacote RealmJoin Agent (Device)](https://portal.realmjoin.com/packagestore/45935/overview)<br>

   <figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FfeIw2aeCYivyheibRk7N%2Fimage.png?alt=media&amp;token=8a94847c-a5e6-4ba6-80cf-9256506ae53d" alt=""><figcaption></figcaption></figure>
3. Selecione "**Use o Intune (gerenciado)**" como método de implantação e clique em "Continuar".
4. Adicione este pacote ao seu "**Página de Status de Inscrição**" em "Bloquear o uso do dispositivo até que os aplicativos necessários sejam instalados, se estiverem atribuídos ao usuário/dispositivo". Isso garante que o Intune aguarde a instalação do RealmJoin Agent durante a inscrição.
5. Ative também "**canal principal de automação**".

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FYo2RBeON8S2CiF5Eh7cq%2Fimage.png?alt=media&amp;token=05cd015a-384b-44a4-8ab8-132646de8598" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
O agente do RealmJoin irá **verificar se há versões mais recentes** durante **a implantação inicial** e **atualizar, se necessário**. Para acelerar esse processo, ainda recomendamos "canal principal de automação". Isso garante que a versão mais recente seja instalada desde o início.
{% endhint %}

{% hint style="warning" %}
Por favor **não use "canal de pré-visualização automatizado"** pois o **ID do aplicativo intunewin pode mudar** o que removerá o pacote da sua configuração de "Página de Status de Inscrição".
{% endhint %}

6. **Atribua** o pacote para **dispositivos** (se atribuído a objetos de usuário, o agente pode não iniciar durante a implantação), por exemplo:
   1. Adicionar **dispositivos individuais ou grupos de dispositivos** para os grupos de aplicativos gerenciados criados automaticamente
   2. Adicione "**Todos os dispositivos**" como **atribuição adicional via Intune** (observe que talvez você precise de filtros para excluir dispositivos especiais como AVD ou quiosque)

{% hint style="info" %}
Nossa loja também oferece o pacote "RealmJoin Agent (User)" que é executado no nível do usuário (o que era o padrão no passado). Por **motivos de estabilidade**, agora **recomendamos apenas a versão em nível de dispositivo**.
{% endhint %}

## Canal Beta e Canary

{% hint style="info" %}
A versão de lançamento do RealmJoin **canal** pode ser **ajustado nas configurações de Usuário e Grupo**: [Configurar o canal de lançamento do RealmJoin](https://docs.realmjoin.com/pt/ugd-management/user-and-group-settings.md). Apenas **durante a implantação inicial**, os **canal é definido e fixado pelo instalador** pacote. Ao usar [Implantação Automática](#automatic-deployment) com nossa Package Store, as implantações usarão sempre o canal de lançamento.
{% endhint %}

Para **testar as implantações iniciais com outros canais**, você pode baixar e enviar manualmente um dos seguintes pacotes intunewin:

* Canal Beta (próximo ao estável, para testes de longo prazo):\
  [Versão Beta do RealmJoin](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)
* Canal Canary (experimental, para os primeiros testes):\
  [Versão Canary do RealmJoin](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

Ao enviar para o Intune, use as configurações sugeridas e:

* Programa:
  * Comportamento de reinicialização do dispositivo: `Determinar o comportamento com base nos códigos de retorno`
* Regras de detecção:
  * Configurar manualmente as regras de detecção
  * Arquivo:
    * Caminho: `C:\Program Files\RealmJoin`
    * Arquivo ou pasta: `RealmJoin.exe`
    * Método de detecção: `Arquivo ou pasta existe`
    * Associado a um aplicativo de 32 bits em clientes de 64 bits: `Sem`

## Exceções do Windows Defender

RealmJoin trabalhou com a equipe do Microsoft Defender para ser incluído na lista de permissões contra a detecção de malware. Como o Defender está usando cada vez mais mecanismos de aprendizado de máquina para identificar ameaças potenciais e o RealmJoin possui vários recursos, como instalações de aplicativos baixados da nuvem, o RealmJoin pode ser reconhecido pelo **Windows Defender** como uma ameaça possível.

Embora esse comportamento não seja certo, é recomendável implementar exceções adicionais do **Windows Defender Antivirus**:

| Exceções do Defender                            |
| ----------------------------------------------- |
| **Arquivos e Pastas**                           |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |
| **Processos**                                   |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |

{% hint style="info" %}
É importante configurar o mesmo caminho em **Arquivos e Pastas** e **Processos**. Em alguns casos, a Microsoft verifica apenas uma dessas Exceções do Defender.
{% endhint %}

## Informações adicionais

### Implantação Automática

#### Legado: Microsoft Intune (MSI)

{% hint style="warning" %}
Este **método de implantação legado** é fornecido apenas para fins de referência e **não é mais suportado**.

Observe também que [a Microsoft não recomenda misturar a implantação MSI e intunewin](https://learn.microsoft.com/en-us/intune/intune-service/apps/lob-apps-windows): "Se você misturar a instalação de aplicativos Win32 e aplicativos de linha de negócios durante a inscrição no Windows Autopilot, a instalação do aplicativo pode falhar, pois ambos usam o serviço Trusted Installer ao mesmo tempo."
{% endhint %}

RealmJoin pode ser implantado via [instalador MSI](#msi-installer) como um aplicativo de linha de negócios. Ao enviar para o Intune, verifique se "Ignorar versão do aplicativo" está definido como "Sim".

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FrShHt2tT5AvEUqx4gikB%2Fimage.png?alt=media&amp;token=ed311281-dd1b-4d42-bb9f-5cb13edee9e5" alt="" width="364"><figcaption></figcaption></figure>

### Instalação Interativa via Linha de Comando

Se um administrador quiser instalar o RealmJoin Agent em um dispositivo sem implantação em massa ou a infraestrutura do Microsoft Intune, pode baixar o MSI e fazer uma instalação interativa. Como alternativa, você também pode copiar uma das linhas de comando abaixo para baixar e executar o Agent em uma única etapa.

#### instalador MSI e EXE

* Versão estável:\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.msi) ou [EXE](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe)
* Canal Beta (próximo ao estável, para testes de longo prazo):\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.msi) ou [EXE](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe)
* Canal Canary (experimental, para os primeiros testes):\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.msi) ou [EXE](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe)

#### Canal de Lançamento

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

#### Canal Beta

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

#### Canal Canary

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

### Instalação silenciosa

Ao instalar o RealmJoin durante uma instalação desassistida do sistema operacional ou qualquer outro método de implantação não interativo, você pode optar por não ter nenhuma interação de interface durante a instalação. Para instalar o RealmJoin nesse cenário, use a opção de instalação silenciosa:

```
reamjoin.exe -install
```

### MSI assinado

O RealmJoin.MSI é assinado com SHA2 (256 bits) pelo RealmJoin e, portanto, reconhecido pelo Windows como seguro para instalação.

![](https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FLgoUYkRJF8acq3qRvNfj%2Frealmjoin.msi.signature.png?alt=media\&token=b33acfc4-8f6f-4813-adeb-ac6c5c2e59cc)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/agente-realmjoin/installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
