Informe de desajuste de usuario principal programado

Comparar las asignaciones de usuario principal en Intune con RealmJoin para dispositivos administrados Windows

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

Descripción

Para dispositivos administrados de Windows, este informe programado compara el usuario principal registrado en Intune con el usuario principal registrado en la API de cliente de RealmJoin. Correlaciona ambos conjuntos de datos por dispositivo, marca cualquier dispositivo en el que el usuario principal difiera y envía por correo las diferencias con archivos adjuntos CSV y/o Excel (xlsx). Los archivos del informe también pueden cargarse en un Azure Storage Account, devolviendo enlaces de descarga con tiempo limitado. El parámetro ReportFileFormat controla qué formatos de archivo se generan y entregan (solo CSV, CSV y XLSX, o solo XLSX). Cuando el archivo adjunto CSV supera el límite de tamaño del correo y se selecciona "CSV & XLSX", el correo recurre solo al libro de Excel.

Configuración relativa al envío de correos electrónicos

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

Este proceso se describe en detalle en la documentación de la configuración de informes de RealmJoin.

Marca de los correos electrónicos

El correo electrónico del informe respeta las RJReport.Branding.* configuraciones opcionales del inquilino:

Imagen de encabezado y pie de página – URL HTTPS públicas, 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 de texto – valores hexadecimales de 6 dígitos, por ejemplo #0052cc

Cuando estas configuraciones no están definidas, se utilizan los gráficos 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; en su lugar, se usa el valor predeterminado correspondiente.

Instrucciones de configuración y requisitos de imagen: Marca de los correos electrónicos.

Configuración sobre credenciales de la API de RealmJoin

Este runbook consulta la API de cliente de RealmJoin y requiere una credencial dedicada almacenada en la cuenta de Automatización de Azure.

Configuración paso a paso:

Obtenga las credenciales de la API — Si aún no tiene credenciales de la API de RealmJoin, solicítelas en support@realmjoin.com
Abra la Automation Account — En el Azure Portal, navegue hasta la cuenta de Automatización utilizada para los runbooks
Vaya a Recursos compartidos > Credenciales — En el menú izquierdo, debajo de Recursos compartidos, haga clic en Credenciales
Agregue una nueva credencial — Haga clic en Agregar una credencial
Póngale exactamente el nombre RJAPI — El runbook busca este nombre; cualquier desviación hará que la búsqueda de la credencial falle
Introduzca el nombre de usuario y la contraseña de la API de RealmJoin — Use las credenciales del paso 1
Guardar — Haga clic en Crear y vuelva a ejecutar el runbook

Ubicación

Organización → Dispositivos → Informe de discrepancia del usuario principal (Programado)

Nombre completo del runbook

rjgit-org_devices_report-primary-user-mismatch_scheduled

Detalles

Propiedad

Valor

Versión

1.7.0

Módulos requeridos

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

Programable

sí

Notas

Requisitos previos:

Debe crearse manualmente antes de programarlo una credencial compartida de la cuenta de Automatización de Azure llamada exactamente "RJAPI". Establezca el nombre de usuario y la contraseña para que coincidan con una cuenta de la API de cliente de RealmJoin (consulte https://docs.realmjoin.com/dev-reference/realmjoin-api/authentication).
La identidad administrada de la cuenta de Automatización de Azure debe tener asignados los siguientes permisos de aplicación de Graph: DeviceManagementManagedDevices.Read.All, Mail.Send, Organization.Read.All.
La configuración RJReport.EmailSender debe configurarse con una dirección de remitente válida antes de la primera ejecución.
No se envía ningún correo cuando ambos conjuntos de datos están sincronizados; una ejecución vacía no es un error.

Permisos

Permisos de aplicación

Tipo: Microsoft Graph
- DeviceManagementManagedDevices.Read.All
  - Lee los dispositivos administrados de Intune para obtener el usuario principal de cada dispositivo Windows para compararlo
- Directory.Read.All
  - Lee los miembros del grupo para resolver los filtros opcionales de ámbito de incluir/excluir grupos de dispositivos
- Mail.Send (opcional — función: informe por correo electrónico)
  - Entrega el informe de discrepancias mediante Send-RjReportEmail al destinatario EmailTo configurado
- Organization.Read.All
  - Lee /organization para obtener el nombre del Tenant que se muestra en el informe

Parámetros

SyncThresholdDays

Número de días hacia atrás para el filtro de última sincronización de Intune. Solo se evalúan los dispositivos Windows que se han sincronizado dentro de este número de días.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Int32

Incluya en el informe solo los dispositivos que sean miembros de este grupo de dispositivos de Entra. Requiere que el filtrado por ámbito de dispositivos esté habilitado.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Dispositivos a incluir (grupo)

Oculto en el portal

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

ExcludeDeviceGroup

Excluya del informe los dispositivos que sean miembros de este grupo de dispositivos de Entra. Requiere que el filtrado por ámbito de dispositivos esté habilitado.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Dispositivos a excluir (grupo)

Oculto en el portal

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

EmailTo

Si se especifica, se enviará un correo con el informe a la(s) dirección(es) proporcionada(s). Puede ser una sola dirección o varias direcciones separadas por comas.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Enviar informe a

EmailFrom

La dirección de correo del remitente. Esto se configura mediante la opción de personalización del runbook y está oculta en el portal.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

BrandingHeaderImageUrl

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

BrandingFooterImageUrl

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

BrandingFooterLink

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

BrandingAccentColor

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

BrandingTextColor

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

ReportFileFormat

Controla qué formatos de archivo de informe se generan y entregan: "solo CSV", "CSV y XLSX" (predeterminado) o "solo XLSX".

Propiedad

Valor

Requerido

false

Valor predeterminado

CSV y XLSX

Tipo

Cadena

Nombre para mostrar en el portal

Formato del archivo del informe

Opciones del portal

Opción del portal

Valor

CSV y XLSX

Solo CSV

Solo XLSX

CreateDownloadLink

Si está habilitado, los archivos del informe se cargan en un Azure Storage Account y se devuelven enlaces de descarga con tiempo limitado. Deshabilitado de forma predeterminada.

Propiedad

Valor

Requerido

false

Valor predeterminado

Falso

Tipo

Booleano

Nombre para mostrar en el portal

¿Crear un enlace de descarga de archivo (cargar el informe al almacenamiento)?

Opciones del portal

Opción del portal

Valor

Sí: cargar el informe y devolver un enlace de descarga

true

No: no crear un enlace de descarga

false

ContainerName

Nombre del contenedor de almacenamiento usado para la carga. Configurado por runbook (no es una configuración global de RJReport).

Propiedad

Valor

Requerido

false

Valor predeterminado

report-primary-user-mismatch

Tipo

Cadena

Oculto en el portal

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

ResourceGroupName

Grupo de recursos que contiene la cuenta de almacenamiento. Procede de la configuración del Tenant de RJReport.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

StorageAccountName

Nombre de la cuenta de almacenamiento usada para la carga. Procede de la configuración del Tenant de RJReport.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Cadena

Oculto en el portal

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

LinkExpiryDays

Número de días hasta que caduque el enlace de descarga generado. Procede de la configuración del Tenant de RJReport.

Propiedad

Valor

Requerido

false

Valor predeterminado

Tipo

Int32

Oculto en el portal

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

Volver al resumen de la referencia del runbook

Última actualización hace 7 días

¿Te fue útil?