Geplanter Bericht zur Lizenzzuweisung

Einen Bericht über die Lizenzverfügbarkeit basierend auf Schwellenwerten erstellen und per E-Mail senden

Beschreibung

Dieses Runbook prüft die Lizenzverfügbarkeit anhand der übermittelten SKUs und sendet einen E-Mail-Bericht, wenn Schwellenwerte erreicht werden. Es können zwei Arten von Schwellenwerten konfiguriert werden. Der erste Typ ist ein Mindestschwellenwert, der eine Warnung auslöst, wenn die Anzahl der verfügbaren Lizenzen unter eine angegebene Zahl fällt. Der zweite Typ ist ein Höchstschwellenwert, der eine Warnung auslöst, wenn die Anzahl der verfügbaren Lizenzen eine angegebene Zahl überschreitet. Der Bericht enthält detaillierte Informationen zu Lizenzen, die außerhalb der konfigurierten Schwellenwerte liegen, exportiert sie in CSV-Dateien und sendet sie per E-Mail.

Runbook-Anpassung

Einrichtung für den E-Mail-Versand

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (E-Mail an) angegeben ist. Die Absenderadresse wird aus der RJReport.EmailSender Tenant-Einstellung entnommen.

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

Siehe die RealmJoin Report Settings-Dokumentation für Details.

InputJson-Konfiguration

Jede Lizenzkonfiguration erfordert:

• SKUPartNumber (erforderlich): Microsoft-SKU-Kennung

• FriendlyName (erforderlich): Anzeigename

• MinThreshold (optional): Warnung auslösen, wenn die verfügbaren Lizenzen < Schwellenwert sind

• MaxThreshold (optional): Warnung auslösen, wenn die verfügbaren Lizenzen > Schwellenwert sind

Mindestens ein Schwellenwert muss pro Lizenz festgelegt werden.

Konfigurationsbeispiele

Nur Mindestschwellenwert (Engpässe vermeiden):

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

Nur Höchstschwellenwert (Überbereitstellung vermeiden):

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

Beide Schwellenwerte (Bereich einhalten):

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

Vollständige Runbook-Anpassung

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

SKU-Teilenummern 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 Auftragsprotokoll

• CSV-Export (License_Threshold_Violations.csv)

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

Wenn alles innerhalb der Schwellenwerte liegt:

• Keine E-Mail gesendet

• Auftrag wird erfolgreich abgeschlossen

Fehlerbehebung

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

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

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

Hinweis zur Migration

Legacy WarningThreshold wird automatisch zugeordnet zu MinThreshold - alte Konfigurationen funktionieren weiterhin.

Ort

Organisation → Allgemein → Lizenzzuweisungsbericht (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 mit SKU-Konfigurationen und Schwellenwerten. Jeder Eintrag sollte eine SKUPartNumber für die Microsoft-SKU-Kennung, eine FriendlyName als Anzeigename für die Lizenz, einen optionalen MinThreshold zur Angabe der Mindestanzahl verfügbarer Lizenzen und einen optionalen MaxThreshold zur Angabe der Höchstanzahl verfügbarer Lizenzen enthalten.

Dies muss in der Runbook-Anpassung konfiguriert werden

Eigenschaft	Wert
Erforderlich	wahr
Standardwert
Typ	Objekt

E-Mail an

E-Mail-Adresse des Empfängers oder kommagetrennte Empfängerliste.

Eigenschaft	Wert
Erforderlich	wahr
Standardwert
Typ	Zeichenfolge

E-Mail von

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

Eigenschaft	Wert
Erforderlich	false
Standardwert
Typ	Zeichenfolge

Zur Übersicht der Runbook-Referenz zurück