Rapport d'affectation des licences planifié

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

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 minimal, qui déclenche une alerte lorsque le nombre de licences disponibles tombe en dessous d’un nombre spécifié. Le deuxième type est un seuil maximal, 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 hors des seuils configurés, les exporte en 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 (requis) : identifiant SKU Microsoft

• FriendlyName (requis) : nom affiché

• 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 référence 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

Sortie

Lorsqu’une violation est détectée :

• 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 introuvable : 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 mappe automatiquement à MinThreshold - les anciennes configurations continuent de fonctionner.

Emplacement

Organisation → Général → Report License Assignment_Scheduled

Autorisations

Autorisations de l’application

• Type: Microsoft Graph

  • Organization.Read.All

  • User.Read.All

  • Mail.Send

Paramètres

InputJson

Tableau JSON contenant des configurations de SKU avec seuils. Chaque entrée doit inclure :

• SKUPartNumber : L’identifiant SKU Microsoft

• FriendlyName : Nom affiché pour la licence

• MinThreshold : (Optionnel) Nombre minimum de licences devant être disponibles

• MaxThreshold : (Optionnel) Nombre maximum de licences devant être disponibles

Cela doit être configuré dans la personnalisation du runbook

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

EmailTo

Peut être une adresse unique ou plusieurs adresses séparées par des virgules (chaîne). La fonction envoie des e-mails individuels à chaque destinataire pour des raisons de confidentialité.

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

EmailFrom

L'adresse e-mail de l'expéditeur. Celle-ci doit être configurée dans la personnalisation du runbook

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

Retour à la vue d’ensemble de la référence du runbook