Bericht: Lizenzzuweisung (geplant)

Erstellt und versendet per E-Mail einen Lizenzverfügbarkeitsbericht basierend auf Schwellenwerten

Beschreibung

Dieses Runbook überprüft die Lizenzverfügbarkeit 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 eine bestimmte Zahl fällt. Der zweite Typ ist ein Höchstschwellenwert, der eine Warnung auslöst, wenn die Anzahl verfügbarer Lizenzen einen bestimmten 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 E-Mail-Versand

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 der Einrichtung der E-Mail-Berichterstattung Dokumentation.

InputJson-Konfiguration

Jede Lizenzkonfiguration erfordert:

• SKUPartNumber (erforderlich): Microsoft-SKU-Kennzeichen

• 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 sein.

Konfigurationsbeispiele

Nur Mindestschwellenwert (verhindert Engpässe):

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

Nur Höchstschwellenwert (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
                }
            }
        }
    }
}

SKUPartnummern finden

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 erkannt werden:

• Konsolenausgabe im Jobprotokoll

• CSV-Export (License_Threshold_Violations.csv)

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

Wenn alles innerhalb der Schwellenwerte liegt:

• Keine E-Mail versendet

• Job wird erfolgreich abgeschlossen

Fehlerbehebung

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

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

Ungültiges JSON: Validieren Sie das JSON-Format vor der Konfiguration

Migrationshinweis

Legacy WarningThreshold mappt automatisch zu MinThreshold - alte Konfigurationen funktionieren weiterhin.

Ort

Organisation → Allgemein → Bericht Lizenzzuweisung (geplant)

Vollständiger Runbook-Name

rjgit-org_general_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 eine SKUPartNumber für die Microsoft-SKU-Kennung, einen FriendlyName als Anzeigename für die Lizenz, optional ein MinThreshold, das die minimale Anzahl verfügbarer Lizenzen angibt, und optional ein MaxThreshold, das die maximale Anzahl verfügbarer Lizenzen angibt, enthalten.

Dies muss in der Runbook-Anpassung konfiguriert werden

Eigenschaft	Wert
Erforderlich	wahr
Standardwert
Typ	Objekt

E-MailAn

Empfänger-E-Mail-Adresse oder durch Kommas getrennte Empfängerliste.

Eigenschaft	Wert
Erforderlich	wahr
Standardwert
Typ	Zeichenfolge

E-MailVon

Absender-E-Mail-Adresse, die aus den Einstellungen aufgelöst wird.

Eigenschaft	Wert
Erforderlich	false
Standardwert
Typ	Zeichenfolge

Zurück zur Runbook-Referenzübersicht