> 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). # Implementação do agente O Agente RealmJoin pode ser implementado sem problemas usando o Microsoft Intune. Um pacote pronto a usar está disponível na nossa Loja de Pacotes, simplificando o processo de configuração.\ Este guia descreve o método recomendado e suportado para instalar o Agente RealmJoin via Intune. ## Implementação automática ### Microsoft Intune (intunewin) {% hint style="success" %} Recomendado {% endhint %} O RealmJoin integra-se diretamente com o seu Tenant do Microsoft Intune, adicionando e atualizando o agente como um pacote intunewin: 1. Abra a nossa **Loja de Pacotes**. 2. Selecione o banner "RealmJoin Agent" ou use esta ligação direta: [Agente RealmJoin (Dispositivo)](https://portal.realmjoin.com/packagestore/45935/overview)
3. Selecione "**Usar Intune (gerido)**" como método de implementação e clique em "Continuar". 4. Adicione este pacote à sua "**Página de estado de inscrição**" em "Bloquear o uso do dispositivo até que as aplicações necessárias estejam instaladas, se forem atribuídas ao utilizador/dispositivo". Isto garante que o Intune aguarda pela instalação do Agente RealmJoin durante a inscrição. 5. Por favor, ative também "**Canal principal de automação**".
{% hint style="info" %} O agente RealmJoin irá **procurar versões mais recentes** durante **a implementação inicial** e **atualizar, se necessário**. Para acelerar este processo, continuamos a recomendar "Automatizar o canal principal". Isto garante que a versão mais recente é instalada logo desde o início. {% endhint %} {% hint style="warning" %} Por favor **não utilize "Automatizar o canal de pré-visualização"** porque o **ID da aplicação intunewin pode mudar** o que removerá o pacote da sua configuração de "Página de estado de inscrição". {% endhint %} 6. **Atribua** o pacote a **dispositivos** (se for atribuído a objetos de utilizador, o agente pode não iniciar durante a implementação), por exemplo: 1. Adicionar **dispositivos individuais ou grupos de dispositivos** aos grupos de aplicações geridas criados automaticamente 2. Adicione "**Todos os dispositivos**" como **atribuição adicional via Intune** (note que poderá precisar de filtros para excluir dispositivos especiais como AVD ou Kiosk) {% hint style="info" %} A nossa loja também oferece o pacote "RealmJoin Agent (User)" que é executado ao nível do utilizador (que era o padrão no passado). Por **razões de estabilidade**, agora **recomendamos apenas a versão ao nível do dispositivo**. {% endhint %} ## Canal Beta e Canary {% hint style="info" %} O canal de lançamento do RealmJoin **canal** pode ser **ajustado através das definições de Utilizador e Grupo**: [Configure o canal de lançamento do RealmJoin](/pt/ugd-management/user-and-group-settings.md). Apenas **durante a implementação inicial**, o **canal é definido e fixado pelo instalador** pacote. Ao usar [Implementação automática](#automatic-deployment) com a nossa Loja de Pacotes, as implementações utilizarão sempre o canal de lançamento. {% endhint %} Para **testar implementações iniciais com outros canais**, pode descarregar e carregar manualmente um dos seguintes pacotes intunewin: * Canal Beta (próximo da estabilidade, para testes de longo prazo):\ [Versão Beta do RealmJoin](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin) * Canal Canary (experimental, para testes iniciais):\ [Versão Canary do RealmJoin](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin) Ao carregar para o Intune, utilize as definições sugeridas e: * Programa: * Comportamento de reinício do dispositivo: `Determinar o comportamento com base nos códigos de retorno` * Regras de deteção: * Configurar manualmente as regras de deteção * Ficheiro: * Caminho: `C:\\Program Files\\RealmJoin` * Ficheiro ou pasta: `RealmJoin.exe` * Método de deteção: `O ficheiro ou a pasta existe` * Associado a uma aplicação de 32 bits em clientes de 64 bits: `Não` ## Exceções do Windows Defender O RealmJoin trabalhou com a equipa do Microsoft Defender para ser incluído na lista de permissões da deteção de malware. Como o Defender utiliza cada vez mais mecanismos de aprendizagem automática para identificar potenciais ameaças e o RealmJoin tem várias funcionalidades como instalações de aplicações descarregadas da cloud, o RealmJoin pode ser reconhecido pelo **Windows Defender** como uma ameaça potencial. Embora este comportamento não seja certo, recomenda-se implementar exceções adicionais **exceções do Windows Defender Antivirus**: | Exceções do Defender | | ------------------------------------------------- | | **Ficheiros 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 **Ficheiros e Pastas** e **Processos**. Em alguns casos, a Microsoft verifica apenas uma destas Exceções do Defender. {% endhint %} ## Informações adicionais ### Implementação automática #### Legado: Microsoft Intune (MSI) {% hint style="warning" %} Este **método de implementação legado** é fornecido apenas para fins de referência e **já não é suportado**. Note também que [a Microsoft não recomenda misturar implementações MSI e intunewin](https://learn.microsoft.com/en-us/intune/intune-service/apps/lob-apps-windows): "Se misturar a instalação de aplicações Win32 e aplicações de linha de negócio durante a inscrição no Windows Autopilot, a instalação da aplicação poderá falhar, uma vez que ambas utilizam o serviço Trusted Installer ao mesmo tempo." {% endhint %} O RealmJoin pode ser implementado via [instalador MSI](#msi-installer) como uma aplicação de Linha de Negócio. Ao carregar para o Intune, certifique-se de que "Ignore app version" está definido como "Sim".
### Instalação interativa via linha de comandos Se um administrador quiser instalar o Agente RealmJoin num dispositivo sem implementação em massa ou sem a infraestrutura do Microsoft Intune, pode descarregar o MSI e fazer uma instalação interativa. Em alternativa, também pode copiar uma das linhas de comando abaixo para descarregar e executar o Agente num único passo. #### 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 da estabilidade, 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 testes iniciais):\ [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 desatendida do SO ou qualquer outro método de implementação não interativo, pode decidir não ter qualquer interação com a interface durante a instalação. Para instalar o RealmJoin num cenário desses, utilize a opção de instalação silenciosa: ``` reamjoin.exe -install ``` ### MSI assinado O RealmJoin.MSI é assinado com SHA2 (256 bits) pelo RealmJoin e, por isso, é 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: ``` GET https://docs.realmjoin.com/pt/realmjoin-agent/installation.md?ask= ``` 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.