# Implementación del agente

El agente RealmJoin puede implementarse sin problemas mediante Microsoft Intune. Hay disponible un paquete listo para usar en nuestro Package Store, lo que simplifica el proceso de configuración.\
Esta guía describe el método recomendado y compatible para instalar el agente RealmJoin mediante Intune.

## Implementación automática

### Microsoft Intune (intunewin)

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

RealmJoin se integra directamente con tu Tenant de Microsoft Intune al agregar y actualizar el agente como un paquete intunewin:

1. Abre nuestro **Tienda de paquetes**.
2. Selecciona el banner "RealmJoin Agent" o usa este enlace directo: [RealmJoin Agent (Device)](https://portal.realmjoin.com/packagestore/45935/overview)<br>

   <figure><img src="/files/052854e59e68cae15e903a93a4962b0994c09146" alt=""><figcaption></figcaption></figure>
3. Selecciona "**Use Intune (managed)**" como método de implementación y haz clic en "Continue".
4. Agrega este paquete a tu "**Enrollment Status Page**" en "Block device use until required apps are installed if they are assigned to the user/device". Esto garantiza que Intune espere la instalación de RealmJoin Agent durante el registro.
5. También activa "**Automation Main channel**".

<figure><img src="/files/84982ac85cb6b45aba741be89339ac2ec2932523" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
el agente RealmJoin **buscará versiones más recientes** durante la **implementación inicial** y **y se actualizará si es necesario**. Para acelerar este proceso, seguimos recomendando "Automate Main channel". Esto garantiza que la versión más reciente se instale desde el principio.
{% endhint %}

{% hint style="warning" %}
Por favor **no uses "Automate Preview channel"** ya que **el ID de la aplicación intunewin puede cambiar** lo que eliminará el paquete de la configuración de tu "Enrollment Status Page".
{% endhint %}

6. **Asigna** el paquete a **dispositivos** (si se asigna a objetos de usuario, es posible que el agente no se inicie durante la implementación), por ejemplo:
   1. Agregar **dispositivos individuales o grupos de dispositivos** a los grupos de aplicaciones administradas creados automáticamente
   2. Agrega "**All devices**" como **asignación adicional mediante Intune** (ten en cuenta que podrías necesitar filtros para excluir dispositivos especiales como AVD o Kiosk)

{% hint style="info" %}
Nuestra tienda también ofrece el paquete "RealmJoin Agent (User)" que se ejecuta a nivel de usuario (que era el predeterminado en el pasado). Por **razones de estabilidad**, ahora **solo recomendamos la versión a nivel de dispositivo**.
{% endhint %}

## Canal Beta y Canary

{% hint style="info" %}
El canal de lanzamiento de RealmJoin **canal** puede **ajustarse mediante la configuración de Usuario y Grupo**: [Configurar canal de lanzamiento de RealmJoin](/es/ugd-management/user-and-group-settings.md). Solo **durante la implementación inicial**, el **canal es definido y fijado por el paquete** del instalador. Al usar [Implementación automática](#automatic-deployment) con nuestro Package store, las implementaciones siempre usarán el canal de lanzamiento.
{% endhint %}

Para **probando implementaciones iniciales con otros canales**, puedes descargar y cargar manualmente uno de los siguientes paquetes intunewin:

* Canal Beta (cercano al estable, para pruebas a largo plazo):\
  [RealmJoin Beta Version](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)
* Canal Canary (experimental, primeras pruebas):\
  [RealmJoin Canary Version](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

Al cargar en Intune, utiliza la configuración sugerida y:

* Programa:
  * Comportamiento del reinicio del dispositivo: `Determinar el comportamiento según los códigos de retorno`
* Reglas de detección:
  * Configurar manualmente las reglas de detección
  * Archivo:
    * Ruta: `C:\Program Files\RealmJoin`
    * Archivo o carpeta: `RealmJoin.exe`
    * Método de detección: `Existe el archivo o la carpeta`
    * Asociado con una aplicación de 32 bits en clientes de 64 bits: `No`

## Excepciones de Windows Defender

RealmJoin ha trabajado con el equipo de Microsoft Defender para ser incluido en la lista blanca frente a la detección de malware. Dado que Defender utiliza cada vez más mecanismos de aprendizaje automático para identificar posibles amenazas y RealmJoin tiene varias funciones como instalaciones de aplicaciones descargadas desde la nube, RealmJoin podría ser reconocido por **Windows Defender** como una posible amenaza.

Aunque este comportamiento no es seguro, se recomienda implementar excepciones adicionales de **Windows Defender Antivirus**:

| Excepciones de Defender                         |
| ----------------------------------------------- |
| **Archivos y carpetas**                         |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |
| **Procesos**                                    |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |

{% hint style="info" %}
Es importante configurar la misma ruta en **Archivos y carpetas** y **Procesos**. En algunos casos, Microsoft solo comprueba una de estas excepciones de Defender.
{% endhint %}

## Información adicional

### Implementación automática

#### Legado: Microsoft Intune (MSI)

{% hint style="warning" %}
Este **método de implementación heredado** se proporciona solo como referencia y **ya no es compatible**.

Ten en cuenta también que [Microsoft no recomienda mezclar la implementación MSI y intunewin](https://learn.microsoft.com/en-us/intune/intune-service/apps/lob-apps-windows): "Si mezclas la instalación de aplicaciones Win32 y aplicaciones de línea de negocio durante el registro de Windows Autopilot, la instalación de las aplicaciones puede fallar porque ambas usan al mismo tiempo el servicio Trusted Installer."
{% endhint %}

RealmJoin puede implementarse mediante [instalador MSI](#msi-installer) como una aplicación de línea de negocio. Al cargar en Intune, asegúrate de que "Ignore app version" esté configurado en "Yes".

<figure><img src="/files/75cb3b71eed85060b054dbf6792a512e6c3af1b7" alt="" width="364"><figcaption></figcaption></figure>

### Instalación interactiva mediante línea de comandos

Si un administrador quiere instalar RealmJoin Agent en un dispositivo sin implementación masiva o sin la infraestructura de Microsoft Intune, puede descargar el MSI y realizar una instalación interactiva. Como alternativa, también puedes copiar una de las líneas de comando a continuación para descargar y ejecutar el agente en un solo paso.

#### Instalador MSI y EXE

* Versión estable:\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.msi) o [EXE](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe)
* Canal Beta (cercano al estable, para pruebas a largo plazo):\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.msi) o [EXE](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe)
* Canal Canary (experimental, primeras pruebas):\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.msi) o [EXE](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe)

#### Canal de lanzamiento

```
@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
```

### Instalación silenciosa

Al instalar RealmJoin durante la instalación desatendida del sistema operativo o cualquier otro método de implementación no interactivo, puedes decidir no tener ninguna interacción de la interfaz de usuario durante la instalación. Para instalar RealmJoin en tal escenario, usa la opción de instalación silenciosa:

```
reamjoin.exe -install
```

### MSI firmado

RealmJoin.MSI está firmado con SHA2 (256 bits) por RealmJoin y, por lo tanto, Windows lo reconoce como seguro para instalar.

![](/files/09cc29bce5c60dd23c292dfe98aba2dd4c54c3ab)


---

# 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://docs.realmjoin.com/es/agente-de-realmjoin/installation.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.
