Enumerar propiedad de grupos
Enumerar la propiedad de grupos de este usuario.
Descripción
Enumera los grupos de Entra ID de los que el usuario especificado es propietario. Devuelve los nombres y los IDs de los grupos. El parámetro ReportFileFormat controla qué formatos de archivo se generan y se entregan (solo CSV, CSV y XLSX, o solo XLSX). Cuando el adjunto CSV supera el límite de tamaño del correo electrónico y se selecciona "CSV & XLSX", el correo electrónico recurre solo al libro de Excel.
Configuración relativa al envío de correos electrónicos
Enviar 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 RJReport.EmailSender configuración del tenant.
Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos mediante Graph API, necesitas 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.
Marca del correo electrónico
El correo electrónico del informe respeta las configuraciones opcionales 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, por ejemplo
#0052cc
Cuando estas configuraciones no están definidas, se usan los gráficos 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; en su lugar, se usa el valor predeterminado correspondiente.
Instrucciones de configuración y requisitos de imagen: Marca del correo electrónico.
Ubicación
Usuario → General → Listar propiedad de grupos
Nombre completo del runbook
rjgit-user_general_list-group-ownerships
Detalles
Versión
1.4.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 id y el UPN del usuario de destino antes de enumerar los grupos de los que es propietario
Group.Read.All
Lee /users/{id}/ownedObjects para informar de cada grupo del que es propietario
Mail.Send (opcional — característica: informe por correo electrónico)
Envía el informe de propiedad mediante Send-RjReportEmail cuando SendMail está habilitado
Organization.Read.All
Lee /organization para el nombre del Tenant en el informe por correo electrónico
Parámetros
UserName
Nombre principal de usuario del usuario de destino.
Obligatorio
true
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
SendMail
Si está habilitado, los archivos del informe (CSV y Excel) se cargan en una Storage Account de Azure y se devuelven en la salida enlaces de descarga con tiempo limitado.
Obligatorio
false
Valor predeterminado
Falso
Tipo
Booleano
Nombre mostrado en el portal
¿Enviar el informe por correo electrónico?
Opciones del portal
Sí - enviar el informe por correo electrónico
No - no enviar un correo electrónico
EmailTo
Dirección del destinatario o múltiples direcciones separadas por comas para el informe por correo electrónico. Solo se usa cuando SendMail está habilitado.
Obligatorio
false
Valor predeterminado
Tipo
String
Nombre mostrado en el portal
Dirección(es) de correo electrónico del destinatario
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
EmailFrom
La dirección de correo electrónico del remitente. Esto debe configurarse en la personalización del runbook.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingHeaderImageUrl
URL HTTPS pública opcional de una imagen de encabezado personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.HeaderImageUrl. Cuando está vacía, se usa el gráfico de encabezado predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingFooterImageUrl
URL HTTPS pública opcional de una imagen de pie de página personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.FooterImageUrl. Cuando está vacía, se usa el gráfico de pie de página predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingFooterLink
URL opcional a la que enlaza la imagen del pie de página. Se obtiene de la configuración del tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado (https://www.realmjoin.com).
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingAccentColor
Anulación opcional del color de acento (hexadecimal de 6 dígitos, por ejemplo '#0052cc') para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.AccentColor. Cuando está vacío o no es válido, se usa el color de acento predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
BrandingTextColor
Anulación opcional del color de texto (hexadecimal de 6 dígitos) para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.TextColor. Cuando está vacío o no es válido, se usa el color de texto predeterminado de RealmJoin.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
ReportFileFormat
Controla qué formatos de archivo del informe se generan y entregan: "solo CSV", "CSV & XLSX" (predeterminado) o "solo XLSX".
Obligatorio
false
Valor predeterminado
CSV & XLSX
Tipo
String
Nombre mostrado en el portal
Formato de archivo del informe
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
Opciones del portal
CSV & XLSX
solo CSV
solo XLSX
CreateDownloadLink
Si está habilitado, los archivos del informe (CSV y Excel) se cargan en una Storage Account de Azure y se devuelven en la salida enlaces de descarga con tiempo limitado.
Obligatorio
false
Valor predeterminado
Falso
Tipo
Booleano
Nombre mostrado en el portal
¿Crear un enlace de descarga de archivo (subir el informe al almacenamiento)?
Opciones del portal
Sí: subir el informe y devolver un enlace de descarga
No: no crear un enlace de descarga
ContainerName
Nombre del contenedor de almacenamiento usado para la carga.
Obligatorio
false
Valor predeterminado
user-group-ownerandmemberships
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
ResourceGroupName
Grupo de recursos que contiene la Storage Account.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
StorageAccountName
Nombre de la Storage Account usado para la carga.
Obligatorio
false
Valor predeterminado
Tipo
String
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
LinkExpiryDays
Número de días hasta que expira el enlace de descarga generado.
Obligatorio
false
Valor predeterminado
6
Tipo
Int32
Oculto en el portal
sí (preconfigurado mediante la personalización del runbook)
Última actualización
¿Te fue útil?