Rapport planifié d'attribution des licences

Alerter lorsque la disponibilité des licences franchit les seuils

Il s'agit d'un runbook planifié. Il est conçu pour s'exécuter selon une planification récurrente plutôt que d'être déclenché pour un objet unique. Voir Planification pour plus de détails sur la configuration des planifications du runbook.

Description

Vérifie combien de licences des SKU configurés sont encore disponibles. Lorsqu'un nombre descend en dessous d'un seuil minimum ou dépasse un seuil maximum, les SKU concernés sont signalés afin que vous puissiez acheter ou récupérer des licences à temps. Le rapport peut être envoyé par e-mail ou fourni sous forme de lien de téléchargement.

Configuration de licence

Les SKU à vérifier et leurs seuils sont prédéfinis dans la personnalisation du runbook sous forme du champ masqué InputJson valeur. Chaque configuration de licence nécessite :

SKUPartNumber (obligatoire) : identifiant de SKU Microsoft
FriendlyName (obligatoire) : nom d'affichage
MinThreshold (facultatif) : alerte lorsque les licences disponibles < seuil
MaxThreshold (facultatif) : 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 ruptures de stock) :

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

Seuil maximum uniquement (prévenir le surprovisionnement) :

[
    {
        "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": "sender@contoso.com"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "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
                        }
                    ]
                }
            }
        }
    }
}

Voir la Guide de personnalisation des runbooks pour la syntaxe.

Recherche des références SKU

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

SKU courants :

ENTERPRISEPACK - Microsoft 365 E3
ENTERPRISEPREMIUM - Microsoft 365 E5
EMS - Enterprise Mobility + Security E3

Résultats

Chaque exécution écrit ses résultats dans l'onglet Données de sortie du portail RealmJoin : un résumé, les licences en dehors de leurs seuils, les SKU configurés qui n'existent pas dans le locataire et les licences dans leurs seuils. Chaque tableau peut y être exporté vers Excel.

Lorsqu'il y a des violations : les fichiers du rapport (CSV et/ou classeur Excel) répertorient les licences en dehors de leurs seuils, et l'e-mail contient le résumé, les violations, les recommandations et les fichiers en pièces jointes.
Lorsqu'un SKU configuré n'est pas trouvé : l'e-mail répertorie le SKU comme un problème de configuration.
Lorsque toutes les licences sont dans leurs seuils : aucun e-mail n'est envoyé, aucun fichier de rapport n'est créé et l'exécution se termine avec succès.

Livraison du rapport

Les fichiers du rapport ne sont générés que lorsqu’une méthode de livraison est sélectionnée via l’ Livraison du rapport option (e-mail et/ou lien de téléchargement) et au moins une licence est en dehors de ses seuils. Avec Données de sortie uniquement Une fois sélectionné, les résultats sont lus directement dans l'onglet Données de sortie du portail RealmJoin, où chaque tableau peut également être exporté vers Excel. L'envoi par e-mail et la génération de lien de téléchargement sont indépendants et peuvent être combinés.

Pour le lien de téléchargement, les fichiers du rapport sont téléversés vers le Storage Account Azure configuré dans les RJReport.StorageAccount.* paramètres du Tenant, et des liens de téléchargement SAS à durée limitée sont renvoyés. Le téléversement vers le stockage s’authentifie avec l’identité managée du compte Automation ; cette identité a besoin du Storage Account Contributor rôle RBAC sur le Storage Account cible (il s’agit d’une attribution Azure RBAC, et non d’une autorisation d’application Graph).

Les planifications créées avant l’ Livraison du rapport option existait continuent d’envoyer leur e-mail : un destinataire enregistré suffit toujours à activer l’e-mail pour eux. Lorsqu’une telle planification est ouverte pour modification, l’option affiche Données de sortie uniquement; sélectionnez de nouveau la livraison avant d’enregistrer, sinon la planification cesse d’envoyer le rapport.

Configuration de l’envoi d’e-mails

L’envoi du rapport par e-mail est facultatif et ne se produit que lorsque Envoyer aussi le rapport par e-mail ou Envoyer aussi par e-mail et lien de téléchargement est sélectionné comme mode de livraison du rapport ; un destinataire est alors requis. L’adresse de l’expéditeur est reprise de RJReport.EmailSender paramètre du tenant.

Ce runbook envoie des e-mails à l’aide de 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.

Voir la documentation des paramètres de rapport RealmJoin pour plus de détails sur tous les paramètres disponibles.

Identité visuelle des e-mails

L’e-mail du rapport prend en compte le paramètre facultatif RJReport.Branding.* des paramètres du tenant :

Image d’en-tête et de pied de page - URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune
Lien de pied de page - cible de l’image de pied de page
Couleur d’accentuation et du texte - valeurs hexadécimales à 6 chiffres, p. ex. #0052cc

Lorsque ces paramètres ne sont pas configurés, les graphiques et couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur non valide, n’empêche jamais l’e-mail du rapport — la valeur par défaut correspondante est utilisée à la place.

Instructions de configuration et exigences relatives aux images : Identité visuelle des e-mails.

Dépannage

SKU introuvable: Vérifiez que le SKU existe à l'aide de Get-MgSubscribedSku.

E-mail non envoyé: Vérifiez le RJReport.EmailSender paramètre et l'autorisation Mail.Send de l'identité managée. Aucun e-mail n'est envoyé lorsque toutes les licences sont dans leurs seuils.

JSON non valide: Validez le format JSON avant de le configurer.

Note de migration

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

Emplacement

Organisation → Général → Rapport d'attribution des licences (planifié)

Nom complet du runbook

rjgit-org_general_report-license-assignment_scheduled

Détails

Propriété

Valeur

Version

1.4.0

Modules requis

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)

Planifiable

oui

Autorisations

Autorisations d’application

Type: Microsoft Graph
- Organization.Read.All
  - Lit /organization et /subscribedSkus pour évaluer les comptes de licences par rapport aux seuils
- Mail.Send (facultatif — fonctionnalité : rapport par e-mail)
  - Envoie l'e-mail du rapport de seuil via Send-RjRbReportEmail lorsque la livraison par e-mail est sélectionnée

Notes sur les autorisations

Azure Storage Account : rôle 'Storage Account Contributor' pour l’identité managée du compte Automation sur le Storage Account cible - le téléversement récupère les clés du compte via listKeys (uniquement requis pour les options de lien de téléchargement)

Paramètres

InputJson

Liste de SKU avec noms conviviaux et seuils minimum et maximum, sous forme de tableau JSON. Prédéfinie dans la personnalisation du runbook.

Propriété

Valeur

Obligatoire

vrai

Valeur par défaut

Type

Objet

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

ReportFileFormat

Remettez le rapport au format CSV, sous forme de classeur Excel, ou les deux.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

CSV et XLSX

Type

Chaîne

Nom d’affichage du portail

Format du fichier de rapport

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Options du portail

Option du portail

Valeur

CSV et XLSX

CSV uniquement

XLSX uniquement

CreateDownloadLink

Télécharge aussi le rapport et renvoie un lien de téléchargement qui expire après quelques jours.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Nom du conteneur

Conteneur de stockage dans lequel les fichiers du rapport sont téléversés. À définir pour chaque runbook.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

report-license-assignment

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Nom du groupe de ressources

Groupe de ressources du Storage Account pour les téléversements de rapports. Pris à partir du paramètre Tenant RJReport.StorageAccount.ResourceGroup.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Nom du Storage Account

Storage Account pour les téléversements de rapports. Pris à partir du paramètre Tenant RJReport.StorageAccount.StorageAccountName.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

LinkExpiryDays

Nombre de jours pendant lesquels un lien de téléchargement reste valide. Pris à partir du paramètre Tenant RJReport.StorageAccount.LinkExpiryDays.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Int32

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

SendEmailReport

Envoie le rapport à l’adresse e-mail du destinataire.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

EmailTo

Envoyez le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail séparé.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Nom d’affichage du portail

Adresse(s) e-mail du destinataire

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

EmailFrom

Adresse d’expédition de l’e-mail du rapport. Récupérée à partir du paramètre du tenant RJReport.EmailSender.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingHeaderImageUrl

Image d’en-tête de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Récupérée à partir du paramètre du tenant RJReport.Branding.HeaderImageUrl ; l’en-tête RealmJoin par défaut est utilisé si vide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingFooterImageUrl

Image de pied de page de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Récupérée à partir du paramètre du tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé si vide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingFooterLink

Lien derrière l’image de pied de page de l’e-mail du rapport. Récupéré à partir du paramètre du tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé si vide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingAccentColor

Couleur d’accentuation de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Récupérée à partir du paramètre du tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingTextColor

Couleur du texte de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Récupérée à partir du paramètre du tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

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

Mis à jour il y a 7 jours

Ce contenu vous a-t-il été utile ?