> 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/es/agente-de-realmjoin/installation.md).

# Implementación del agente

Implementa el RealmJoin Agent en clientes Windows con el paquete intunewin listo para usar del Package Store a través de Intune.

El agente de RealmJoin puede implementarse sin problemas mediante Microsoft Intune. Un paquete listo para usar está disponible en nuestra tienda de paquetes, lo que simplifica el proceso de configuración.\
Esta guía describe el método recomendado y admitido para instalar el agente de RealmJoin mediante Intune.

## Implementación automática

### Microsoft Intune (intunewin)

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

RealmJoin se integra directamente con su Tenant de Microsoft Intune añadiendo y actualizando el agente como un paquete intunewin:

1. Abra nuestra **Tienda de paquetes**.
2. Seleccione el banner "RealmJoin Agent" o use este enlace directo: [RealmJoin Agent (Dispositivo)](https://portal.realmjoin.com/packagestore/45935/overview)<br>

   <figure><img src="https://3832142177-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. Seleccione "**Usar Intune (administrado)**" como método de implementación y haga clic en "Continuar".
4. Agregue este paquete a su "**Página de estado de inscripción**" en "Bloquear el uso del dispositivo hasta que se instalen las aplicaciones requeridas si se asignan al usuario/dispositivo". Esto garantiza que Intune espere la instalación del agente de RealmJoin durante la inscripción.
5. Active también "**Canal principal de automatización**".

<figure><img src="https://3832142177-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" %}
El agente de RealmJoin **comprobará si hay versiones más recientes** durante **la implementación inicial** y **se actualizará si es necesario**. Para acelerar este proceso, seguimos recomendando "Automatizar el canal principal". Esto garantiza que la versión más reciente se instale desde el principio.
{% endhint %}

{% hint style="warning" %}
Por favor **no use "Automate Preview channel"** ya que el **ID de la aplicación intunewin puede cambiar** lo que eliminará el paquete de la configuración de su "Página de estado de inscripción".
{% endhint %}

6. **Asigne** 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. Agregue **dispositivos individuales o grupos de dispositivos** a los grupos de aplicaciones administradas creados automáticamente
   2. Agregue "**Todos los dispositivos**" como **asignación adicional mediante Intune** (tenga en cuenta que podría necesitar filtros para excluir dispositivos especiales como AVD o Kiosk)

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

## Canal Beta y Canary

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

Para **probar las implementaciones iniciales con otros canales**, puede descargar y cargar manualmente uno de los siguientes paquetes intunewin:

* Canal Beta (casi estable, para pruebas a largo plazo):\
  [Versión Beta de RealmJoin](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)
* Canal Canary (experimental, primera prueba):\
  [Versión Canary de RealmJoin](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

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

* Programa:
  * Comportamiento de 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: `El archivo o carpeta existe`
    * Asociado con una aplicación de 32 bits en clientes de 64 bits: `Sin`

## Excepciones de Windows Defender

RealmJoin ha trabajado con el equipo de Microsoft Defender para quedar 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 **excepciones 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

#### Heredado: Microsoft Intune (MSI)

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

Tenga 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 mezcla la instalación de aplicaciones Win32 y aplicaciones de línea de negocio durante la inscripción de Windows Autopilot, la instalación de la aplicación puede fallar, ya que ambas usan el servicio Trusted Installer al mismo tiempo."
{% endhint %}

RealmJoin puede implementarse mediante [instalador MSI](#msi-installer) como una aplicación de línea de negocio. Al cargarlo en Intune, asegúrese de que "Ignorar versión de la aplicación" esté configurado en "Sí".

<figure><img src="https://3832142177-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>

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

Si un administrador desea instalar RealmJoin Agent en un dispositivo sin implementación masiva ni la infraestructura de Microsoft Intune, puede descargar el MSI y realizar una instalación interactiva. Como alternativa, también puede copiar una de las líneas de comandos siguientes 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 (casi 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, primera prueba):\
  [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 una instalación desatendida del sistema operativo o cualquier otro método de implementación no interactivo, puede decidir no tener ninguna interacción de interfaz de usuario durante la instalación. Para instalar RealmJoin en tal escenario, use la opción de instalación silenciosa:

```
reamjoin.exe -install
```

### MSI firmado

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

![](https://3832142177-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/es/agente-de-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.
