> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/devices/report-windows-devices-without-autopilot_scheduled.md). # Informar de dispositivos Windows sin Autopilot programado {% hint style="info" %} Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de activarse para un único objeto. Consulte [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook. {% endhint %} ### Descripción Este runbook enumera cada objeto de dispositivo Windows en Entra ID (Microsoft Entra) y lo 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 del azureActiveDirectoryDeviceId del objeto de Autopilot) se informan como huérfanos. Estos objetos de dispositivo de Entra huérfanos son restos típicos ("Objektleichen") de dispositivos que se restablecieron, se reinstalaron o se reemplazaron sin haberse limpiado. El informe apoya los esfuerzos 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 (devolviendo enlaces de descarga con tiempo limitado) y/o enviarse por correo electrónico con los formatos de archivo de informe seleccionados adjuntos. El parámetro ReportFileFormat controla qué formatos de archivo se generan y 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 "CSV & XLSX" se selecciona, el correo electrónico recurre únicamente al libro de trabajo de Excel. ### Informe de dispositivos Windows huérfanos Este runbook enumera cada objeto de dispositivo Windows en Entra ID y lo compara con las identidades de dispositivo de Windows Autopilot en Intune. Los dispositivos que no tienen un objeto de Autopilot asociado (coincidente mediante el objeto de Autopilot `azureActiveDirectoryDeviceId`) se informan como candidatos a limpieza ("Objektleichen"). Dos conmutadores Sí/No controlan la salida: * **¿Enviar el informe por correo electrónico?** — cuando se habilita, 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 se habilita, el CSV se carga en un Azure Storage Account y se devuelve un enlace de descarga con tiempo limitado. Ambos pueden combinarse o utilizarse de forma independiente. Si ambos están deshabilitados, el informe solo se imprime en la salida del runbook. ### Configuración relativa al Storage Account El informe CSV se carga en un Azure Storage Account. El Storage Account de destino se toma de la configuración compartida de **RJReport** Tenant, por lo que puede configurarse una sola vez y reutilizarse en todos los runbooks de informes: * `RJReport.StorageAccount.ResourceGroup` * `RJReport.StorageAccount.StorageAccountName` * `RJReport.StorageAccount.LinkExpiryDays` (opcional, el valor predeterminado es 6) El nombre del contenedor se configura por runbook (parámetro `ContainerName`, predeterminado `windows-devices-without-autopilot`) y, de forma intencionada, no forma parte de la configuración global de RJReport. Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener más detalles. La identidad administrada del runbook necesita al menos `Colaborador` acceso en la suscripción o el grupo de recursos que contiene el Storage Account. ### Configuración relacionada con el envío de correos electrónicos El envío de un informe por correo electrónico es opcional y solo se realiza cuando se proporciona un destinatario (`EmailTo`). La dirección del remitente se toma de la `RJReport.EmailSender` configuración de Tenant. Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook. Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener más detalles. #### Branding del correo electrónico El correo electrónico del informe tiene en cuenta la configuración opcional `RJReport.Branding.*` de Tenant: una imagen de encabezado personalizada, una imagen de pie de página personalizada (URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una), un enlace personalizado en el pie de página y colores personalizados de acento y de texto (valores hexadecimales de 6 dígitos, p. ej. `#0052cc`). Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen de branding que no se pueda descargar o validar, o un valor de color que no sea un color hexadecimal válido, nunca impide el envío del correo del informe; en su lugar, se usa el valor predeterminado correspondiente. Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para ver los detalles de configuración. ### Ubicación Organización → Dispositivos → Informe de dispositivos Windows sin Autopilot (Programado) **Nombre completo del runbook** rjgit-org\_devices\_report-windows-devices-without-autopilot\_scheduled ### Detalles | Propiedad | Valor | | ------------------ | ----------------------------------------------------------------------------------------------------------------- | | Versión | 1.3.0 | | Módulos requeridos |

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

| | Programable | sí | ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * Device.Read.All * *Enumera los 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 — función: informe por correo electrónico)* * *Envía el informe mediante Send-RjReportEmail cuando está habilitada la generación de informes por correo electrónico* #### Notas de permisos Azure IaaS: - Contributor - acceso a la suscripción o grupo de recursos utilizado para la exportación ### Parámetros #### SendMail Si está habilitado, el informe se envía por correo electrónico con el/los formato(s) de archivo del informe seleccionados adjuntos. Al activar esta opción se muestran los campos de dirección del destinatario y de formato de archivo del informe. | Propiedad | Valor | | -------------------------------- | ------------------------------------------ | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | ¿Enviar el informe por correo electrónico? | **Opciones del portal** | Opción del portal | Valor | | --------------------------------------------- | ----- | | 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). | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Dirección(es) de correo electrónico del destinatario | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### EmailFrom La dirección de correo electrónico del remitente. Se obtiene de la configuración del Tenant RJReport (RJReport.EmailSender). | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante 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 del informe. Procede de la configuración de Tenant RJReport.Branding.HeaderImageUrl. Cuando está vacía, se usa la imagen de encabezado predeterminada de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante 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 del informe. Procede de la configuración de Tenant RJReport.Branding.FooterImageUrl. Cuando está vacía, se usa la imagen de pie de página predeterminada de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingFooterLink URL opcional a la que enlaza la imagen del pie de página. Procede de la configuración de Tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado (). | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingAccentColor Reemplazo opcional del color de acento (hex de 6 dígitos, p. ej. '#0052cc') para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.AccentColor. Cuando está vacío o es inválido, se usa el color de acento predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingTextColor Reemplazo opcional del color de texto (hex de 6 dígitos) para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.TextColor. Cuando está vacío o es inválido, se usa el color de texto predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ReportFileFormat Controla qué formatos de archivo del informe se generan y entregan: "solo CSV", "CSV y XLSX" (predeterminado) o "solo XLSX". | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | CSV y XLSX | | Tipo | Cadena | | Nombre para mostrar en el portal | Formato del archivo del informe | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | **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. | Propiedad | Valor | | -------------------------------- | --------------------------------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | True | | Tipo | Booleano | | Nombre para mostrar en el portal | ¿Crear un enlace de descarga de archivo (cargar el informe en el almacenamiento)? | **Opciones del portal** | Opción del portal | Valor | | ------------------------------------------------------- | ----- | | Sí - cargar 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). | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | windows-devices-without-autopilot | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ResourceGroupName Grupo de recursos que contiene el Storage Account. Obtenido de la configuración del Tenant de RJReport. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### StorageAccountName Nombre del Storage Account usado para la carga. Obtenido de la configuración del Tenant de RJReport. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### LinkExpiryDays Número de días hasta que expire el enlace de descarga generado. Obtenido de la configuración del Tenant de RJReport. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | 6 | | Tipo | Int32 | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | [Volver a la vista general de la referencia del runbook](/es/automatizacion/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/devices/report-windows-devices-without-autopilot_scheduled.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.