Informe de dispositivos Windows sin Autopilot programado
Informa sobre todos los dispositivos Windows de Entra que no tienen un objeto de Windows Autopilot asociado.
Descripción
Este runbook enumera todos los objetos de dispositivo Windows en Entra ID (Microsoft Entra) y los compara con las identidades de dispositivo de Windows Autopilot en Intune. Los dispositivos de Entra cuyo ID de dispositivo no está referenciado por ningún objeto de Autopilot (a través de azureActiveDirectoryDeviceId del objeto de Autopilot) se notifican como huérfanos.
Estos objetos de dispositivo de Entra huérfanos son restos típicos ("Objektleichen") de dispositivos que se restablecieron, se reimaginó o se reemplazaron sin limpiarlos. El informe apoya las tareas de limpieza al hacer visibles estos candidatos para que puedan revisarse y, si procede, eliminarse.
Opcionalmente, los archivos del informe pueden cargarse en un Azure Storage Account (lo que devuelve enlaces de descarga con tiempo limitado) y/o enviarse por correo electrónico con el/los formato(s) de archivo del informe seleccionados adjuntos. El parámetro ReportFileFormat controla qué formatos de archivo se generan y se entregan (solo CSV, CSV y XLSX, o solo XLSX). Cuando el 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.
Generación de informes de dispositivos Windows huérfanos
Este runbook enumera todos los objetos de dispositivo Windows en Entra ID y los compara con las identidades de dispositivo de Windows Autopilot en Intune. Los dispositivos que no tienen un objeto de Autopilot asociado (coincidencia mediante el objeto de Autopilot azureActiveDirectoryDeviceId) se notifican como candidatos de limpieza ("Objektleichen").
Dos conmutadores Sí/No controlan la salida:
¿Enviar el informe por correo electrónico? — cuando está habilitado, el campo de dirección del destinatario (
EmailTo) se muestra y el informe se envía por correo electrónico con el CSV adjunto.¿Crear un enlace de descarga de archivo? — cuando está habilitado, el CSV se carga en un Azure Storage Account y se devuelve un enlace de descarga con tiempo limitado.
Ambos pueden combinarse o usarse de forma independiente. Si ambos están deshabilitados, el informe solo se imprime en la salida del runbook.
Configuración relativa a la Storage Account
El informe CSV se carga en un Azure Storage Account. La Storage Account de destino se toma de la compartida RJReport configuración del Tenant, por lo que puede configurarse una sola vez y reutilizarse en todos los runbooks de informes:
RJReport.StorageAccount.ResourceGroupRJReport.StorageAccount.StorageAccountNameRJReport.StorageAccount.LinkExpiryDays(opcional, valor predeterminado 6)
El nombre del contenedor se configura por runbook (parámetro ContainerName, predeterminado windows-devices-without-autopilot) y, de forma intencional, no forma parte de la configuración global de RJReport.
Consulta la documentación de configuración de informes de RealmJoin para obtener detalles sobre todas las configuraciones disponibles.
La identidad administrada del runbook necesita al menos Colaborador acceso en la suscripción o grupo de recursos que contiene la Storage Account.
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 más detalles.
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 → Informar Windows Devices Without Autopilot (Programado)
Nombre completo del runbook
rjgit-org_devices_report-windows-devices-without-autopilot_scheduled
Detalles
Versión
1.3.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
Device.Read.All
Enumera dispositivos de Entra filtrados por Windows para listar todos los dispositivos Windows registrados
DeviceManagementServiceConfig.Read.All
Enumera windowsAutopilotDeviceIdentities para detectar dispositivos que carecen de un registro de Autopilot
Organization.Read.All
Lee /organization para obtener el nombre del Tenant en el informe
Mail.Send (opcional — característica: informe por correo electrónico)
Envía el informe mediante Send-RjReportEmail cuando el envío por correo electrónico está habilitado
Notas sobre permisos
Azure IaaS: - Colaborador - acceso en la suscripción o grupo de recursos usado para la exportación
Parámetros
SendMail
Si está habilitado, los archivos del informe (CSV y Excel) se cargan en una Storage Account de Azure y se devuelven en la salida enlaces de descarga con tiempo limitado.
Obligatorio
false
Valor predeterminado
Falso
Tipo
Booleano
Nombre mostrado en el portal
¿Enviar el informe por correo electrónico?
Opciones del portal
Sí - enviar el informe por correo electrónico
No - no enviar un correo electrónico
EmailTo
Dirección o direcciones del destinatario para el informe por correo electrónico. Solo se usa / muestra cuando SendMail está habilitado. Puede ser una sola dirección o varias direcciones separadas por comas (cadena).
Obligatorio
false
Valor predeterminado
Tipo
String
Nombre mostrado en el portal
Dirección(es) de correo electrónico del destinatario
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
EmailFrom
La dirección de correo electrónico del remitente. Se obtiene de la configuración del Tenant de RJReport (RJReport.EmailSender).
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)
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
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
Opciones del portal
CSV & 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.
Obligatorio
false
Valor predeterminado
True
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
No: no crear un enlace de descarga
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
windows-devices-without-autopilot
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)
Última actualización
¿Te fue útil?