> 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/despliegue/onboarding-realmjoin-portal/advanced-setup.md).

# Configuración avanzada

La configuración avanzada te permite asignar permisos de una manera más granular y personalizada. Este enfoque es más flexible pero más complejo y requiere ejecutar el módulo de PowerShell de RealmJoin.

El módulo de PowerShell de RealmJoin automatiza la configuración de su tenant de RealmJoin. Lo hace:

* Crea los Service Principals de Microsoft Entra ID requeridos para las aplicaciones de RealmJoin
* Asigna los permisos adecuados de Microsoft Graph en función de las características que seleccione
* Configura las características de RealmJoin (Portal, Intune LAPS, Autopilot, acciones de dispositivo, scripts de remediación, características de seguridad)
* Limpia las aplicaciones heredadas de configuraciones anteriores

El módulo se publica en el [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin).

## Requisitos previos

{% hint style="info" %}
Los módulos de Azure PowerShell requeridos (`Az.Accounts`, `Az.Resources`, `Az.Automation`) se instalan automáticamente, en las versiones fijadas por el módulo, para el usuario actual, la primera vez que ejecute un comando.
{% endhint %}

* **PowerShell 5.1** o posterior (Windows PowerShell o PowerShell 7)
* Una cuenta que pueda **crear Service Principals y conceder permisos de aplicación** en Microsoft Entra ID — por ejemplo *Global Administrator* o *Privileged Role Administrator*
* El inicio de sesión se realiza a través de `Connect-AzAccount`, que usa la aplicación de primera parte **Azure PowerShell** aplicación de primera parte. Los tenants que restringen el consentimiento del usuario pueden necesitar que un administrador conceda primero el consentimiento de administrador a esa aplicación.
* Acceso a la [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) para instalar el módulo

Solo se necesita una suscripción de Azure para los recursos de Azure (`Set-RJLogAnalyticsWorkspace`, `Set-RJAutomationAccount`). `New-RJTenant` y `Update-RJTenant` trabaje en un tenant sin ninguna suscripción; inicie sesión en él con `Connect-AzAccount -Tenant <tenant-id>` primero.

## Configuración recomendada

El comando de configuración mostrado por el RealmJoin Portal ejecuta `Complete-RJTenantOnboarding` (alias de `Update-RJTenant`) sin seleccionar características. Asigna los permisos de la característica obligatoria y de todas las características predeterminadas:

* Funcionalidad principal del portal (`RealmJoinPortal`, obligatoria)
* Intune LAPS (`IntuneLAPS`)
* Datos de inicio de sesión (`ShowSignin`)
* Autopilot (`Autopilot`)
* Acciones de dispositivo de Intune (`DeviceIntuneActions`)
* Scripts de remediación (`DeviceHealthScript`)
* Claves de recuperación de BitLocker (`BitLockerRecoveryKeys`)
* Inscripción de actualización de dispositivos Windows (`WindowsDeviceUpdateEnrollment`)

Las características que ya están configuradas en el tenant, por ejemplo `SecurityFeatures` o `Cliente`, se conservan. Para agregar todas las características o características individuales, consulte [Otros comandos](#other-commands).

{% stepper %}
{% step %}

#### Abra PowerShell en Windows/Mac

Recomendamos instalar y ejecutar el módulo de PowerShell de RealmJoin en una **recién abierta** sesión de PowerShell en su propio dispositivo en lugar de en Azure Cloud Shell. El módulo requiere una línea de versión menor fija de cada `módulos Az.*` módulo (`Az.Accounts` 5.5.x, `Az.Resources` 10.2.x, `Az.Automation` 1.12.x); si ya hay cargada otra versión en la sesión — lo que suele ocurrir en Cloud Shell — se detiene con un conflicto de versiones que no puede resolverse sin abrir una nueva sesión.

No se requiere una sesión elevada ("Ejecutar como administrador"): los módulos se instalan con `-Scope CurrentUser`.
{% endstep %}

{% step %}

#### Copie y ejecute el script de incorporación de RealmJoin

El script le pedirá que inicie sesión en Azure. Use una cuenta que pueda crear Service Principals y conceder permisos de aplicación, por ejemplo su Global Administrator.

El token del comando vincula la ejecución a su tenant en el RealmJoin Portal. Es válido durante una hora; si ha expirado, abra de nuevo la página de configuración avanzada en el portal para obtener un comando con un nuevo token.

```powershell
Install-Module -Force -Name RealmJoin
Complete-RJTenantOnboarding -Token 1234ABCD 6>&1
```

{% hint style="info" %}
**Acerca de `6>&1`:** Estos comandos escriben sus actualizaciones de progreso en el flujo de información de PowerShell. La `6>&1` redirección muestra esa salida en la consola — sin ella no verá los mensajes detallados de progreso durante la ejecución.
{% endhint %}

<figure><img src="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FdxYM2mTZ5LNcJhgudknf%2FSnipaste_2026-01-27_12-00-54.png?alt=media&amp;token=1fa4cd4e-485a-43e4-8a90-f6e6f6f57cb5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Empiece a usar RealmJoin

Después de asignarse los permisos, el comando envía el token a la API de RealmJoin. La página de configuración avanzada del portal comprueba periódicamente si el token ha sido usado y luego le redirige al portal. Mantenga la página abierta mientras se ejecuta el comando.

Si el Service Principal del RealmJoin Portal no existía en el tenant antes, el comando también abre el RealmJoin Portal en su navegador.

{% hint style="info" %}
**Cerrar sesión después:** el inicio de sesión de Azure sigue activo después de que el comando haya terminado. Cuando hayas terminado, ejecuta `Disconnect-AzAccount` para cerrar la sesión activa.
{% endhint %}
{% endstep %}
{% endstepper %}

## Otros comandos

### Configuración interactiva

Para una experiencia guiada y basada en menús que cubre la configuración del tenant, los cambios de configuración, el Log Analytics Workspace y la Automation Account:

```powershell
Show-RJInteractiveSetup
```

Para revisar las características disponibles antes de configurar nada:

```powershell
Show-RJFeatureInfo
```

### Configuración personalizada

`New-RJTenant` configura un tenant con exactamente las características seleccionadas. Úselo para tenants que aún no están configurados.

{% hint style="warning" %}
En un tenant que ya está configurado, `New-RJTenant` elimina los permisos de cada característica configurada que no forme parte de la selección y borra los Service Principals que quedan sin permisos. Por ejemplo, `New-RJTenant` sin parámetros elimina `SecurityFeatures` y `Cliente`. Para cambiar una configuración existente, use [`Update-RJTenant`](#updating-existing-configuration).
{% endhint %}

#### Características predeterminadas

Habilita la funcionalidad principal obligatoria del portal más las características opcionales predeterminadas (todas excepto `Cliente`, `SecurityFeatures` y `AndroidApps`):

```powershell
New-RJTenant 6>&1
```

#### Características mínimas (solo características obligatorias)

```powershell
New-RJTenant -Features @('RealmJoinPortal') 6>&1
```

#### Conjunto completo de características

```powershell
New-RJTenant -All 6>&1
```

#### Permisos de solo lectura

Asigna permisos de solo lectura donde estén disponibles (por ejemplo, `Group.ReadWrite.All` se convierte en `Group.Read.All`):

```powershell
New-RJTenant -ReadOnly 6>&1
```

Tres características no tienen variante de solo lectura y conservan sus permisos con `-ReadOnly`:

| Característica                  | Permiso                                                   |
| ------------------------------- | --------------------------------------------------------- |
| `DeviceIntuneActions`           | `DeviceManagementManagedDevices.PrivilegedOperations.All` |
| `WindowsDeviceUpdateEnrollment` | `WindowsUpdates.ReadWrite.All`                            |
| `AndroidApps`                   | `DeviceManagementConfiguration.ReadWrite.All`             |

Para una configuración sin permisos de escritura, deje fuera estas características:

```powershell
New-RJTenant -Features @('IntuneLAPS', 'ShowSignin', 'Autopilot', 'DeviceHealthScript', 'BitLockerRecoveryKeys') -ReadOnly 6>&1
```

#### Selección personalizada de características

```powershell
New-RJTenant -Features @('RealmJoinPortal', 'IntuneLAPS', 'Autopilot') 6>&1
```

### Actualización de la configuración existente

`Update-RJTenant` ajusta un tenant ya configurado. El alias `Complete-RJTenantOnboarding` puede usarse indistintamente con `Update-RJTenant`.

* Sin `-Features`, `-All`, `-AddFeatures` o `-RemoveFeatures`, las características ya configuradas en el tenant se conservan y se agregan las características predeterminadas. No se elimina nada.
* `-Features` reemplaza la configuración: las características configuradas que no están en la lista se eliminan, incluido su Service Principal. Se rechaza una lista vacía.
* `-AddFeatures` y `-RemoveFeatures` cambia solo las características indicadas.
* Cada ejecución también elimina del tenant las aplicaciones heredadas de RealmJoin, consulte [Cambio desde la configuración rápida](#switching-from-quick-setup).

#### Agregar nuevas características

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') 6>&1
```

#### Eliminar características

```powershell
Update-RJTenant -RemoveFeatures @('ShowSignin') 6>&1
```

#### Cambiar a permisos de solo lectura

Cambia las características configuradas y las características predeterminadas a sus permisos de solo lectura. Las características enumeradas en [Permisos de solo lectura](#read-only-permissions) conservan sus permisos de escritura.

```powershell
Update-RJTenant -ReadOnly 6>&1
```

Combinado con `-AddFeatures`, `-ReadOnly` se aplica solo a las características agregadas; los permisos de las características ya configuradas permanecen sin cambios.

#### Vista previa de los cambios

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') -WhatIf 6>&1
```

### Recursos de Azure

El módulo también implementa los recursos complementarios de Azure que usa RealmJoin. No son características de permisos de Graph y no se seleccionan con `-Features`:

* `Set-RJLogAnalyticsWorkspace` — implementa el Log Analytics Workspace con sus tablas personalizadas y reglas de recopilación de datos, consulte [Conexión de Azure Log Analytics Workspace](https://docs.realmjoin.com/es/supervision-y-registros/log-analytics.md)
* `Set-RJAutomationAccount` — implementa la Automation Account de RealmJoin con una identidad administrada y los permisos que necesita, consulte [Conexión de Azure Automation](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation.md)

Ambos comandos se generan con los parámetros correspondientes y un token de incorporación en la página de configuración pertinente del RealmJoin Portal.

## Características disponibles

Use estos nombres de características con los `-Features`, `-AddFeatures`, y `-RemoveFeatures` parámetros. Las características obligatorias siempre están habilitadas. La configuración predeterminada (`New-RJTenant` sin parámetros) habilita las características marcadas abajo; **SecurityFeatures**, **Cliente** y **AndroidApps** deben seleccionarse explícitamente.

| Característica                  | Descripción                                                                                                                                                                                                                            | Predeterminado |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------: |
| `RealmJoinPortal`               | Funcionalidad principal del portal para autoservicio del usuario e interacción de administración (obligatoria)                                                                                                                         |       ☑️       |
| `IntuneLAPS`                    | Recuperar y administrar contraseñas de administrador local mediante Intune LAPS                                                                                                                                                        |       ☑️       |
| `ShowSignin`                    | Mostrar el historial de inicio de sesión del usuario y los registros de auditoría                                                                                                                                                      |       ☑️       |
| `Autopilot`                     | Ver los perfiles de implementación y el estado de Windows Autopilot                                                                                                                                                                    |       ☑️       |
| `DeviceIntuneActions`           | Ejecutar acciones privilegiadas del dispositivo (sincronizar, reiniciar, borrar, etc.)                                                                                                                                                 |       ☑️       |
| `DeviceHealthScript`            | Administrar e implementar scripts de remediación de PowerShell en los dispositivos                                                                                                                                                     |       ☑️       |
| `BitLockerRecoveryKeys`         | Ver las claves de recuperación de BitLocker de los dispositivos administrados                                                                                                                                                          |       ☑️       |
| `WindowsDeviceUpdateEnrollment` | Administrar la inscripción de Windows Device Updates                                                                                                                                                                                   |       ☑️       |
| `SecurityFeatures`              | [Integración con Defender for Endpoint](https://docs.realmjoin.com/es/ugd-management/defender-integration.md) en las páginas del dispositivo (requiere licencias MDE)                                                                  |                |
| `Cliente`                       | RealmJoin Agent — aplicación cliente para la administración de dispositivos                                                                                                                                                            |                |
| `AndroidApps`                   | [Implementación de aplicaciones de Android](https://docs.realmjoin.com/es/administracion-de-aplicaciones/packages/android-apps-managed-google-play.md) a través de Managed Google Play (`DeviceManagementConfiguration.ReadWrite.All`) |                |

## Cambio desde la configuración rápida

Un tenant incorporado con la configuración rápida usa la **RealmJoin Portal - Funcionalidades principales** registro de aplicación, que contiene todos los permisos del portal. Para moverlo a Configuración avanzada, vaya a **Organización → Características** en el RealmJoin Portal y seleccione **Ir al modo avanzado** en la **configuración avanzada** tarjeta. Entonces el portal muestra el comando de incorporación con un token, como se describe en [Configuración recomendada](#recommended-setup).

<figure><img src="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-90feb65a312dda59e5e23473be499c34566c8b1c%2Forganization-features-advanced-setup-switch.png?alt=media" alt="Advanced setup card on the Organization Features page"><figcaption><p>tarjeta de configuración avanzada para tenants en Configuración rápida</p></figcaption></figure>

Cuando se ejecuta el comando, el módulo crea los Service Principals para las características seleccionadas y elimina el **RealmJoin Portal - Funcionalidades principales** registro de aplicación como una aplicación heredada. Una vez que los nuevos permisos están en su lugar, el portal cambia el tenant a Configuración avanzada.

{% hint style="warning" %}
El cambio es irreversible. Después de que se haya eliminado el registro de aplicación de Core Features, los permisos se administran solo con el módulo de PowerShell de RealmJoin.
{% endhint %}

## Solución de problemas

{% hint style="warning" %}
**"Privilegios insuficientes"** — crear Service Principals y conceder permisos de aplicación requiere una cuenta con privilegios adecuados, por ejemplo *Global Administrator* o *Privileged Role Administrator*. Consulta [Requisitos previos](#prerequisites).
{% endhint %}

{% hint style="warning" %}
**"Necesita aprobación del administrador" o un error de consentimiento durante el inicio de sesión** — el inicio de sesión usa el **Azure PowerShell** aplicación de primera parte. Si tu tenant restringe el consentimiento del usuario, un administrador tendrá que conceder una vez el consentimiento de administrador a esa aplicación.
{% endhint %}

{% hint style="warning" %}
**"El módulo RealmJoin está desactualizado - la ejecución no puede continuar"** — cada comando verifica una vez por sesión que está ejecutando la versión publicada más reciente. Instale la versión actual, luego cierre la sesión y abra una nueva:

```powershell
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

{% endhint %}

{% hint style="warning" %}
**"La autenticación falló (401). El token puede no ser válido o haber expirado."** — se han asignado los permisos, pero no se pudo registrar el tenant con RealmJoin porque el token de incorporación ha caducado (después de una hora) o no es válido. Abra de nuevo la página de Configuración avanzada en el RealmJoin Portal y ejecute el comando con el nuevo token. Ejecutarlo de nuevo no cambia los permisos que ya están establecidos.
{% endhint %}

{% hint style="warning" %}
**Se informa de un conflicto de versiones de un módulo** — un `módulos Az.*` módulo en una versión distinta de la que fija el módulo ya está cargado. Esto no puede corregirse en la sesión en ejecución: cierre PowerShell, abra una nueva sesión y ejecute el comando de nuevo.
{% endhint %}

Si no se puede encontrar el módulo, confirme que PowerShell Gallery esté disponible y vuelva a instalarlo:

```powershell
Get-PSRepository
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

### Obtener ayuda

```powershell
Get-Help New-RJTenant -Full
Get-Help Update-RJTenant -Examples
Get-Help Show-RJInteractiveSetup -Detailed
```


---

# 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/despliegue/onboarding-realmjoin-portal/advanced-setup.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.
