> 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/user/general/list-group-memberships.md).

# Enumerar membresías de grupos

Enumerar las membresías de grupo de este usuario

### Descripción

Enumera los grupos de los que este usuario es miembro, con filtros para el tipo de grupo, el tipo de membresía, la asignabilidad de roles, Teams, el origen y writeback. El resultado se muestra como texto CSV y como tablas de datos de salida. El informe también puede enviarse por correo electrónico o proporcionarse como un enlace de descarga. No se cambia nada.

### Salida y entrega del informe

Cada ejecución enumera los grupos coincidentes como texto CSV en la salida del runbook y escribe dos tablas de datos de salida, que pueden ordenarse, filtrarse y exportarse en el portal de RealmJoin:

* `Resumen` - el usuario, los filtros seleccionados, el número de membresías directas de grupo y el número de grupos que coinciden con los filtros.
* `Membresías de grupo` - una fila por cada grupo coincidente con las mismas columnas que el archivo CSV y la `Membresías de grupo` hoja de cálculo. Cuando no coincide ningún grupo, se muestra en su lugar una línea de estado.

Los **Entrega del informe** La opción añade archivos de informe además:

* **solo Datos de salida** (predeterminado) - sin archivos de informe.
* **Enviar también el informe por correo electrónico** - el campo de dirección del destinatario (`EmailTo`) se muestra y es obligatorio, y el informe se envía por correo electrónico con el/los archivo(s) de informe adjuntos.
* **Crear también un enlace de descarga** - el/los archivo(s) de informe se cargan en un Azure Storage Account y se devuelve un enlace de descarga con tiempo limitado.
* **Enviar también por correo electrónico y enlace de descarga** - ambos.

**Formato del archivo del informe** elige CSV, XLSX o ambos para los archivos de informe. Cuando ningún grupo coincide con los filtros, no se crean, cargan ni envían por correo electrónico archivos de informe.

La opción establece los parámetros `SendMail` y `CreateDownloadLink`. Las programaciones y las llamadas de API que pasan estos parámetros directamente siguen funcionando como antes.

### Configuración relativa a la cuenta de almacenamiento

Para el enlace de descarga, los archivos de informe se cargan en un Azure Storage Account. La cuenta de almacenamiento de destino se toma de la configuración compartida **RJReport** del tenant, por lo que puede configurarse una vez y reutilizarse en todos los runbooks de informe:

* `RJReport.StorageAccount.ResourceGroup`
* `RJReport.StorageAccount.StorageAccountName`
* `RJReport.StorageAccount.SubscriptionId` (opcional, recomendado; véase [Suscripción de la Storage Account](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#subscription-of-the-storage-account))
* `RJReport.StorageAccount.LinkExpiryDays` (opcional, el valor predeterminado es 6)

El nombre del contenedor se configura por runbook (parámetro `ContainerName`, predeterminado `user-group-memberships`). La identidad administrada de la Automation Account necesita el `Reader and Data Access` rol en la Storage Account.

### 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* está seleccionada como entrega del informe (parámetro `SendMail`); se requiere un destinatario (`EmailTo`) entonces. 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** – 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

Usuario → General → Listar membresías de grupo

**Nombre completo del runbook**

rjgit-user\_general\_list-group-memberships

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 1.8.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
  * Group.Read.All
    * *Lee los grupos del usuario mediante /users/{id}/memberOf, incluidas las reglas de membresía para el filtrado*
  * Organization.Read.All
    * *Lee /organization para obtener el nombre para mostrar del tenant en el informe por correo electrónico*
  * User.Read.All
    * *Resuelve el usuario de destino para obtener el id y el UPN del informe*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el correo electrónico del informe mediante Send-RjRbReportEmail cuando SendMail está habilitado y EmailTo está configurado*

### Parámetros

#### Nombre de usuario

Nombre principal de usuario del usuario sobre el que actúa el runbook. Lo establece el portal a partir del usuario seleccionado.

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

#### Tipo de grupo

Solo grupos de seguridad, solo grupos de Microsoft 365, o todos los grupos.

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

#### Tipo de membresía

Membresías asignadas, membresías dinámicas o todas.

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

#### Asignable a roles

Sí limita la lista a los grupos a los que se pueden asignar roles de Entra ID.

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

#### Teams habilitado

Sí limita la lista a los grupos que respaldan un equipo de Microsoft Teams.

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

#### Fuente

Grupos solo en la nube, grupos sincronizados desde Active Directory local o todos.

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

#### Writeback habilitado

Grupos con writeback a Active Directory local, grupos sin writeback o todos.

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

#### SendMail

Envía el informe a la dirección de correo electrónico del destinatario. Se establece desde la opción "Entrega del informe" en el portal.

| 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. Separe varias con comas; cada destinatario recibe un correo electrónico aparte. Obligatorio cuando "Entrega del informe" incluye 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        |
| 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. Se muestra cuando "Entrega del informe" incluye un correo electrónico o un enlace de descarga.

| 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 carga el informe y devuelve un enlace de descarga que caduca después de unos días. Se establece desde la opción "Entrega del informe" en el portal.

| 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 | user-group-memberships                                      |
| 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/user/general/list-group-memberships.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.
