Informe de asignación de licencias programado

Generar y enviar por correo un informe de disponibilidad de licencias basado en umbrales

Descripción

Este runbook verifica la disponibilidad de licencias según los SKUs transmitidos y envía un informe por correo electrónico si se alcanzan algunos umbrales. Se pueden configurar dos tipos de umbrales. El primer tipo es un umbral mínimo, que provoca una alerta cuando el número de licencias disponibles cae por debajo de un número especificado. El segundo tipo es un umbral máximo, que provoca una alerta cuando el número de licencias disponibles supera un número especificado. El informe incluye información detallada sobre las licencias que están fuera de los umbrales configurados, las exporta a archivos CSV y las envía por correo electrónico.

Personalización del Runbook

Configuración relacionada con el envío de correos electrónicos

Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos mediante la API Graph, debe configurar una dirección de correo existente en la personalización del runbook.

Este proceso se describe en detalle en el Configuración de informes por correo electrónico documentación.

Configuración InputJson

Cada configuración de licencia requiere:

• SKUPartNumber (obligatorio): identificador de SKU de Microsoft

• FriendlyName (obligatorio): nombre para mostrar

• MinThreshold (opcional): Alerta cuando las licencias disponibles < umbral

• MaxThreshold (opcional): Alerta cuando las licencias disponibles > umbral

Debe establecerse al menos un umbral por licencia.

Ejemplos de configuración

Solo umbral mínimo (evitar escasez):

[
    {
        "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 rango):

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

Personalización completa del Runbook

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "EmailTo": {
                    "DisplayName": "Dirección(es) de correo electrónico del destinatario"
                },
                "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
                        }
                    ]
                },
                "EmailFrom": {
                    "Hide": true
                },
                "CallerName": {
                    "Hide": true
                }
            }
        }
    }
}

Encontrar números de pieza SKU

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

SKUs comunes:

• ENTERPRISEPACK - Microsoft 365 E3

• ENTERPRISEPREMIUM - Microsoft 365 E5

• EMS - Enterprise Mobility + Security E3

Salida

Cuando se detectan violaciones:

• Salida por consola en el registro del trabajo

• Exportación CSV (License_Threshold_Violations.csv)

• Informe por correo electrónico con resumen, violaciones, recomendaciones y archivo CSV adjunto

Cuando todo está dentro de los umbrales:

• No se envía correo electrónico

• El trabajo se completa con éxito

Resolución de problemas

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

Correo no enviado: Verifique la configuración EmailFrom y el permiso Mail.Send

JSON no válido: Valide el formato JSON antes de la configuración

Nota de migración

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

Ubicación

Organización → General → Reportar asignación de licencias (Programado)

Nombre completo del Runbook

rjgit-org_general_report-license-assignment_scheduled

Permisos

Permisos de la aplicación

• Tipo: Microsoft Graph

  • Organization.Read.All

  • User.Read.All

  • Mail.Send

Parámetros

InputJson

Array JSON que contiene configuraciones de SKU con umbrales. Cada entrada debe incluir un SKUPartNumber como identificador de SKU de Microsoft, un FriendlyName como nombre para mostrar de la licencia, un MinThreshold opcional que especifica el número mínimo de licencias que deberían estar disponibles y un MaxThreshold opcional que especifica el número máximo de licencias que deberían estar disponibles.

Esto debe configurarse en la personalización del runbook

Propiedad	Valor
Requerido	true
Valor predeterminado
Tipo	Objeto

EmailPara

Dirección de correo electrónico del destinatario o lista de destinatarios separada por comas.

Propiedad	Valor
Requerido	true
Valor predeterminado
Tipo	Cadena

EmailDe

Dirección de correo del remitente resuelta desde la configuración.

Propiedad	Valor
Requerido	false
Valor predeterminado
Tipo	Cadena

Volver al resumen de referencia del Runbook