> 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).

# Generar informe programado de dispositivos Windows sin Autopilot

Generar un informe de dispositivos Windows en Entra ID sin un registro de Autopilot

{% 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. Véase [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}

### Descripción

Enumera los objetos de dispositivo Windows en Entra ID a los que no hace referencia ningún registro de Windows Autopilot. Estos objetos huérfanos suelen ser restos de dispositivos que se restablecieron, se reinstalaron con una nueva imagen o se reemplazaron sin limpieza, por lo que la lista muestra lo que se puede revisar y eliminar. No se cambia nada. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.

### Informe de dispositivos Windows huérfanos

Este runbook enumera todos los objetos de dispositivo Windows en Entra ID y los compara con las identidades de dispositivos de Windows Autopilot en Intune. Los dispositivos que no tienen un objeto de Autopilot asociado (coincidente mediante la del objeto de Autopilot `azureActiveDirectoryDeviceId`) se informan como candidatos para limpieza.

Dos interruptores de Sí/No controlan la salida:

* **¿Enviar el informe por correo electrónico?** — cuando se habilita, se muestra el campo de dirección del destinatario (`EmailTo`) y el informe se envía por correo electrónico con el CSV adjunto.
* **¿Crear un enlace de descarga del 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 usarse de forma independiente. Si ambos están deshabilitados, el informe solo se imprime en la salida del runbook.

### Configuración relacionada con la cuenta de almacenamiento

El informe CSV se carga en un Azure Storage Account. La cuenta de almacenamiento de destino se toma de la configuración compartida de **RJReport** del inquilino, por lo que puede configurarse una vez y reutilizarse en todos los runbooks de informes:

* `RJReport.StorageAccount.ResourceGroup`
* `RJReport.StorageAccount.StorageAccountName`
* `RJReport.StorageAccount.LinkExpiryDays` (opcional, valor predeterminado: 6)

El nombre del contenedor se configura por runbook (parámetro `ContainerName`, predeterminado `windows-devices-without-autopilot`) y deliberadamente no forma parte de la configuración global de RJReport.

Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) 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 cuenta de almacenamiento.

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

El envío de un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (`EmailTo`) se proporciona. 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 a través de la API de Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para más detalles.

#### Marca del correo electrónico

El correo electrónico del informe tiene en cuenta la opción opcional `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, p. ej. `#0052cc`

Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede 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](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Ubicación

Organization → Devices → Report Windows Devices Without Autopilot (Scheduled)

**Nombre completo del runbook**

rjgit-org\_devices\_report-windows-devices-without-autopilot\_scheduled

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 1.3.0                                                                                                              |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Programable        | sí                                                                                                                 |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * Device.Read.All
    * *Enumera los dispositivos de Entra filtrados a Windows para enumerar todos los dispositivos Windows registrados*
  * DeviceManagementServiceConfig.Read.All
    * *Enumera windowsAutopilotDeviceIdentities para detectar dispositivos sin un registro de Autopilot*
  * Organization.Read.All
    * *Lee /organization para obtener el nombre del inquilino en el informe*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el informe mediante Send-RjReportEmail cuando el envío de informes por correo electrónico está habilitado*

#### Notas sobre permisos

Azure IaaS: - Contributor - acceso en la suscripción o grupo de recursos utilizado para la exportación

### Parámetros

#### SendMail

Enviar el informe a la dirección de correo electrónico del destinatario.

| Propiedad                      | Valor                                      |
| ------------------------------ | ------------------------------------------ |
| Requerido                      | falso                                      |
| Valor predeterminado           | Falso                                      |
| Tipo                           | Booleano                                   |
| Nombre para mostrar del portal | ¿Enviar el informe por correo electrónico? |

**Opciones del portal**

| Opción del portal                            | Valor     |
| -------------------------------------------- | --------- |
| Sí: enviar el informe por correo electrónico | verdadero |
| No: no enviar un correo electrónico          | falso     |

#### EmailTo

Envía el informe a estas direcciones. Separe varias con comas; cada destinatario recibe un correo electrónico independiente.

| Propiedad                      | Valor                                                       |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido                      | falso                                                       |
| Valor predeterminado           |                                                             |
| Tipo                           | Cadena                                                      |
| Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario        |
| Oculto en el portal            | sí (preconfigurado mediante la personalización del runbook) |

#### EmailFrom

Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado 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). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado 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). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingFooterLink

Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingAccentColor

Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingTextColor

Color de texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### ReportFileFormat

Entrega el informe como CSV, como un libro de Excel o ambos.

| Propiedad                      | Valor                                                       |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido                      | falso                                                       |
| Valor predeterminado           | CSV y XLSX                                                  |
| Tipo                           | Cadena                                                      |
| Nombre para mostrar del portal | Formato del archivo del informe                             |
| Oculto en el portal            | sí (preconfigurado mediante la personalización del runbook) |

**Opciones del portal**

| Opción del portal | Valor      |
| ----------------- | ---------- |
| CSV y XLSX        | CSV y XLSX |
| Solo CSV          | Solo CSV   |
| Solo XLSX         | Solo XLSX  |

#### CreateDownloadLink

También carga el informe y devuelve un enlace de descarga que expira después de unos días.

| Propiedad                      | Valor                         |
| ------------------------------ | ----------------------------- |
| Requerido                      | falso                         |
| Valor predeterminado           | Verdadero                     |
| Tipo                           | Booleano                      |
| Nombre para mostrar del portal | ¿Crear un enlace de descarga? |

**Opciones del portal**

| Opción del portal                                       | Valor     |
| ------------------------------------------------------- | --------- |
| Sí - cargar el informe y devolver un enlace de descarga | verdadero |
| No - no crear un enlace de descarga                     | falso     |

#### ContainerName

Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | windows-devices-without-autopilot                           |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### ResourceGroupName

Grupo de recursos de la Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### StorageAccountName

Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### LinkExpiryDays

Número de días que un enlace de descarga permanece válido. Obtenido de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | 6                                                           |
| Tipo                 | Int32                                                       |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

[Volver a la vista general de 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/devices/report-windows-devices-without-autopilot_scheduled.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.