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.
Requisitos previos
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 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.
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.
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.

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.
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:
Para revisar las características disponibles antes de configurar nada:
Configuración personalizada
New-RJTenant configura un tenant con exactamente las características seleccionadas. Úselo para tenants que aún no están configurados.
Características predeterminadas
Habilita la funcionalidad principal obligatoria del portal más las características opcionales predeterminadas (todas excepto Cliente, SecurityFeatures y AndroidApps):
Características mínimas (solo características obligatorias)
Conjunto completo de características
Permisos de solo lectura
Asigna permisos de solo lectura donde estén disponibles (por ejemplo, Group.ReadWrite.All se convierte en Group.Read.All):
Tres características no tienen variante de solo lectura y conservan sus permisos con -ReadOnly:
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:
Selección personalizada de características
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,-AddFeatureso-RemoveFeatures, las características ya configuradas en el tenant se conservan y se agregan las características predeterminadas. No se elimina nada.-Featuresreemplaza 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.-AddFeaturesy-RemoveFeaturescambia 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.
Agregar nuevas características
Eliminar características
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 conservan sus permisos de escritura.
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
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 WorkspaceSet-RJAutomationAccount— implementa la Automation Account de RealmJoin con una identidad administrada y los permisos que necesita, consulte Conexión de Azure Automation
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.
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 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 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.

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.
Solución de problemas
Si no se puede encontrar el módulo, confirme que PowerShell Gallery esté disponible y vuelva a instalarlo:
Obtener ayuda
Última actualización
¿Te fue útil?