> 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/delete-stale-devices_scheduled.md).

# Eliminar dispositivos obsoletos programado

Eliminar dispositivos de Intune que han estado inactivos demasiado tiempo

{% 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

Encuentra dispositivos de Intune que no han realizado ninguna comprobación durante un número dado de días, filtrados por plataforma y opcionalmente por pertenencia a grupos. Un grupo de inclusión limita la ejecución a los dispositivos de sus usuarios; un grupo de exclusión protege los dispositivos de sus usuarios y los dispositivos que son miembros ellos mismos. De forma predeterminada, solo muestra lo que eliminaría; la eliminación debe activarse explícitamente. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.

### Casos de uso comunes

Esta runbook elimina dispositivos administrados de Intune en función de la inactividad, así que úsala con cuidado.

* Limpieza periódica de registros de dispositivos obsoletos en Intune
* Ejecuciones de simulación (modo solo informe) antes de habilitar la eliminación real
* Gestión programada del ciclo de vida con un registro de auditoría mediante el informe por correo electrónico

### Umbral de inactividad

*Días sin actividad* acepta de 1 a 3650 días. Un dispositivo se considera obsoleto cuando su última comprobación fue hace al menos esa cantidad de días.

### Filtrado del alcance de usuarios

La runbook admite filtrado opcional por grupo como una salvaguarda adicional cuando la eliminación está habilitada. También cuentan los miembros de grupos anidados.

* **Grupo de inclusión** - solo están dentro del ámbito los dispositivos cuyo usuario principal es miembro. Se excluyen los dispositivos sin usuario principal y los dispositivos cuyo usuario principal fue eliminado de Entra ID.
* **Grupo de exclusión** - se omiten los dispositivos cuyo usuario principal es miembro, y también los dispositivos cuyo objeto de dispositivo de Entra ID es miembro del propio grupo. Por tanto, un grupo de dispositivos como "Intune - no eliminar" protege sus dispositivos. Los dispositivos de usuarios eliminados siguen dentro del ámbito.

La pertenencia al grupo se comprueba con el ID de objeto del usuario principal tal como lo registra Intune, por lo que un cambio en el nombre principal de usuario no afecta al filtro.

Un grupo se aplica siempre que esté configurado, también cuando la runbook se inicia a través de la API o mediante una programación sin la *¿Filtrar por grupo del usuario principal?* opción. Al elegir *Sí, filtrar por pertenencia al grupo* sin seleccionar un grupo detiene la ejecución antes de que se elimine nada.

El filtro falla en modo cerrado:

* Si no se puede leer un grupo seleccionado, o el grupo de inclusión no contiene usuarios, la ejecución se detiene con un error y no se elimina ningún dispositivo.
* Si Intune registra un usuario principal para un dispositivo pero no un ID de objeto de usuario, el dispositivo no se elimina. Se enumera con el estado *Omitido: no se pudo resolver el usuario principal* para revisión manual.

### Enlace de descarga

Si falla la carga para el enlace de descarga, el informe por correo electrónico y los datos de salida aún se entregan, por lo que la lista de dispositivos eliminados no se pierde. Luego el trabajo finaliza como fallido.

### 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 → Eliminar dispositivos obsoletos (programado)

**Nombre completo del runbook**

rjgit-org\_devices\_delete-stale-devices\_scheduled

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 2.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
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Enumera dispositivos obsoletos de Intune y los elimina mediante DELETE /deviceManagement/managedDevices/{id}*
  * Directory.Read.All
    * *Lee los miembros de los grupos de inclusión/exclusión, los detalles del usuario principal y el nombre del Tenant*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el correo del informe mediante Send-RjRbReportEmail cuando EmailTo está configurado*
  * Organization.Read.All *(opcional — característica: informe por correo electrónico)*
    * *Lee el nombre visible del Tenant para el asunto del correo electrónico, el cuerpo del correo electrónico y los nombres de archivo del informe*

### Parámetros

#### Días

Los dispositivos sin ninguna comprobación durante al menos esta cantidad de días se consideran obsoletos. Se permiten de 1 a 3650 días.

| Propiedad                        | Valor              |
| -------------------------------- | ------------------ |
| Obligatorio                      | falso              |
| Valor predeterminado             | 30                 |
| Tipo                             | Int32              |
| Nombre para mostrar en el portal | Días sin actividad |

#### Windows

Incluye dispositivos Windows.

| Propiedad                        | Valor                          |
| -------------------------------- | ------------------------------ |
| Obligatorio                      | falso                          |
| Valor predeterminado             | Verdadero                      |
| Tipo                             | Booleano                       |
| Nombre para mostrar en el portal | ¿Incluir dispositivos Windows? |

#### macOS

Incluye dispositivos macOS.

| Propiedad                        | Valor                        |
| -------------------------------- | ---------------------------- |
| Obligatorio                      | falso                        |
| Valor predeterminado             | Verdadero                    |
| Tipo                             | Booleano                     |
| Nombre para mostrar en el portal | ¿Incluir dispositivos macOS? |

#### iOS

Incluye dispositivos iOS e iPadOS.

| Propiedad                        | Valor                      |
| -------------------------------- | -------------------------- |
| Obligatorio                      | falso                      |
| Valor predeterminado             | Verdadero                  |
| Tipo                             | Booleano                   |
| Nombre para mostrar en el portal | ¿Incluir dispositivos iOS? |

#### Android

Incluye dispositivos Android.

| Propiedad                        | Valor                          |
| -------------------------------- | ------------------------------ |
| Obligatorio                      | falso                          |
| Valor predeterminado             | Verdadero                      |
| Tipo                             | Booleano                       |
| Nombre para mostrar en el portal | ¿Incluir dispositivos Android? |

#### Eliminar dispositivos

Eliminar quita los dispositivos obsoletos de Intune. Solo informe los enumera y no cambia nada.

| Propiedad                        | Valor               |
| -------------------------------- | ------------------- |
| Obligatorio                      | falso               |
| Valor predeterminado             | Falso               |
| Tipo                             | Booleano            |
| Nombre para mostrar en el portal | Modo de eliminación |

**Opciones del portal**

| Opción del portal                                       | Valor |
| ------------------------------------------------------- | ----- |
| Solo informe: mostrar lo que se eliminaría (simulación) | falso |
| Eliminar dispositivos obsoletos de Intune               | true  |

#### 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 | delete-stale-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) |

#### UseUserScope

Se establece mediante la opción "¿Filtrar por grupo de usuarios principal?"; con "Sí", se requiere al menos un grupo. Un grupo en "Incluir usuarios del grupo" o "Excluir usuarios del grupo" se aplica siempre que esté configurado, también sin esta opción.

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

#### IncludeUserGroup

Solo los dispositivos cuyo usuario principal es miembro de este grupo, directamente o a través de grupos anidados. Los dispositivos sin usuario principal se excluyen.

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

#### ExcludeUserGroup

Se omiten los dispositivos cuyo usuario principal es miembro de este grupo y los dispositivos que son miembros ellos mismos, directamente o a través de grupos anidados. Los dispositivos omitidos nunca se eliminan.

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

#### EmailTo

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

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

[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/delete-stale-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.
