> 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/realmjoin-agent/installation.md). # Implementar o agente O agente RealmJoin pode ser implantado sem problemas usando o 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 suportado para instalar o agente RealmJoin via Intune. ## Implantação automática ### Microsoft Intune (intunewin) {% hint style="success" %} Recomendado {% endhint %} RealmJoin integra-se diretamente com o seu locatário Microsoft Intune, adicionando e atualizando o agente como um pacote intunewin: 1. Abra o nosso **Loja de Pacotes**. 2. Selecione o banner "RealmJoin Agent" ou use este link direto: [RealmJoin Agent (Dispositivo)](https://portal.realmjoin.com/packagestore/45935/overview)
3. Selecione "**Use Intune (gerenciado)**" como método de implantação e clique em "Continuar". 4. Adicione este pacote à sua "**Página de status de inscrição**" em "Bloquear o uso do dispositivo até que os aplicativos necessários sejam instalados, se forem 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**".
{% hint style="info" %} O agente RealmJoin irá **verificar 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 atual 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 da "Página de status de inscrição". {% endhint %} 6. **Atribua** o pacote a **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** aos grupos de aplicativos gerenciados criados automaticamente 2. Adicione "**Todos os dispositivos**" como **atribuição adicional via Intune** (observe que você pode precisar de filtros para excluir dispositivos especiais como AVD ou Kiosk) {% hint style="info" %} Nossa loja também oferece o pacote "RealmJoin Agent (Usuário)" que é executado no nível do usuário (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" %} O canal de lançamento do RealmJoin **canal** pode ser **ajustado por meio das configurações de Usuário e Grupo**: [Configurar o canal de lançamento do RealmJoin](/pt/ugd-management/user-and-group-settings.md). Somente **durante a implantação inicial**, o **canal é definido e fixado pelo instalador** pacote. Ao usar [Implantação automática](#automatic-deployment) com nossa Package Store, as implantações sempre usarão o canal de lançamento. {% endhint %} Para **testando implantações iniciais com outros canais**, você pode baixar e enviar manualmente um dos seguintes pacotes intunewin: * Canal Beta (próximo do estável, para testes de longo prazo):\ [Versão Beta do RealmJoin](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin) * Canal Canary (experimental, 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: `Determine o comportamento com base nos códigos de retorno` * Regras de detecção: * Configure manualmente as regras de detecção * Arquivo: * Caminho: `C:\Program Files\RealmJoin` * Arquivo ou pasta: `RealmJoin.exe` * Método de detecção: `O arquivo ou pasta existe` * Associado a um aplicativo de 32 bits em clientes de 64 bits: `Não` ## Exceções do Windows Defender O RealmJoin trabalhou com a equipe do Microsoft Defender para ser incluído na lista de permissões de 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 tem vários recursos, como instalações de aplicativos baixados da nuvem, o RealmJoin pode ser reconhecido pelo **Windows Defender** como uma possível ameaça. Embora esse comportamento não seja certo, recomenda-se implementar exceções adicionais do **exceções 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 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 do Windows Autopilot, a instalação do aplicativo pode falhar, pois ambos usam o serviço Trusted Installer ao mesmo tempo." {% endhint %} O RealmJoin pode ser implantado por meio do [instalador MSI](#msi-installer) como um aplicativo de linha de negócios. Ao enviar para o Intune, certifique-se de que "Ignorar versão do aplicativo" esteja definido como "Sim".
### 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, é possível 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 * Lançamento 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 do 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, 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 a instalação desassistida do SO 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. ![](/files/c042c01c9d323c5ea8cafa70ff87c1fc548e84fe) --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/pt/realmjoin-agent/installation.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.