Rapport d'affectation de licence (planifié)

Générer et envoyer par e-mail un rapport de disponibilité des licences basé sur des seuils

Description

Ce runbook vérifie la disponibilité des licences en fonction des SKUs transmis et envoie un rapport par e-mail si des seuils sont atteints. Deux types de seuils peuvent être configurés. Le premier type est un seuil minimum, qui déclenche une alerte lorsque le nombre de licences disponibles tombe en dessous d’un nombre spécifié. Le second type est un seuil maximum, qui déclenche une alerte lorsque le nombre de licences disponibles dépasse un nombre spécifié. Le rapport inclut des informations détaillées sur les licences qui sont en dehors des seuils configurés, les exporte dans des fichiers CSV et les envoie par e-mail.

Personnalisation du runbook

Configuration concernant l'envoi d'e-mails

Ce runbook envoie des e-mails en utilisant l'API Microsoft Graph. Pour envoyer des e-mails via l'API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Ce processus est décrit en détail dans le Configuration du rapport par e-mail documentation.

Configuration InputJson

Chaque configuration de licence nécessite :

• SKUPartNumber (obligatoire) : identifiant SKU Microsoft

• FriendlyName (obligatoire) : nom d’affichage

• MinThreshold (optionnel) : Alerte lorsque les licences disponibles < seuil

• MaxThreshold (optionnel) : Alerte lorsque les licences disponibles > seuil

Au moins un seuil doit être défini par licence.

Exemples de configuration

Seuil minimum uniquement (prévenir les pénuries) :

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

Seuil maximum uniquement (prévenir la sur-allocation) :

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

Les deux seuils (maintenir la plage) :

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

Personnalisation complète du runbook

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "EmailTo": {
                    "DisplayName": "Adresse(s) e-mail du destinataire"
                },
                "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
                }
            }
        }
    }
}

Recherche des numéros de pièce SKU

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

SKUs courants :

• ENTERPRISEPACK - Microsoft 365 E3

• ENTERPRISEPREMIUM - Microsoft 365 E5

• EMS - Enterprise Mobility + Security E3

Résultat

Lorsqu des violations sont détectées :

• Sortie console dans le journal du travail

• Export CSV (License_Threshold_Violations.csv)

• Rapport par e-mail avec résumé, violations, recommandations et pièce jointe CSV

Lorsque tout est dans les seuils :

• Aucun e-mail envoyé

• Le travail se termine avec succès

Dépannage

SKU non trouvé : Vérifier que le SKU existe en utilisant Get-MgSubscribedSku

E-mail non envoyé : Vérifier la configuration EmailFrom et l’autorisation Mail.Send

JSON invalide : Valider le format JSON avant la configuration

Note de migration

Hérité WarningThreshold se cartographie automatiquement à MinThreshold - les anciennes configurations continuent de fonctionner.

Emplacement

Organisation → Général → Rapport d’attribution de licences (Planifié)

Nom complet du runbook

rjgit-org_general_report-license-assignment_scheduled

Autorisations

Autorisations d’application

• Type: Microsoft Graph

  • Organization.Read.All

  • User.Read.All

  • Mail.Send

Paramètres

InputJson

Tableau JSON contenant les configurations de SKU avec seuils. Chaque entrée doit inclure un SKUPartNumber pour l’identifiant SKU Microsoft, un FriendlyName comme nom d’affichage pour la licence, un MinThreshold optionnel spécifiant le nombre minimum de licences qui devraient être disponibles, et un MaxThreshold optionnel spécifiant le nombre maximum de licences qui devraient être disponibles.

Ceci doit être configuré dans la personnalisation du runbook

Propriété	Valeur
Requis	true
Valeur par défaut
Type	Objet

EmailTo

Adresse e-mail du destinataire ou liste de destinataires séparés par des virgules.

Propriété	Valeur
Requis	true
Valeur par défaut
Type	Chaîne

EmailFrom

Adresse e-mail de l’expéditeur résolue à partir des paramètres.

Propriété	Valeur
Requis	false
Valeur par défaut
Type	Chaîne

Retour à l’aperçu de la référence des runbooks