> 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/applications/export-enterprise-application-users.md).

# Exportar usuarios de aplicaciones empresariales

Exportar los propietarios y usuarios de todas las aplicaciones empresariales

### Descripción

Enumera todas las aplicaciones empresariales, o todos los Service Principals, con sus propietarios y los usuarios y grupos asignados a ellas, para revisiones y auditorías. No se cambia nada. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.

### Cómo se muestran los propietarios y las asignaciones

Cada fila es un propietario (`PrincipalRole` `Owner`) o una asignación (`PrincipalRole` `Miembro`) de una aplicación. Una aplicación sin propietario obtiene una fila de propietario con un campo vacío `PrincipalId`.

* Los propietarios pueden ser usuarios o Service Principals, diferenciados por `PrincipalType`. Un usuario se muestra con su nombre principal de usuario, un Service Principal con su nombre para mostrar y su ID de aplicación entre corchetes.
* Los usuarios asignados se muestran con su nombre principal de usuario, los grupos asignados con su alias de correo y nombre para mostrar, y los Service Principals asignados con su ID de objeto.
* Cuando falla una búsqueda, por ejemplo por falta de permisos, `PrincipalId` muestra `(búsqueda fallida)`, después del ID de objeto cuando se conoce, y la ejecución escribe una advertencia. Esa fila no significa que la aplicación no tenga propietario ni asignación.

### 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 → Aplicaciones → Exportar usuarios de aplicaciones empresariales

**Nombre completo del runbook**

rjgit-org\_applications\_export-enterprise-application-users

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 1.5.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        | no                                                                                                                 |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * Application.Read.All
    * *Enumera Service Principals y lee sus propietarios y asignaciones de roles de aplicación*
  * Directory.Read.All
    * *Resuelve los usuarios y grupos asignados y lee el nombre del Tenant para el informe*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el correo electrónico del informe mediante Send-RjReportEmail cuando EmailTo está configurado*
  * Organization.Read.All *(opcional — característica: informe por correo electrónico)*
    * *Lee el nombre para mostrar del Tenant para el correo electrónico del informe cuando EmailTo está configurado*

#### Notas sobre permisos

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

### Parámetros

#### entAppsOnly

Solo aplicaciones empresariales, o todos los Service Principals del Tenant.

| Propiedad                        | Valor     |
| -------------------------------- | --------- |
| Obligatorio                      | falso     |
| Valor predeterminado             | Verdadero |
| Tipo                             | Booleano  |
| Nombre para mostrar en el portal | Alcance   |

**Opciones del portal**

| Opción del portal                                  | Valor |
| -------------------------------------------------- | ----- |
| Listar solo aplicaciones empresariales             | true  |
| Listar todos los Service Principals / aplicaciones | falso |

#### 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             | Verdadero                     |
| 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 cargan los archivos del informe. Tomado de la configuración del Tenant EntAppsReport.Container.

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

#### ResourceGroupName

Grupo de recursos del Storage Account para las cargas del informe. Tomado de la configuración del Tenant EntAppsReport.ResourceGroup; cuando no está configurado, se usa RJReport.StorageAccount.ResourceGroup.

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

#### StorageAccountName

Storage Account para las cargas del informe. Tomado de la configuración del Tenant EntAppsReport.StorageAccount.Name; cuando no está configurado, se usa 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 Storage Account indicada en ResourceGroupName y StorageAccountName. No se toma de una configuración del Tenant; 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. Tomado de la configuración del Tenant EntAppsReport.LinkExpiryDays; cuando no está configurado, se usa RJReport.StorageAccount.LinkExpiryDays.

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

#### RJReportResourceGroupName

Grupo de recursos del Storage Account para las cargas del informe. Tomado de la configuración del Tenant RJReport.StorageAccount.ResourceGroup y se usa cuando EntAppsReport.ResourceGroup no está configurado.

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

#### RJReportStorageAccountName

Storage Account para las cargas del informe. Tomado de la configuración del Tenant RJReport.StorageAccount.StorageAccountName y se usa cuando EntAppsReport.StorageAccount.Name no está configurado.

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

#### RJReportSubscriptionId

ID de suscripción de la Storage Account para las cargas del informe. Tomado de la configuración del Tenant RJReport.StorageAccount.SubscriptionId y usado cuando la Storage Account proviene de RJReport.StorageAccount.

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

#### RJReportLinkExpiryDays

Número de días que un enlace de descarga permanece válido. Tomado de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays y se usa cuando EntAppsReport.LinkExpiryDays no está configurado.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado | 0                                                           |
| Tipo                 | Int32                                                       |
| 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) |

#### 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/applications/export-enterprise-application-users.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.
