> 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/cleanup-autopilot-devices_scheduled.md).

# Limpieza programada de dispositivos de Autopilot

Quitar los registros de Autopilot huérfanos y que nunca se inscribieron

{% hint style="info" %}
Este es un runbook programado. Está diseñado para ejecutarse con una programación recurrente en lugar de activarse para un único objeto. Consulte [Programación](https://docs.realmjoin.com/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}

### Descripción

Limpia los registros de Windows Autopilot: dispositivos cuyo número de serie ya no coincide con ningún dispositivo de Intune (huérfanos) y, opcionalmente, dispositivos que nunca se inscribieron y tienen más antigüedad que una edad determinada. De forma predeterminada, solo informa de lo que eliminaría; la eliminación debe activarse explícitamente y puede incluir los objetos de dispositivo de Entra ID correspondientes. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.

### La eliminación es irreversible

* Eliminar una identidad de dispositivo de Autopilot la borra permanentemente de Windows Autopilot. No existe eliminación temporal ni papelera de reciclaje para los registros de Autopilot.
* El dispositivo físico no puede volver a entrar en Autopilot hasta que su hash de hardware se cargue de nuevo.
* Eliminar el objeto de dispositivo de Entra es igualmente permanente; hágalo solo para registros que realmente están inactivos, es decir, cuando el dispositivo nunca volverá a inscribirse.

### Primera ejecución recomendada

1. Ejecutar con el modo de eliminación *WhatIf (solo informe)*, que es la opción predeterminada, y revise la salida o el CSV enviado por correo electrónico.
2. Confirme que los dispositivos identificados están realmente huérfanos o nunca se inscribieron.
3. Cambie a un modo de eliminación solo después de revisar la lista de candidatos.

### Interacciones de parámetros

* `Modo de eliminación` tiene como valor predeterminado *WhatIf (solo informe)*; no se realizan eliminaciones en ese modo.
* *Eliminar dispositivo de Autopilot* elimina solo la identidad de Autopilot. *Eliminar dispositivo de Autopilot y de Entra* además elimina el objeto de dispositivo de Entra correspondiente, que de otro modo quedaría como un registro obsoleto una vez que desaparezca la identidad de Autopilot. El segundo modo requiere el `Device.ReadWrite.All` permiso.
* `LimpiarDispositivosHuérfanos` y `LimpiarDispositivosNuncaInscritos` son independientes; se puede habilitar uno de ellos o ambos. `DíasDeNuncaInscritos` se aplica solo a la comprobación de nunca inscritos.
* `GroupTagFilter`, `Filtro de fabricante` y `Filtro de modelo` son opcionales; deje un filtro vacío para evaluar todos los valores de esa dimensión. Cuando se establece más de un filtro, se combinan con AND, por lo que un dispositivo debe coincidir con todos los filtros rellenados para permanecer en el ámbito. `GroupTagFilter` coincide exactamente con la etiqueta de grupo (sin distinguir mayúsculas y minúsculas); `Filtro de fabricante` y `Filtro de modelo` coinciden como subcadenas sin distinguir mayúsculas y minúsculas, por lo que "Dell" coincide con "Dell Inc." y "Surface" coincide con "Surface Laptop 3".
* `Excluir números de serie` se aplica después de los filtros AND como una exclusión: un dispositivo cuyo número de serie esté en la lista (exacta, sin distinguir mayúsculas y minúsculas) se elimina del ámbito independientemente de los demás filtros. Déjelo vacío para no excluir nada.

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

El envío de 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 configuración de `RJReport.EmailSender` de Tenant.

Este runbook envía correos electrónicos mediante la API de Microsoft Graph. Para enviar correos mediante Graph API, debes 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](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para conocer todos los ajustes disponibles.

#### Marca del correo electrónico

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

* **Imagen de cabecera y pie de página** – URLs 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

Organización → Dispositivos → Limpiar dispositivos de Autopilot (Programado)

**Nombre completo del runbook**

rjgit-org\_devices\_cleanup-autopilot-devices\_scheduled

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 1.4.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.ReadWrite.All
    * *Busca dispositivos de Entra por deviceId y los elimina en el modo 'Eliminar dispositivo de Autopilot y de Entra'*
  * DeviceManagementManagedDevices.Read.All
    * *Lee los dispositivos Windows administrados por Intune para encontrar números de serie de Autopilot que ya no están presentes en Intune*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Enumera windowsAutopilotDeviceIdentities y elimina las identidades obsoletas de Autopilot*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el correo electrónico del informe de limpieza mediante Send-RjReportEmail cuando EmailTo está configurado*
  * Organization.Read.All
    * *Lee /organization para mostrar el nombre para mostrar del inquilino en la salida del informe y en el correo electrónico*

### Parámetros

#### Modo de eliminación

WhatIf solo informa de los candidatos. Eliminar dispositivo de Autopilot elimina los registros de Autopilot. Eliminar dispositivo de Autopilot y de Entra también elimina los objetos de dispositivo de Entra ID correspondientes.

| Propiedad                        | Valor                 |
| -------------------------------- | --------------------- |
| Obligatorio                      | falso                 |
| Valor predeterminado             | WhatIf (solo informe) |
| Tipo                             | Cadena                |
| Nombre para mostrar en el portal | Modo de eliminación   |

#### GroupTagFilter

Solo los dispositivos con una de estas etiquetas de grupo de Autopilot, separadas por comas y coincidentes exactamente. Déjelo vacío para todos.

| Propiedad                        | Valor                       |
| -------------------------------- | --------------------------- |
| Obligatorio                      | falso                       |
| Valor predeterminado             |                             |
| Tipo                             | Cadena                      |
| Nombre para mostrar en el portal | Filtro de etiqueta de grupo |

#### Filtro de fabricante

Solo estos fabricantes, separados por comas; Dell también coincide con Dell Inc. Déjelo vacío para todos.

| Propiedad                        | Valor                |
| -------------------------------- | -------------------- |
| Obligatorio                      | falso                |
| Valor predeterminado             |                      |
| Tipo                             | Cadena               |
| Nombre para mostrar en el portal | Filtro de fabricante |

#### Filtro de modelo

Solo estos modelos, separados por comas; Surface también coincide con Surface Laptop 3. Déjelo vacío para todos.

| Propiedad                        | Valor            |
| -------------------------------- | ---------------- |
| Obligatorio                      | falso            |
| Valor predeterminado             |                  |
| Tipo                             | Cadena           |
| Nombre para mostrar en el portal | Filtro de modelo |

#### Excluir números de serie

Números de serie que nunca se tocan, separados por comas. Déjelo vacío para no excluir nada.

| Propiedad                        | Valor                    |
| -------------------------------- | ------------------------ |
| Obligatorio                      | falso                    |
| Valor predeterminado             |                          |
| Tipo                             | Cadena                   |
| Nombre para mostrar en el portal | Excluir números de serie |

#### LimpiarDispositivosHuérfanos

Elimina los registros de dispositivos que alguna vez contactaron con Intune pero que ya no existen allí.

| Propiedad                        | Valor                            |
| -------------------------------- | -------------------------------- |
| Obligatorio                      | falso                            |
| Valor predeterminado             | Verdadero                        |
| Tipo                             | Booleano                         |
| Nombre para mostrar en el portal | ¿Limpiar dispositivos huérfanos? |

#### DíasDesdeÚltimoContactoDeHuérfanos

Un dispositivo solo cuenta como huérfano cuando su último contacto con Intune tiene más de esta cantidad de días, por lo que los dispositivos activos recientemente están a salvo.

| Propiedad                        | Valor                       |
| -------------------------------- | --------------------------- |
| Obligatorio                      | falso                       |
| Valor predeterminado             | 90                          |
| Tipo                             | Int32                       |
| Nombre para mostrar en el portal | Huérfanos después de (días) |

#### LimpiarDispositivosNuncaInscritos

Elimina los registros de dispositivos que nunca contactaron con Intune y que tienen más antigüedad que "Nunca inscritos después de (días)".

| Propiedad                        | Valor                                  |
| -------------------------------- | -------------------------------------- |
| Obligatorio                      | falso                                  |
| Valor predeterminado             | Falso                                  |
| Tipo                             | Booleano                               |
| Nombre para mostrar en el portal | ¿Limpiar dispositivos nunca inscritos? |

**Opciones del portal**

| Opción del portal                                            | Valor |
| ------------------------------------------------------------ | ----- |
| Sí, eliminar los dispositivos nunca inscritos con antigüedad | true  |
| Sin                                                          | falso |

#### DíasDeNuncaInscritos

Los registros de nunca inscritos con más de esta cantidad de días, contados desde su fecha de creación, se eliminan.

| Propiedad                        | Valor                                                       |
| -------------------------------- | ----------------------------------------------------------- |
| Obligatorio                      | falso                                                       |
| Valor predeterminado             | 90                                                          |
| Tipo                             | Int32                                                       |
| Nombre para mostrar en el portal | Nunca inscritos después de (días)                           |
| Oculto en el portal              | sí (preestablecido mediante la personalización del runbook) |

#### EmailTo

Envía el informe de limpieza a estas direcciones, separadas por comas. Déjelo vacío para no enviar ningún correo electrónico.

| Propiedad                        | Valor                                                |
| -------------------------------- | ---------------------------------------------------- |
| Obligatorio                      | falso                                                |
| Valor predeterminado             |                                                      |
| Tipo                             | Cadena                                               |
| Nombre para mostrar en el portal | Dirección(es) de correo electrónico del destinatario |

#### EmailFrom

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

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

#### BrandingHeaderImageUrl

Imagen de cabecera 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 la cabecera predeterminada de RealmJoin cuando está vacía.

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

#### BrandingFooterImageUrl

Imagen del 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ía.

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

#### BrandingFooterLink

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

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido 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                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingTextColor

Color del 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                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### ReportFileFormat

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

| Propiedad                        | Valor                           |
| -------------------------------- | ------------------------------- |
| Obligatorio                      | falso                           |
| 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        | CSV y XLSX |
| Solo CSV          | Solo CSV   |
| Solo XLSX         | Solo XLSX  |

#### CreateDownloadLink

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

| Propiedad                        | Valor                         |
| -------------------------------- | ----------------------------- |
| Obligatorio                      | falso                         |
| Valor predeterminado             | Falso                         |
| Tipo                             | Booleano                      |
| Nombre para mostrar en el portal | ¿Crear un enlace de descarga? |

**Opciones del portal**

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

#### ContainerName

Contenedor de almacenamiento al que se suben los archivos del informe. Se establece por runbook.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado | cleanup-autopilot-devices                                   |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### ResourceGroupName

Grupo de recursos de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.

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

#### StorageAccountName

Cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.

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

#### SubscriptionId

ID de suscripción de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.SubscriptionId; cuando está vacío, se usa la suscripción en la que inicia sesión la identidad administrada.

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

#### LinkExpiryDays

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

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

[Volver al resumen de referencia de Runbook](https://docs.realmjoin.com/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/cleanup-autopilot-devices_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.
