Informe programado de asignación de licencias

Alertar cuando la disponibilidad de licencias cruce los umbrales

Este es un runbook programado. Está diseñado para ejecutarse de forma recurrente en lugar de activarse para un único objeto. Consulte Programación para obtener detalles sobre cómo configurar las programaciones de runbook.

Descripción

Comprueba cuántas licencias de los SKU configurados siguen disponibles. Cuando un recuento cae por debajo de un umbral mínimo o supera un umbral máximo, los SKU afectados se notifican para que puedas comprar o recuperar licencias a tiempo. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.

Configuración de licencias

Los SKU que se van a comprobar y sus umbrales están preconfigurados en la personalización del runbook como el oculto InputJson valor. Cada configuración de licencia requiere:

• SKUPartNumber (obligatorio): identificador de SKU de Microsoft
• FriendlyName (obligatorio): nombre para mostrar
• MinThreshold (opcional): alertar cuando las licencias disponibles < umbral
• MaxThreshold (opcional): alertar cuando las licencias disponibles > umbral

Al menos un umbral debe configurarse por licencia.

Ejemplos de configuración

Solo umbral mínimo (evitar faltantes):

[
    {
        "SKUPartNumber": "ENTERPRISEPACK",
        "FriendlyName": "Microsoft 365 E3",
        "MinThreshold": 50
    }
]

Solo umbral máximo (evitar sobreaprovisionamiento):

[
    {
        "SKUPartNumber": "POWER_BI_PRO",
        "FriendlyName": "Power BI Pro",
        "MaxThreshold": 500
    }
]

Ambos umbrales (mantener el rango):

[
    {
        "SKUPartNumber": "ENTERPRISEPREMIUM",
        "FriendlyName": "Microsoft 365 E5",
        "MinThreshold": 50,
        "MaxThreshold": 150
    }
]

Personalización completa del runbook

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[e-mail]"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "InputJson": {
                    "Hide": true,
                    "DefaultValue": [
                        {
                            "SKUPartNumber": "SPE_E5",
                            "FriendlyName": "Microsoft 365 E5",
                            "MinThreshold": 20,
                            "MaxThreshold": 30
                        },
                        {
                            "SKUPartNumber": "FLOW_FREE",
                            "FriendlyName": "Microsoft Power Automate Free",
                            "MinThreshold": 10
                        }
                    ]
                }
            }
        }
    }
}

Consulta la Guía de personalización de runbooks para la sintaxis.

Encontrar números de parte de SKU

Connect-MgGraph -Scopes "Organization.Read.All"
Get-MgSubscribedSku | Select-Object SkuPartNumber, SkuId | Sort-Object SkuPartNumber

SKU comunes:

• ENTERPRISEPACK - Microsoft 365 E3
• ENTERPRISEPREMIUM - Microsoft 365 E5
• EMS - Enterprise Mobility + Security E3

Resultados

Cada ejecución escribe sus resultados en la pestaña Datos de salida del portal RealmJoin: un resumen, las licencias fuera de sus umbrales, los SKU configurados que no existen en el Tenant y las licencias dentro de sus umbrales. Cada tabla puede exportarse allí a Excel.

• Cuando se detectan infracciones: los archivos del informe (CSV y/o libro de Excel) enumeran las licencias fuera de sus umbrales, y el correo electrónico contiene el resumen, las infracciones, las recomendaciones y los archivos como adjuntos.
• Cuando no se encuentra un SKU configurado: el correo electrónico enumera el SKU como un problema de configuración.
• Cuando todas las licencias están dentro de sus umbrales: no se envía ningún correo electrónico, no se crea ningún archivo de informe y la ejecución finaliza correctamente.

Entrega del informe

Los archivos del informe solo se generan cuando se selecciona un método de entrega mediante la Entrega del informe opción (correo electrónico y/o enlace de descarga) y al menos una licencia está fuera de sus umbrales. Con solo Output Data si está seleccionado, los resultados se leen directamente en la pestaña Output Data del portal RealmJoin, donde cada tabla también se puede exportar a Excel. La entrega por correo electrónico y la generación del enlace de descarga son independientes y se pueden combinar.

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 Storage Account Contributor rol RBAC en la Storage Account de destino (esto es una asignación de Azure RBAC, no un permiso de aplicación de Graph).

Las programaciones que se crearon antes de la Entrega del informe opción existía siguen enviando su correo electrónico: un destinatario almacenado por sí solo aún les habilita el correo electrónico. Cuando una programación de este tipo se abre para edición, la opción muestra solo Output Data; 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 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 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 - 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 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: Branding del correo electrónico.

Solución de problemas

SKU no encontrado: Verifique que el SKU exista usando Get-MgSubscribedSku.

Correo electrónico no enviado: Revise la RJReport.EmailSender configuración y el permiso Mail.Send de la identidad administrada. No se envía ningún correo electrónico cuando todas las licencias están dentro de sus umbrales.

JSON no válido: Valide el formato JSON antes de configurarlo.

Nota de migración

Heredado WarningThreshold se asigna automáticamente a MinThreshold - las configuraciones antiguas siguen funcionando.

Ubicación

Organización → General → Informe de asignación de licencias (programado)

Nombre completo del runbook

rjgit-org_general_report-license-assignment_scheduled

Detalles

Propiedad	Valor
Versión	1.4.0
Módulos requeridos	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)
Programable	sí

Permisos

Permisos de aplicación

• Tipo: Microsoft Graph

  • Organization.Read.All

    • Lee /organization y /subscribedSkus para evaluar los recuentos de licencias frente a los umbrales
  • Mail.Send (opcional — característica: informe por correo electrónico)

    • Envía el correo electrónico del informe de umbrales mediante Send-RjRbReportEmail cuando se selecciona la entrega por correo electrónico

Notas de permisos

Azure Storage Account: rol 'Storage Account Contributor' para la identidad administrada de la cuenta de Automation 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

InputJson

Lista de SKU con nombres descriptivos y umbrales mínimo y máximo, como un arreglo JSON. Preconfigurada en la personalización del runbook.

Propiedad	Valor
Requerido	verdadero
Valor predeterminado
Tipo	Objeto
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

CreateDownloadLink

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
Oculto en el portal	sí (preestablecido mediante la personalización del runbook)

ContainerName

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

Propiedad	Valor
Requerido	falso
Valor predeterminado	report-license-assignment
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)

SendEmailReport

Envía 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í (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 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)

BrandingFooterLink

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)

Volver a la vista general de la referencia del runbook