> 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/security/report-epm-elevation-requests_scheduled.md).
# Informe programado de solicitudes de elevación de EPM
Informar de las solicitudes de elevación de EPM por estado y antigüedad
{% 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
Recopila las solicitudes de elevación de Endpoint Privilege Management desde Intune, filtradas por estado y por cuánto tiempo hace que se crearon. Las solicitudes se enumeran por estado con un resumen de los recuentos. Intune conserva los detalles de las solicitudes durante 30 días, por lo que no se pueden informar las solicitudes más antiguas. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.
### Propósito y casos de uso
* Informes periódicos de las actividades de Endpoint Privilege Management (EPM)
* Registro de auditoría de solicitudes de elevación aprobadas y denegadas
* Análisis de solicitudes expiradas para identificar cuellos de botella del proceso
* Identificación de aplicaciones solicitadas con frecuencia para reglas de elevación automática
Se recomienda una programación mensual.
### Tipos de estado
* **Pendiente:** espera una decisión de un administrador (use **Monitor Pending EPM Requests** para alertas críticas en tiempo)
* **Aprobado:** un administrador aprobó la solicitud; el usuario puede continuar con la elevación
* **Denegado:** un administrador rechazó la solicitud debido a problemas de seguridad o de directiva
* **Expirado:** la solicitud expiró antes de que un administrador la revisara, lo que puede indicar tiempos de respuesta lentos
* **Revocado:** una elevación aprobada previamente fue revocada posteriormente por un administrador
* **Completado:** el usuario ejecutó correctamente la aplicación elevada después de la aprobación
### Retención de datos y intervalos de tiempo
* Intune conserva los detalles de las solicitudes de EPM durante 30 días después de su creación.
* Para un análisis a largo plazo, archive las exportaciones CSV fuera de Intune.
* El filtro predeterminado cubre los estados Aprobado, Denegado, Expirado y Revocado de los últimos 30 días.
### Archivos de salida e informe
* La pestaña Output Data de la ejecución muestra un *Resumen* tabla con los recuentos y una tabla por cada estado seleccionado (por ejemplo *Solicitudes aprobadas*), primero la solicitud más antigua.
* Los archivos de informe contienen cada solicitud coincidente con todos los detalles: marcas de tiempo, usuarios, dispositivos, aplicaciones, justificaciones y hashes de archivo. Se generan como CSV y/o Excel (xlsx), según el formato de archivo de informe seleccionado.
* Los correos electrónicos se envían individualmente a cada destinatario por privacidad.
* No se envía ningún correo electrónico ni se crea ningún archivo cuando ninguna solicitud coincide con los criterios del filtro. Una ejecución de este tipo se completa con normalidad; la pestaña Output Data sigue mostrando el resumen.
### Entrega del informe
Los archivos del informe solo se generan cuando se selecciona un método de entrega a través de 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 Datos de salida del portal RealmJoin, donde cada tabla también puede exportarse a Excel. La entrega por correo electrónico y la generación del enlace de descarga son independientes y pueden combinarse.
Para el enlace de descarga, los archivos del informe se cargan en la Storage Account de Azure 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 (esto es una asignación de RBAC de Azure, no un permiso de aplicación de Graph).
Las programaciones que se crearon antes de que la **Entrega del informe** opción existiera siguen enviando su correo electrónico: con un destinatario almacenado solo, el correo electrónico sigue estando habilitado para ellos. Cuando se abre una programación de ese tipo para editarla, la opción muestra *Solo datos de salida*; seleccione de nuevo la entrega antes de guardar; de lo contrario, la programación deja de enviar el informe.
### Configuración relacionada con el envío de correo electrónico
Enviar un informe por correo electrónico es opcional y solo ocurre cuando *Enviar también el informe por correo electrónico* o *Enviar también el informe 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` 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 obtener detalles sobre todas las configuraciones disponibles.
#### 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 estos ajustes no están configurados, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no puede descargarse o validarse, 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 → Seguridad → Informe de solicitudes de elevación de EPM (programado)
**Nombre completo del runbook**
rjgit-org\_security\_report-EPM-elevation-requests\_scheduled
### Detalles
| Propiedad | Valor |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión | 1.4.0 |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Programable | sí |
### Permisos
#### Permisos de aplicación
* **Tipo**: Microsoft Graph
* DeviceManagementConfiguration.Read.All
* *Consulta elevationRequests de Endpoint Privilege Management por estado y fecha de creación para generar el informe*
* Mail.Send *(opcional — característica: informe por correo electrónico)*
* *Envía el correo electrónico del informe con archivos adjuntos CSV/XLSX 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 para mostrar y el ID de 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 Automation Account 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
#### IncludeApproved
Incluye las solicitudes que aprobó un administrador.
| Propiedad | Valor |
| ------------------------------ | ------------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir solicitudes aprobadas? |
#### IncludeDenied
Incluye las solicitudes que rechazó un administrador.
| Propiedad | Valor |
| ------------------------------ | ------------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir solicitudes denegadas? |
#### IncludeExpired
Incluye las solicitudes que expiraron antes de que se tomara una decisión.
| Propiedad | Valor |
| ------------------------------ | ------------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir solicitudes expiradas? |
#### IncludeRevoked
Incluye las solicitudes cuya aprobación se retiró posteriormente.
| Propiedad | Valor |
| ------------------------------ | ------------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir solicitudes revocadas? |
#### IncludePending
Incluye las solicitudes que aún están esperando una decisión.
| Propiedad | Valor |
| ------------------------------ | -------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir solicitudes pendientes? |
#### IncludeCompleted
Incluye las solicitudes que fueron aprobadas y usadas.
| Propiedad | Valor |
| ------------------------------ | --------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir solicitudes completadas? |
#### MaxAgeInDays
Solo se notifican las solicitudes creadas dentro de este número de días. Intune conserva los detalles de las solicitudes durante 30 días, por lo que un valor mayor se reduce a 30.
| Propiedad | Valor |
| ------------------------------ | ----------------------- |
| Requerido | falso |
| Valor predeterminado | 30 |
| Tipo | Int32 |
| Nombre para mostrar del portal | Creado dentro de (días) |
#### SendEmailReport
Enviar el informe a la dirección de correo electrónico del destinatario.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### 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 | Falso |
| Tipo | Booleano |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ContainerName
Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | report-epm-elevation-requests |
| 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/security/report-epm-elevation-requests_scheduled.md?ask=&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.