Geplanter Bericht zur Lizenzzuweisung

Erstellt und sendet per E-Mail einen Bericht über die Lizenzverfügbarkeit basierend auf konfigurierten Schwellenwerten

Beschreibung

Dieses Runbook prüft die Verfügbarkeit von Lizenzen basierend auf den übermittelten SKUs und sendet einen E-Mail-Bericht, wenn Schwellenwerte erreicht werden. Zwei Arten von Schwellenwerten können konfiguriert werden. Der erste Typ ist ein Mindestschwellenwert, der eine Warnung auslöst, wenn die Anzahl verfügbarer Lizenzen unter einen angegebenen Wert fällt. Der zweite Typ ist ein Maximalschwellenwert, der eine Warnung auslöst, wenn die Anzahl verfügbarer Lizenzen einen angegebenen Wert überschreitet. Der Bericht enthält detaillierte Informationen über Lizenzen, die außerhalb der konfigurierten Schwellenwerte liegen, exportiert diese in CSV-Dateien und sendet sie per E-Mail.

Runbook-Anpassung

Einrichtung bezüglich des E-Mail-Versands

Dieses Runbook sendet E-Mails über die Microsoft Graph-API. Um E-Mails über die Graph-API zu senden, müssen Sie eine vorhandene E-Mail-Adresse in der Runbook-Anpassung konfigurieren.

Dieser Prozess wird ausführlich beschrieben in E-Mail-Berichterstattung einrichten Dokumentation.

InputJson-Konfiguration

Jede Lizenzkonfiguration erfordert:

• SKUPartNumber (erforderlich): Microsoft-SKU-Identifikator

• FriendlyName (erforderlich): Anzeigename

• MinThreshold (optional): Warnung, wenn verfügbare Lizenzen < Schwellenwert

• MaxThreshold (optional): Warnung, wenn verfügbare Lizenzen > Schwellenwert

Pro Lizenz muss mindestens ein Schwellenwert gesetzt werden.

Konfigurationsbeispiele

Nur Mindestschwellenwert (verhindert Engpässe):

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

Nur Maximalschwellenwert (verhindert Überprovisionierung):

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

Beide Schwellenwerte (Bereich beibehalten):

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

Vollständige Runbook-Anpassung

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]"
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Parameters": {
                "EmailTo": {
                    "DisplayName": "Empfänger-E-Mail-Adresse(n)"
                },
                "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
                }
            }
        }
    }
}

Ermittlung der SKU-Teilenummern

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

Gängige SKUs:

• ENTERPRISEPACK - Microsoft 365 E3

• ENTERPRISEPREMIUM - Microsoft 365 E5

• EMS - Enterprise Mobility + Security E3

Ausgabe

Wenn Verstöße festgestellt werden:

• Konsolenausgabe im Job-Protokoll

• CSV-Export (License_Threshold_Violations.csv)

• E-Mail-Bericht mit Zusammenfassung, Verstößen, Empfehlungen und CSV-Anhang

Wenn alle innerhalb der Schwellenwerte liegen:

• Keine E-Mail versendet

• Job wird erfolgreich abgeschlossen

Fehlerbehebung

SKU nicht gefunden: Überprüfen Sie, ob die SKU existiert, mit Get-MgSubscribedSku

E-Mail nicht gesendet: Überprüfen Sie die EmailFrom-Konfiguration und die Mail.Send-Berechtigung

Ungültiges JSON: Überprüfen Sie das JSON-Format vor der Konfiguration

Migrationshinweis

Legacy WarningThreshold wird automatisch abgebildet auf MinThreshold - alte Konfigurationen funktionieren weiterhin.

Ort

Organisation → Allgemein → Report License Assignment_Scheduled

Berechtigungen

Anwendungsberechtigungen

• Typ: Microsoft Graph

  • Organization.Read.All

  • User.Read.All

  • Mail.Send

Parameter

InputJson

JSON-Array, das SKU-Konfigurationen mit Schwellenwerten enthält. Jeder Eintrag sollte Folgendes enthalten:

• SKUPartNumber: Der Microsoft-SKU-Identifikator

• FriendlyName: Anzeigename für die Lizenz

• MinThreshold: (Optional) Minimale Anzahl an Lizenzen, die verfügbar sein sollten

• MaxThreshold: (Optional) Maximale Anzahl an Lizenzen, die verfügbar sein sollten

Dies muss in der Runbook-Anpassung konfiguriert werden

Eigenschaft	Wert
Erforderlich	true
Standardwert
Typ	Objekt

EmailTo

Kann eine einzelne Adresse oder mehrere durch Kommas getrennte Adressen sein (String). Die Funktion sendet aus Datenschutzgründen einzelne E-Mails an jeden Empfänger.

Eigenschaft	Wert
Erforderlich	true
Standardwert
Typ	Zeichenfolge

EmailFrom

Die Absender-E-Mail-Adresse. Diese muss in der Runbook-Anpassung konfiguriert werden

Eigenschaft	Wert
Erforderlich	falsch
Standardwert
Typ	Zeichenfolge

Zurück zur Runbook-Referenzübersicht