> 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 PowerShell de RealmJoin automatiza la configuración de su Tenant de RealmJoin. Hace lo siguiente: * Crea los Service Principals de Microsoft Entra ID requeridos para las aplicaciones de RealmJoin * Asigna los permisos apropiados de Microsoft Graph en función de las características que seleccione * Configura las características de RealmJoin (Portal, Intune LAPS, Autopilot, acciones del dispositivo, scripts de correcció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 requeridos de Azure PowerShell (`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 puede **crear Service Principals y conceder permisos de aplicación** en Microsoft Entra ID, por ejemplo *Administrador global* o *Privileged Role Administrator* * El inicio de sesión se realiza a través de `Connect-AzAccount`, que usa la **Azure PowerShell** aplicación de primera parte. Los Tenant 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 {% hint style="info" %} A partir de la versión 2.0, el módulo inicia sesión con la **Azure PowerShell** aplicación y los `Az` módulos. Las versiones anteriores usaban la aplicación Microsoft Graph PowerShell en su lugar; si su Tenant solo había concedido consentimiento a esa, es necesario conceder una vez consentimiento a la aplicación de Azure PowerShell. {% endhint %} ## Configuración recomendada El comando de configuración que muestra el Portal de RealmJoin proporcionará permisos para: * Características principales * Intune LAPS * Datos de inicio de sesión * Scripts de corrección * Autopilot * Acciones de dispositivo de Intune 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 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 versiones exactas de los `Az.*` módulos; si ya hay cargada en la sesión una versión diferente —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 %} #### Copiar y ejecutar 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 Administrador global. ```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 %}
{% endstep %} {% step %} #### Comience a usar RealmJoin Una vez finalizado, el script iniciará el Portal de RealmJoin
{% hint style="info" %} **Cerrar sesión después:** el inicio de sesión de Azure permanece activo después de que el comando haya terminado. Cuando haya terminado, ejecute `Disconnect-AzAccount` para cerrar sesión de la sesión existente. {% 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 #### Características predeterminadas Habilita la funcionalidad principal obligatoria del portal más las características opcionales predeterminadas (todo excepto el RealmJoin Client): ```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 ``` #### 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` se puede usar indistintamente con `Update-RJTenant`. #### 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 ```powershell Update-RJTenant -ReadOnly 6>&1 ``` #### Vista previa de los cambios ```powershell Update-RJTenant -AddFeatures @('SecurityFeatures') -WhatIf 6>&1 ``` ### Recursos de Azure El módulo también implementa los recursos de Azure complementarios 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 del Log Analytics Workspace de Azure](/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](/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 Portal de RealmJoin. ## 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 a continuación; **SecurityFeatures** y **Client** deben seleccionarse explícitamente. | Funcionalidad | Descripción | Predeterminado | | ------------------------------- | -------------------------------------------------------------------------------------------------------------- | :------------: | | `RealmJoinPortal` | Funcionalidad principal del portal para autoservicio del usuario e interacción del administrador (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 perfiles y estado de implementación de Windows Autopilot | ☑️ | | `DeviceIntuneActions` | Ejecutar acciones privilegiadas del dispositivo (sincronizar, reiniciar, borrar, etc.) | ☑️ | | `DeviceHealthScript` | Administrar e implementar scripts de corrección de PowerShell en los dispositivos | ☑️ | | `BitLockerRecoveryKeys` | Ver las claves de recuperación de BitLocker para los dispositivos administrados | ☑️ | | `WindowsDeviceUpdateEnrollment` | Administrar el registro en Windows Device Updates | ☑️ | | `SecurityFeatures` | Protección avanzada contra amenazas y análisis de seguridad (requiere licencias de MDE) | | | `Client` | RealmJoin Agent — aplicación cliente para la administración de dispositivos | | ## 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 *Administrador global* o *Privileged Role Administrator*. Consulte [Requisitos previos](#prerequisites). {% endhint %} {% hint style="warning" %} **"Se necesita aprobación de administrador" o un error de consentimiento durante el inicio de sesión** — el inicio de sesión usa la **Azure PowerShell** aplicación propia de Microsoft. Si su tenant restringe el consentimiento de usuario, un administrador tiene que conceder una vez el consentimiento de administrador a esa aplicación. {% endhint %} {% hint style="warning" %} **"El módulo de RealmJoin está desactualizado - no se puede continuar con la ejecución"** — cada comando verifica una vez por sesión que está ejecutando la última versión publicada. 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" %} **Se informa de un conflicto de versiones del módulo** — un `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=&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.