For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 por tipo de grupo, tipo de membresía, asignabilidad de roles, Teams, origen y writeback. El resultado se muestra como texto CSV. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.

Configuración relacionada con el envío de correo electrónico

Enviar un informe por correo electrónico es opcional y solo ocurre cuando la SendMail opción está habilitada; entonces se requiere un destinatario (EmailTo) es entonces obligatorio. 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 mediante la API de Graph, 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 para obtener detalles sobre todas las configuraciones disponibles.

Branding del correo electrónico

El correo electrónico del informe respeta las opciones opcionales RJReport.Branding.* de configuración del tenant:

  • Imagen de encabezado y pie de página – URL públicas HTTPS, 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 texto – valores hexadecimales de 6 dígitos, p. ej. #0052cc

Cuando estas configuraciones no están definidas, se usan las imágenes y colores predeterminados de RealmJoin. Una imagen que no se pueda descargar o validar, o un valor de color no válido, nunca impide el correo electrónico del informe: se utiliza en su lugar el valor predeterminado correspondiente.

Instrucciones de configuración y requisitos de imagen: Branding del correo electrónico.

Ubicación

Usuario → General → Listar membresías de grupos

Nombre completo del runbook

rjgit-user_general_list-group-memberships

Detalles

Propiedad
Valor

Versión

1.7.0

Módulos requeridos

RealmJoin.RunbookHelper (>= 0.8.9) Az.Accounts (>= 5.5.2)

Programable

no

Permisos

Permisos de aplicación

  • Tipo: Microsoft Graph

    • User.Read.All

      • Resuelve el usuario de destino para obtener el id y el UPN del informe

    • Group.Read.All

      • Lee los grupos del usuario mediante /users/{id}/memberOf, incluidas las reglas de membresía para filtrar

    • Mail.Send (opcional — característica: informe por correo electrónico)

      • Envía el correo del informe mediante Send-RjReportEmail cuando SendMail está habilitado y EmailTo está configurado

    • Organization.Read.All

      • Lee /organization para obtener el nombre para mostrar del tenant en el informe por correo electrónico

Parámetros

UserName

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

Propiedad
Valor

Requerido

verdadero

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

GroupType

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

Propiedad
Valor

Requerido

falso

Valor predeterminado

Todas

Tipo

Cadena

MembershipType

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

Propiedad
Valor

Requerido

falso

Valor predeterminado

Todas

Tipo

Cadena

RoleAssignable

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

Propiedad
Valor

Requerido

falso

Valor predeterminado

No establecido

Tipo

Cadena

TeamsEnabled

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

Propiedad
Valor

Requerido

falso

Valor predeterminado

No establecido

Tipo

Cadena

Origen

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

Propiedad
Valor

Requerido

falso

Valor predeterminado

Todas

Tipo

Cadena

WritebackEnabled

Grupos con writeback en Active Directory local, grupos sin él o todos.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Todas

Tipo

Cadena

SendMail

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

Propiedad
Valor

Requerido

falso

Valor predeterminado

Falso

Tipo

Booleano

Nombre para mostrar en el portal

¿Enviar el informe por correo electrónico?

Opciones del portal

Opción del portal
Valor

Sí - enviar el informe por correo electrónico

verdadero

No - no enviar un correo electrónico

falso

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 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. Tomada de la configuración del tenant RJReport.EmailSender.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido 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). Tomada de la configuración del tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacía.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido 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). Tomada 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

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

Enlace detrás de la imagen de pie de página del correo electrónico del informe. Tomada de la configuración del tenant RJReport.Branding.FooterLink; se usa realmjoin.com cuando está vacío.

Propiedad
Valor

Requerido

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 hexagonal de 6 dígitos. Tomada de la configuración del tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o no es válido.

Propiedad
Valor

Requerido

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 hexagonal de 6 dígitos. Tomada de la configuración del tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o no es válido.

Propiedad
Valor

Requerido

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

Requerido

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

También carga el informe y devuelve un enlace de descarga que caduca después de unos días.

Propiedad
Valor

Requerido

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í: cargar el informe y devolver un enlace de descarga

verdadero

No: no crear un enlace de descarga

falso

ContainerName

Contenedor de almacenamiento al que se cargan los archivos del informe. Configurar por runbook.

Propiedad
Valor

Requerido

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 Storage Account para las cargas del informe. Tomado de la configuración Tenant RJReport.StorageAccount.ResourceGroup.

Propiedad
Valor

Requerido

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 Tenant RJReport.StorageAccount.StorageAccountName.

Propiedad
Valor

Requerido

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 Tenant RJReport.StorageAccount.LinkExpiryDays.

Propiedad
Valor

Requerido

falso

Valor predeterminado

6

Tipo

Int32

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

Última actualización

¿Te fue útil?