For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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.

  • 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.

1

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.

2

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.

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.

3

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.

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.

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:

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:

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, -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.

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 Workspace

  • Set-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.

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

Advanced setup card on the Organization Features page
tarjeta de configuración avanzada para tenants en Configuración rápida

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?