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

# Generar informe programado de dispositivos obsoletos

Generar un informe de dispositivos 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

Enumera dispositivos de Intune que no han realizado un check-in durante un número determinado de días, opcionalmente dentro de una antigüedad máxima. La lista se puede filtrar por plataforma y por la pertenencia a grupos del usuario principal; el grupo de exclusión también omite los dispositivos que son miembros por sí mismos. No se modifica nada. El informe se puede enviar por correo electrónico o proporcionar como un enlace de descarga.

### Casos de uso comunes

* Auditorías periódicas del inventario de dispositivos e informes de cumplimiento
* Identificación de dispositivos para baja o desmantelamiento
* Revisiones de seguridad para encontrar dispositivos potencialmente perdidos
* Supervisión del estado de los dispositivos en toda la organización
* Informes escalonados con una inactividad máxima, por ejemplo de 30 a 60 días y de 60 a 90 días
* Filtrado del alcance de usuarios para centrarse en departamentos específicos o excluir cuentas de servicio

### Rango de inactividad

Una *Máximo de días sin actividad* solo se aplica cuando está por encima de *Días sin actividad*. Un valor menor o igual se ignora con una advertencia, y el informe enumera todos los dispositivos inactivos durante al menos *Días sin actividad*.

### Filtrado del alcance de usuarios

El runbook puede incluir o excluir dispositivos según la pertenencia a grupos de su usuario principal. El filtro se aplica en cuanto se selecciona un grupo en *Incluir usuarios del grupo* o *Excluir usuarios del grupo*; ambos se pueden combinar. Los miembros de grupos anidados también cuentan.

Con un grupo de inclusión, solo se informan los dispositivos cuyo usuario principal es miembro; los dispositivos sin usuario principal se omiten. El grupo de exclusión omite 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 lo que se puede usar un grupo de dispositivos para dejar dispositivos fuera del informe. Si no se puede leer un grupo seleccionado, la ejecución se detiene con un error en lugar de informar una lista sin filtrar.

Las versiones anteriores preguntaban *¿Filtrar por grupo del usuario principal?* antes de que se mostraran los selectores de grupo. Esa opción ya no existe; las programaciones creadas con ella siguen funcionando, y los grupos almacenados en ellas ahora se aplican directamente.

### Entrega del informe

Los archivos del informe solo se generan cuando se selecciona un método de entrega mediante la **Entrega del informe** opción (correo electrónico y/o enlace de descarga). Con *solo Datos de salida* seleccionado, los resultados se leen directamente en la pestaña Output Data del portal de RealmJoin, donde cada tabla también se puede exportar a Excel. La entrega por correo electrónico y la generación del enlace de descarga son independientes y se pueden combinar.

Para el enlace de descarga, los archivos del informe se cargan en la Azure Storage Account configurada en la `RJReport.StorageAccount.*` configuración del Tenant, y se devuelven enlaces de descarga SAS con tiempo limitado. La carga al almacenamiento se autentica con la identidad administrada de la cuenta de Automation; esa identidad necesita el **Reader and Data Access** rol RBAC en la Storage Account de destino (esta es una asignación de Azure RBAC, no un permiso de aplicación de Graph).

Las programaciones que se crearon antes de la **Entrega del informe** existiera la opción siguen enviando su correo electrónico: un destinatario almacenado por sí solo sigue habilitando el correo electrónico para ellos. Cuando se abre una programación de este tipo para editarla, la opción muestra *solo Datos de salida*; vuelva a seleccionar la entrega antes de guardar; de lo contrario, la programación deja de enviar el informe.

Con la entrega por correo electrónico seleccionada, también se envía un correo electrónico cuando ningún dispositivo está obsoleto; enumera lo que se comprobó.

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

El envío del informe por correo electrónico es opcional y solo ocurre cuando *Enviar también el informe por correo electrónico* o *Enviar también por correo electrónico y enlace de descarga* se selecciona como entrega del informe; entonces se requiere un destinatario. La dirección del remitente se toma de la `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** - 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

Organización → Dispositivos → Informar dispositivos obsoletos (Programado)

**Nombre completo del runbook**

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

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 1.7.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.Read.All
    * *Enumera dispositivos de Intune filtrados por lastSyncDateTime para encontrar dispositivos obsoletos*
  * 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 electrónico del informe mediante Send-RjRbReportEmail cuando se selecciona la entrega por correo electrónico*
  * 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*

#### Notas sobre permisos

Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la cuenta de Automation en la Storage Account de destino - la carga recupera las claves de la cuenta mediante listKeys (solo necesario para las opciones de enlace de descarga)

### Parámetros

#### Días

Los dispositivos sin check-in durante al menos este número de días cuentan como obsoletos.

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

#### MaxDays

Solo se incluyen los dispositivos inactivos durante como máximo este número de días. Déjelo vacío para no establecer un límite superior. Un valor que no sea superior a "Días sin actividad" se ignora.

| Propiedad                        | Valor                        |
| -------------------------------- | ---------------------------- |
| Obligatorio                      | falso                        |
| Valor predeterminado             |                              |
| Tipo                             | Int32                        |
| Nombre para mostrar en el portal | Máximo de 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/iPadOS? |

#### Android

Incluye dispositivos Android.

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

#### UseUserScope

Ya no se usa. El filtro de grupo del usuario principal se aplica en cuanto se selecciona un grupo en "Incluir usuarios del grupo" o "Excluir usuarios del grupo". Se mantiene para que las programaciones existentes sigan funcionando.

| 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. Déjelo vacío para todos los dispositivos.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Obligatorio          | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ExcludeUserGroup

Omite los dispositivos cuyo usuario principal es miembro de este grupo y los dispositivos que son miembros por sí mismos, directamente o a través de grupos anidados. Déjelo vacío para no omitir ninguno.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Obligatorio          | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### SendEmailReport

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

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

#### ContainerName

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

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado | report-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) |

[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/report-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.
