Bericht über Lizenzzuweisungen, geplant
Warnen, wenn die Lizenzverfügbarkeit Schwellenwerte überschreitet
Beschreibung
Prüft, wie viele Lizenzen der konfigurierten SKUs noch verfügbar sind. Wenn ein Wert unter einen Mindestwert fällt oder über einen Höchstschwellenwert steigt, werden die betroffenen SKUs gemeldet, sodass Sie rechtzeitig Lizenzen kaufen oder zurückfordern können. Der Bericht kann per E-Mail gesendet oder als Downloadlink bereitgestellt werden.
Lizenzkonfiguration
Die zu prüfenden SKUs und ihre Schwellenwerte sind in der Runbook-Anpassung als verborgenes InputJson Wert festgelegt. Jede Lizenzkonfiguration erfordert:
SKUPartNumber (erforderlich): Microsoft-SKU-Identifikator
FriendlyName (erforderlich): Anzeigename
MinThreshold (optional): Warnen, wenn verfügbare Lizenzen < Schwellenwert
MaxThreshold (optional): Warnen, wenn verfügbare Lizenzen > Schwellenwert
Pro Lizenz muss mindestens ein Schwellenwert festgelegt sein.
Konfigurationsbeispiele
Nur Mindestschwellenwert (um Engpässe zu verhindern):
[
{
"SKUPartNumber": "ENTERPRISEPACK",
"FriendlyName": "Microsoft 365 E3",
"MinThreshold": 50
}
]Nur Höchstschwellenwert (um Überprovisionierung zu verhindern):
Beide Schwellenwerte (Bereich beibehalten):
Vollständige Runbook-Anpassung
Siehe die Leitfaden zur Runbook-Anpassung für die Syntax.
SKU-Partnummern ermitteln
Gängige SKUs:
ENTERPRISEPACK- Microsoft 365 E3ENTERPRISEPREMIUM- Microsoft 365 E5EMS- Enterprise Mobility + Security E3
Ergebnisse
Jeder Lauf schreibt seine Ergebnisse auf die Registerkarte „Output Data“ des RealmJoin-Portals: eine Zusammenfassung, die Lizenzen außerhalb ihrer Schwellenwerte, die konfigurierten SKUs, die im Mandanten nicht vorhanden sind, und die Lizenzen innerhalb ihrer Schwellenwerte. Jede Tabelle kann dort nach Excel exportiert werden.
Wenn Verstöße erkannt werden: die Berichtsdateien (CSV und/oder Excel-Arbeitsmappe) listen die Lizenzen außerhalb ihrer Schwellenwerte auf, und die E-Mail enthält die Zusammenfassung, die Verstöße, Empfehlungen und die Dateien als Anlagen.
Wenn eine konfigurierte SKU nicht gefunden wird: führt die E-Mail die SKU als Konfigurationsproblem auf.
Wenn alle Lizenzen innerhalb ihrer Schwellenwerte liegen: Es wird keine E-Mail gesendet, keine Berichtdatei erstellt und der Lauf wird erfolgreich abgeschlossen.
Berichtszustellung
Berichtsdateien werden nur generiert, wenn eine Zustellmethode über die Berichtszustellung Option (E-Mail und/oder Downloadlink) und mindestens eine Lizenz liegt außerhalb ihrer Schwellenwerte. Mit Nur Ausgabedaten ausgewählt, werden die Ergebnisse direkt im Register Output Data des RealmJoin-Portals gelesen, wo jede Tabelle auch nach Excel exportiert werden kann. E-Mail-Zustellung und Download-Link-Generierung sind unabhängig und können kombiniert werden.
Für den Download-Link werden die Berichtsdateien in das in den RJReport.StorageAccount.* Tenant-Einstellungen hochgeladen, und zeitlich begrenzte SAS-Download-Links werden zurückgegeben. Der Storage-Upload authentifiziert sich mit der verwalteten Identität des Automation-Kontos; diese Identität benötigt die Storage Account Contributor RBAC-Rolle auf dem Ziel-Storage Account (dies ist eine Azure-RBAC-Zuweisung, keine Graph-Anwendungsberechtigung).
Zeitpläne, die vor der Berichtszustellung diese Option existierte, senden weiterhin ihre E-Mail: Ein gespeicherter Empfänger allein aktiviert die E-Mail für sie weiterhin. Wenn ein solcher Zeitplan zum Bearbeiten geöffnet wird, zeigt die Option Nur Ausgabedaten; wählen Sie die Zustellung vor dem Speichern erneut aus, andernfalls sendet der Zeitplan den Bericht nicht mehr.
Einrichtung für den E-Mail-Versand
Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn Bericht zusätzlich per E-Mail senden oder Bericht zusätzlich per E-Mail und Download-Link senden als Berichtsübermittlung ausgewählt ist; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus dem RJReport.EmailSender Mandanten-Einstellung übernommen.
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 zu allen verfügbaren Einstellungen.
E-Mail-Branding
Die Berichts-E-Mail berücksichtigt die optionalen RJReport.Branding.* Mandanten-Einstellungen:
Header- und Footer-Bild - öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
Footer-Link - Ziel des Fußzeilenbildes
Akzent- und Textfarbe - 6-stellige Hex-Werte, z. B.
#0052cc
Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die E-Mail des Berichts – stattdessen wird der entsprechende Standard verwendet.
Einrichtungsanweisungen und Bildanforderungen: E-Mail-Branding.
Fehlerbehebung
SKU nicht gefunden: Prüfen Sie mithilfe von Get-MgSubscribedSku.
E-Mail nicht gesendet: Überprüfen Sie die RJReport.EmailSender Einstellung und die Mail.Send-Berechtigung der verwalteten Identität. Es wird keine E-Mail gesendet, wenn alle Lizenzen innerhalb ihrer Schwellenwerte liegen.
Ungültiges JSON: Überprüfen Sie vor der Konfiguration das JSON-Format.
Hinweis zur Migration
Legacy WarningThreshold wird automatisch zugeordnet zu MinThreshold - alte Konfigurationen funktionieren weiterhin.
Ort
Organisation → Allgemein → Lizenzzuweisung melden (Geplant)
Vollständiger Runbook-Name
rjgit-org_general_report-license-assignment_scheduled
Details
Version
1.4.0
Erforderliche Module
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)
Planbar
ja
Berechtigungen
Anwendungsberechtigungen
Typ: Microsoft Graph
Organization.Read.All
Liest /organization und /subscribedSkus, um die Lizenzanzahlen anhand der Schwellenwerte zu bewerten
Mail.Send (optional — Funktion: E-Mail-Bericht)
Sendet die Schwellenwert-Berichts-E-Mail über Send-RjRbReportEmail, wenn die E-Mail-Zustellung ausgewählt ist
Hinweise zu Berechtigungen
Azure Storage Account: Rolle „Storage Account Contributor“ für die verwaltete Identität des Automation-Kontos auf dem Ziel-Storage Account – der Upload ruft die Kontoschlüssel über listKeys ab (nur für die Download-Link-Optionen erforderlich)
Parameter
InputJson
SKU-Liste mit Anzeigenamen sowie Mindest- und Höchstschwellenwerten als JSON-Array. Voreingestellt in der Runbook-Anpassung.
Erforderlich
ja
Standardwert
Typ
Objekt
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ReportFileFormat
Stellen Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides bereit.
Erforderlich
nein
Standardwert
CSV & XLSX
Typ
Zeichenfolge
Anzeigename im Portal
Berichtsdateiformat
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
Portaloptionen
CSV & XLSX
CSV & XLSX
Nur CSV
Nur CSV
Nur XLSX
Nur XLSX
CreateDownloadLink
Laden Sie den Bericht außerdem hoch und geben Sie einen Downloadlink zurück, der nach einigen Tagen abläuft.
Erforderlich
nein
Standardwert
Falsch
Typ
Boolesch
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ContainerName
Speichercontainer, in den die Berichtsdateien hochgeladen werden. Pro Runbook festlegen.
Erforderlich
nein
Standardwert
report-license-assignment
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ResourceGroupName
Ressourcengruppe des Storage Account für Berichtshochladungen. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
StorageAccountName
Storage Account für Berichtshochladungen. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
LinkExpiryDays
Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.
Erforderlich
nein
Standardwert
6
Typ
Int32
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
SendEmailReport
Sendet den Bericht an die E-Mail-Adresse des Empfängers.
Erforderlich
nein
Standardwert
Falsch
Typ
Boolesch
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
EmailTo
Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere mit Kommas; jeder Empfänger erhält eine separate E-Mail.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
E-Mail-Adresse(n) des Empfängers
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
EmailFrom
Absenderadresse der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.EmailSender übernommen.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingHeaderImageUrl
Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.HeaderImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Header verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingFooterImageUrl
Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.FooterImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Footer verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingFooterLink
Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.Branding.FooterLink übernommen; bei leerem Wert wird realmjoin.com verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingAccentColor
Akzentfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.AccentColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingTextColor
Textfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.TextColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
Zuletzt aktualisiert
War das hilfreich?