Informe programado de asignación de licencias

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

Descripción

Este runbook comprueba la disponibilidad de licencias según los SKU transmitidos y envía un informe por correo electrónico si se alcanza alguno de los 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 correo electrónico

Enviar un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (Correo electrónico del destinatario) se proporciona. La dirección del remitente se toma de la RJReport.EmailSender configuración de Tenant.

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

Consulte la documentación de configuración de informes de RealmJoin para más detalles.

Configuración de 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 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": {
                "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
                }
            }
        }
    }
}

Búsqueda de 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

Salida

Cuando se detectan infracciones:

• Salida de consola en el registro del trabajo
• Exportación CSV (License_Threshold_Violations.csv)
• Informe por correo electrónico con resumen, infracciones, recomendaciones y archivo adjunto CSV

Cuando todo está dentro de los umbrales:

• No se envía ningún correo electrónico
• El trabajo se completa correctamente

Solución de problemas

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

Correo electrónico no enviado: Compruebe la configuración de EmailFrom y el permiso Mail.Send

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

Nota de migración

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

Ubicación

Organization → General → Asignación de licencias de informe (Programada)

Nombre completo del runbook

rjgit-org_general_report-license-assignment_scheduled

Permisos

Permisos de 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 un SKUPartNumber para el 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 deben estar disponibles y un MaxThreshold opcional que especifica el número máximo de licencias que deben estar disponibles.

Esto debe configurarse en la personalización del runbook

Propiedad	Valor
Requerido	verdadero
Valor predeterminado
Tipo	Objeto

Correo electrónico del destinatario

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

Propiedad	Valor
Requerido	verdadero
Valor predeterminado
Tipo	Cadena

Correo electrónico del remitente

Dirección de correo electrónico del remitente resuelta a partir de la configuración.

Propiedad	Valor
Requerido	falso
Valor predeterminado
Tipo	Cadena

Volver a la vista general de la referencia del runbook