Agregar los usuarios principales de los dispositivos al grupo programado

Mantener un grupo sincronizado con los usuarios principales de los dispositivos de Intune

Este es un runbook programado. Está diseñado para ejecutarse de forma recurrente en lugar de activarse para un único objeto. Consulte Programación para obtener detalles sobre cómo configurar las programaciones de runbook.

Descripción

Recopila los usuarios principales de todos los dispositivos de Intune de las plataformas elegidas y mantiene sincronizado un grupo de Entra ID con ellos. Los usuarios sin un dispositivo coincidente se eliminan, salvo que la eliminación esté desactivada. Un grupo de inclusión limita qué usuarios son elegibles y un grupo de exclusión bloquea usuarios. Un modo solo informe muestra por correo electrónico una vista previa de los cambios sin aplicar nada.

Casos de uso comunes

Mantener alineado un grupo de destino de distribución o de Conditional Access con "quién tiene actualmente un dispositivo administrado", filtrado por plataforma, por un filtro OData avanzado o por un ámbito de grupo de inclusión/exclusión.
Validar un filtro o ámbito nuevo o modificado antes de que se permita escribir en un grupo de producción.

Se recomienda una programación diaria.

Modo solo informe para pilotos y pruebas

Habilitar Solo informe para calcular la misma diferencia de altas/bajas que produciría una ejecución real, sin aplicar ningún cambio al grupo. En su lugar, se envía a EmailTo: cada lista (se añadirían, se eliminarían) muestra como máximo 10 usuarios en el cuerpo del correo, con un indicador de "... y N más" cuando una lista es más larga, y las listas completas se adjuntan como archivo(s) de informe en el formato elegido por ReportFileFormat. Ejecútelo una vez en este modo después de cambiar la selección de plataforma, Filtro avanzado o los grupos de inclusión/exclusión, revise la vista previa y luego desactive Solo informe para permitir que se aplique la sincronización.

Interacciones de parámetros

Filtro avanzado, cuando se establece, reemplaza por completo la selección de plataforma Windows/macOS/iOS/Android en lugar de combinarse con ella.
Eliminar usuarios cuando no haya coincidencia de dispositivo controla tanto la ejecución real como la Solo informe vista previa: cuando está desactivado, no se elimina ningún usuario en ninguno de los casos, por lo que la vista previa siempre refleja lo que haría una ejecución real.

Configuración relacionada con el envío de correo electrónico

Enviar un informe por correo electrónico es opcional y solo ocurre cuando la Solo informe opción está habilitada; entonces se requiere un destinatario (EmailTo) es entonces obligatorio. La dirección del remitente se toma de la RJReport.EmailSender configuración del tenant.

Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos mediante la API de Graph, debes configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulta la documentación de configuración de informes de RealmJoin para obtener detalles sobre todas las configuraciones disponibles.

Branding del correo electrónico

El correo electrónico del informe respeta las opciones opcionales RJReport.Branding.* de configuración del tenant:

Imagen de encabezado y pie de página – URL públicas HTTPS, PNG/JPEG/GIF, máx. 200 KB cada una
Enlace del pie de página – destino de la imagen del pie de página
Color de acento y texto – valores hexadecimales de 6 dígitos, p. ej. #0052cc

Cuando estas configuraciones no están definidas, se usan las imágenes y colores predeterminados de RealmJoin. Una imagen que no se pueda descargar o validar, o un valor de color no válido, nunca impide el correo electrónico del informe: se utiliza en su lugar el valor predeterminado correspondiente.

Instrucciones de configuración y requisitos de imagen: Branding del correo electrónico.

Ubicación

Organization → General → Add Primary Users Of Devices To Group (Scheduled)

Nombre completo del runbook

rjgit-org_general_add-primary-users-of-devices-to-group_scheduled

Detalles

Propiedad

Valor

Versión

1.2.0

Módulos requeridos

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)

Programable

sí

Permisos

Permisos de aplicación

Tipo: Microsoft Graph
- DeviceManagementManagedDevices.Read.All
  - Lee los dispositivos administrados de Intune filtrados por sistema operativo para recopilar el usuario principal de cada dispositivo
- Group.Read.All
  - Valida los grupos de destino/inclusión/exclusión y lee sus listas de miembros
- GroupMember.ReadWrite.All
  - Agrega y elimina usuarios en el grupo de destino mediante llamadas por lotes a /groups/{id}/members/$ref
- User.Read.All
  - Lee el id de miembro y el UPN para identificar a los usuarios miembros y registrar las eliminaciones

Filtro avanzado

Filtro OData para los dispositivos en lugar de los conmutadores de plataforma, por ejemplo startsWith(deviceName,'FWP-') and operatingSystem eq 'Windows'.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Filtro personalizado

Muestra una vista previa de los cambios sin aplicarlos. La vista previa se envía por correo electrónico, con los primeros 10 usuarios por lista en el cuerpo y las listas completas adjuntas.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Falso

Tipo

Booleano

Nombre para mostrar en el portal

¿Solo informe?

EmailFrom

Dirección del remitente del correo electrónico del informe. Tomada de la configuración del tenant RJReport.EmailSender.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingHeaderImageUrl

Imagen de encabezado del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Tomada de la configuración del tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacía.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingFooterImageUrl

Imagen de pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Tomada de la configuración del tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacía.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingFooterLink

Enlace detrás de la imagen de pie de página del correo electrónico del informe. Tomada de la configuración del tenant RJReport.Branding.FooterLink; se usa realmjoin.com cuando está vacío.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingAccentColor

Color de acento del correo electrónico del informe como valor hexagonal de 6 dígitos. Tomada de la configuración del tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o no es válido.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

BrandingTextColor

Color del texto del correo electrónico del informe como valor hexagonal de 6 dígitos. Tomada de la configuración del tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o no es válido.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

EmailTo

Dirección a la que se envía la vista previa. Solo se usa en modo solo informe.

Propiedad

Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Enviar el informe de vista previa a

ReportFileFormat

Adjunte las listas completas como CSV, como un libro de Excel o ambos. Solo se usa en modo solo informe.

Propiedad

Valor

Requerido

falso

Valor predeterminado

CSV y XLSX

Tipo

Cadena

Nombre para mostrar en el portal

Formato del archivo del informe de vista previa

Opciones del portal

Opción del portal

Valor

CSV y XLSX

Solo CSV

Solo XLSX

Volver a la vista general de la referencia del runbook

Última actualización hace 7 días

¿Te fue útil?