Informe de dispositivos sin usuario principal programado
Informa sobre todos los dispositivos administrados en Intune que no tienen asignado un usuario principal.
Descripción
Este script recupera todos los dispositivos administrados de Intune y filtra aquellos que no tienen un usuario principal (userId). La salida es una tabla con formato que muestra el ID de objeto, el ID de dispositivo, el nombre para mostrar, el sistema operativo y la fecha y hora de la última sincronización de cada dispositivo sin un usuario principal. El informe puede limitarse a plataformas específicas (Windows, macOS, iOS/iPadOS, Android, Other) mediante parámetros booleanos. De forma predeterminada, se incluyen todas las plataformas.
Opcionalmente, el informe puede enviarse por correo electrónico con archivos adjuntos CSV y/o Excel (xlsx) que contienen información detallada del dispositivo. Los archivos del informe también pueden cargarse en una Azure Storage Account, devolviendo enlaces de descarga con tiempo limitado. El parámetro ReportFileFormat controla qué formatos de archivo se generan y se entregan (solo CSV, CSV y XLSX, o solo XLSX). Cuando el archivo adjunto CSV supera el límite de tamaño del correo electrónico y se selecciona "CSV & XLSX", el correo electrónico recurre solo al libro de Excel.
Configuración relativa al envío de correos electrónicos
Enviar un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (EmailTo) . 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 mediante Graph API, necesitas 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.
Marca del correo electrónico
El correo electrónico del informe respeta las configuraciones opcionales RJReport.Branding.* del tenant:
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 usan 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 del correo electrónico.
Ubicación
Organización → Dispositivos → Informe de dispositivos sin usuario principal (Programado)
Nombre completo del runbook
rjgit-org_devices_report-devices-without-primary-user_scheduled
Detalles
Versión
1.9.0
Módulos requeridos
RealmJoin.RunbookHelper (>= 0.8.9)\nMicrosoft.Graph.Authentication (>= 2.39.0)\nAz.Accounts (>= 5.5.2)
Programable
sí
Permisos
Permisos de aplicación
Tipo: Microsoft Graph
DeviceManagementManagedDevices.Read.All
Lee los dispositivos administrados de Intune para encontrar dispositivos sin un usuario principal
Mail.Send (opcional — característica: informe por correo electrónico)
Envía el correo del informe mediante Send-RjReportEmail cuando EmailTo está configurado
Parámetros
IncludeWindows
Incluye dispositivos Windows en el informe. Habilitado de forma predeterminada.
Obligatorio
false
Valor predeterminado
True
Tipo
Booleano
Nombre mostrado en el portal
Incluir dispositivos Windows
IncludeMacOS
Incluye dispositivos macOS en el informe. Habilitado de forma predeterminada.
Obligatorio
false
Valor predeterminado
True
Tipo
Booleano
Nombre mostrado en el portal
Incluir dispositivos macOS
IncludeIOS
Incluye dispositivos iOS e iPadOS en el informe. Habilitado de forma predeterminada.
Obligatorio
false
Valor predeterminado
True
Tipo
Booleano
Nombre mostrado en el portal
Incluir dispositivos iOS/iPadOS
IncludeAndroid
Incluye dispositivos Android en el informe. Habilitado de forma predeterminada.
Obligatorio
false
Valor predeterminado
True
Tipo
Booleano
Nombre mostrado en el portal
Incluir dispositivos Android
IncludeOther
Incluye en el informe dispositivos con cualquier otro sistema operativo (por ejemplo, Linux, ChromeOS). Habilitado de forma predeterminada.
Obligatorio
false
Valor predeterminado
True
Tipo
Booleano
Nombre mostrado en el portal
devices-without-primary-user
ReportFileFormat
Controla qué formatos de archivo del informe se generan y entregan: "solo CSV", "CSV & XLSX" (predeterminado) o "solo XLSX".
Obligatorio
false
Valor predeterminado
CSV & XLSX
Tipo
String
Nombre mostrado en el portal
Formato de archivo del informe
Opciones del portal
CSV & XLSX
solo CSV
solo XLSX
CreateDownloadLink
Si está habilitado, los archivos del informe se cargan en una Azure Storage Account y se devuelven enlaces de descarga con tiempo limitado. Deshabilitado de forma predeterminada.
Obligatorio
false
Valor predeterminado
Falso
Tipo
Booleano
Nombre mostrado en el portal
¿Crear un enlace de descarga de archivo (subir el informe al almacenamiento)?
Opciones del portal
Sí: subir 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).
Obligatorio
false
Valor predeterminado
devices-without-primary-user
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
ResourceGroupName
Grupo de recursos que contiene la Storage Account. Procede de las configuraciones de Tenant de RJReport.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
StorageAccountName
Nombre de la Storage Account usado para la carga. Procede de las configuraciones de Tenant de RJReport.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
LinkExpiryDays
Número de días hasta que expira el enlace de descarga generado. Procede de las configuraciones de Tenant de RJReport.
Obligatorio
false
Valor predeterminado
6
Tipo
Int32
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
EmailFrom
La dirección de correo electrónico del remitente. Esto debe configurarse en la personalización del runbook.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingHeaderImageUrl
URL HTTPS pública opcional de una imagen de encabezado personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.HeaderImageUrl. Cuando está vacía, se usa el gráfico de encabezado predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingFooterImageUrl
URL HTTPS pública opcional de una imagen de pie de página personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.FooterImageUrl. Cuando está vacía, se usa el gráfico de pie de página predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingFooterLink
URL opcional a la que enlaza la imagen del pie de página. Se obtiene de la configuración del tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado (https://www.realmjoin.com).
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingAccentColor
Anulación opcional del color de acento (hexadecimal de 6 dígitos, por ejemplo '#0052cc') para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.AccentColor. Cuando está vacío o no es válido, se usa el color de acento predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingTextColor
Anulación opcional del color de texto (hexadecimal de 6 dígitos) para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.TextColor. Cuando está vacío o no es válido, se usa el color de texto predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
EmailTo
Si se especifica, se enviará un correo electrónico con el informe a la(s) dirección(es) proporcionada(s). Puede ser una sola dirección o varias direcciones separadas por comas (cadena). La función envía correos individuales a cada destinatario por motivos de privacidad.
Obligatorio
false
Valor predeterminado
Tipo
String
Nombre mostrado en el portal
Dirección(es) de correo electrónico del destinatario
Última actualización
¿Te fue útil?