Informar asignación de licencias programado

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

Descripción

Este runbook verifica la disponibilidad de licencias en función de los SKUs transmitidos y envía un informe por correo electrónico si se alcanzan umbrales. Se pueden configurar dos tipos de umbrales. El primer tipo es un umbral mínimo, que activa 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 activa 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 utilizando la API de Microsoft Graph. Para enviar correos mediante la API de 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

Se debe establecer 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 parte de 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 de 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

Solución de problemas

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

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

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

Nota de migración

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

Ubicación

Organización → 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

Matriz JSON que contiene configuraciones de SKU con umbrales. Cada entrada debe incluir:

• SKUPartNumber: El identificador de SKU de Microsoft

• FriendlyName: Nombre para mostrar de la licencia

• MinThreshold: (Opcional) Número mínimo de licencias que deberían estar disponibles

• MaxThreshold: (Opcional) 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

EmailTo

Puede ser una sola dirección o varias direcciones separadas por comas (cadena). La función envía correos individuales a cada destinatario por motivos de privacidad.

Propiedad	Valor
Requerido	true
Valor predeterminado
Tipo	Cadena

EmailFrom

La dirección de correo del remitente. Esto debe configurarse en la personalización del runbook

Propiedad	Valor
Requerido	false
Valor predeterminado
Tipo	Cadena

Volver a la vista general de referencia del runbook