Runbook-Berichteinstellungen
Zentrale E-Mail- und Speicherzustellungseinstellungen für Berichts-Runbooks konfigurieren.
Übersicht
Mehrere RealmJoin-Runbooks verfügen über automatische Berichtsfunktionen, um Berichte, Benachrichtigungen und Warnungen direkt an Administratoren zu übermitteln. Je nach Konfiguration können Berichte:
per E-Mail gesendet werden — unter Verwendung der Microsoft Graph API im Namen einer konfigurierten Absenderadresse
in einen Azure Storage Account hochgeladen werden — und als zeitlich begrenzter SAS-Downloadlink bereitgestellt werden
Die Unterstützung beider Übermittlungskanäle ist künftig der angestrebte Standard für alle Reporting-Runbooks. Noch unterstützen möglicherweise nicht alle Reporting-Runbooks beide Kanäle, aber die Anzahl der unterstützten Runbooks wächst kontinuierlich. Beide Kanäle können unabhängig voneinander oder in Kombination aktiviert werden.
Alle gemeinsamen Einstellungen werden einmal im RealmJoin Runbook-Anpassung konfiguriert und gelten automatisch für alle Runbooks, die die jeweilige Funktion verwenden. Einstellungen, die sich je Runbook unterscheiden (z. B. der Name des Zielcontainers), sind nicht Teil dieser zentralen Konfiguration und werden direkt im jeweiligen Runbook gesetzt.
Die Funktionen, die diese Einstellungen verwenden — Send-RjRbReportEmail und Publish-RjRbFilesToStorageContainer — werden vom RealmJoin.RunbookHelper PowerShell-Modul bereitgestellt. Siehe Berichtsfunktionen für eine ausführliche Verwendungsdokumentation.
E-Mail-Zustellung
Voraussetzungen
Wir empfehlen die Verwendung eines dedizierten freigegebenen Postfachs, z. B. realmjoin-report@contoso.com. Dieses Postfach wird als Absenderadresse für alle Berichte verwendet. Sie können eine No-Reply-Adresse verwenden, da von den Empfängern keine Antworten auf automatisierte Berichte erwartet werden.
Hinweis: Die Absenderadresse muss ein Benutzer- oder freigegebenes Postfach sein — eine Microsoft 365-Gruppe kann keine E-Mails über die Graph API senden. Gruppenadressen als Berichts Empfänger funktionieren technisch, werden jedoch nicht empfohlen: Ob die Mitglieder die E-Mail tatsächlich erhalten, hängt von den Follow-/Abonnement-Einstellungen der Gruppe ab, und Zustellfehler sind nur als Unzustellbarkeitsberichte im Absenderpostfach sichtbar.
Konfiguration
Wie in der JSON Based Customizing Dokumentation ausführlich beschrieben, navigieren Sie zu RealmJoin Runbook-Anpassung im RealmJoin Portal (Einstellungen > Runbook-Anpassungen).
In der Einstellungen Block fügen Sie den RJReport Abschnitt hinzu oder ändern Sie ihn, um die EmailSender Eigenschaft mit der gewünschten Absender-E-Mail-Adresse aufzunehmen:
Ersetzen Sie realmjoin-report@contoso.com durch die tatsächliche Adresse Ihres freigegebenen Postfachs.
Service-Desk-Kontaktinformationen (optional)
Diese zentrale Konfiguration stellt nur die einheitlichen Service-Desk-Werte für alle Runbooks bereit. Ob die Kontaktinformationen tatsächlich in einer Benachrichtigungs-E-Mail enthalten sind, wird vom jeweiligen Runbook selbst bestimmt — nur Runbooks, die die entsprechenden Service-Desk-Parameter implementieren (z. B. ServiceDeskDisplayName, ServiceDeskPortalUrl) lesen diese Werte und geben sie in ihren E-Mails aus.
Um die Service-Desk-Kontaktinformationen für diese Runbooks bereitzustellen, fügen Sie die folgenden Eigenschaften zum RJReport Abschnitt hinzu:
Parameter:
ServiceDesk_DisplayName— Anzeigename Ihres Service Desk (z. B. "IT Support", "Help Desk")ServiceDesk_EMail— E-Mail-Adresse des Service Desk (wird als anklickbarermailto:Link angezeigt)ServiceDesk_Phone— Telefonnummer des Service Desk im internationalen Format (wird als anklickbarertel:Link angezeigt)ServiceDesk_PortalUrl— URL Ihres Service-Desk-Portals oder Ihrer Website (wird als anklickbarer Link angezeigt)
Alle Parameter sind optional. Wenn sie konfiguriert sind, werden sie in der E-Mail-Fußzeile als anklickbare Links angezeigt.
Hinweis: Einige Runbooks akzeptieren zusätzlich einen Ticket-Link pro Ausführung (z. B.
ServiceDeskTicketUrl), um auf das spezifische Ticket zu verweisen, das die Anfrage ausgelöst hat. Dies ist ein Runbook-Parameter und nicht Teil dieser zentralen Konfiguration.
E-Mail-Branding (optional)
Berichts-E-Mails können ein Tenant-spezifisches Branding enthalten: Die standardmäßigen RealmJoin-Kopf- und Fußgrafiken können durch Ihre eigenen Bilder ersetzt werden, das Fußbild kann auf ein benutzerdefiniertes Ziel verlinken — zum Beispiel Ihr Intranet oder IT-Portal — und die Vorlagenfarben können an Ihr Corporate Design angepasst werden.
Um das Branding zu konfigurieren, fügen Sie einen Branding Unterabschnitt zum RJReport Block hinzu (verschachtelt wie StorageAccount):
Parameter:
HeaderImageUrl
nein
RealmJoin-Kopfgrafik
Öffentliche HTTPS-URL eines benutzerdefinierten Kopfbilds, das die standardmäßige RealmJoin-Kopfgrafik ersetzt
FooterImageUrl
nein
RealmJoin-Fußgrafik
Öffentliche HTTPS-URL eines benutzerdefinierten Fußbilds, das die standardmäßige RealmJoin-Fußgrafik ersetzt
FooterLink
nein
https://www.realmjoin.com
URL, auf die das Fußbild verweist
AccentColor
nein
#f8842c (RealmJoin-Orange)
Akzentfarbe der E-Mail-Vorlage: Tabellenkopfzeilen, Aktionsschaltflächen, Akzentrahmen der Infoboxen
TextColor
nein
#011e33 (RealmJoin-Navy)
Primäre Textfarbe der E-Mail-Vorlage: Fließtext, Überschriften, Listenelemente, Code
Bildanforderungen:
Das Bild muss über eine öffentliche HTTPS-URL erreichbar sein — zum Beispiel einen Azure Blob Storage-Container mit anonymem Lesezugriff, ein CDN oder die Unternehmenswebsite. Eine URL mit einem SAS Token funktioniert ebenfalls und hält den Container privat.
Unterstützte Formate: PNG, JPEG oder GIF. Das Format wird anhand der Dateisignatur erkannt, nicht anhand der Dateierweiterung.
Bilder werden dargestellt mit 750 px Breite. Empfohlene Abmessungen sind 750×200 px (entsprechend den Standard-Bannern) oder 1500×400 px für High-DPI-Anzeigen.
Maximal 200 KB pro Bild; 100 KB oder weniger wird empfohlen. Die Branding-Bilder teilen sich das gesamte E-Mail-Größenlimit von ~4 MB mit den Berichtsanhängen (zum Vergleich: die standardmäßigen RealmJoin-Grafiken haben 52 KB und 15 KB).
Farbanforderungen:
Werte müssen 6-stellige hexadezimale Farben einschließlich des führenden
#— zum Beispiel#0052cc. Kurzformen (#05c) und Farbnamen (rot) werden nicht unterstützt.Sowohl E-Mails als auch ihre Anhänge werden im Hell- und Dunkelmodus gelesen: Wählen Sie eine Textfarbe, die auf einer weißen Inhaltskarte gut lesbar bleibt, und eine Akzentfarbe mit genügend Kontrast zu weißem Schaltflächentext.
Statusfarben (Grün/Rot/Bernstein für Erfolgs-, Fehler- und Warnzustände) sowie die neutralen Grautöne sind absichtlich nicht konfigurierbar — sie tragen eine Bedeutung, die sich nicht je Tenant ändern sollte.
Die Bilder werden bei jedem Lauf vom Runbook heruntergeladen und validiert. Wenn eine Einstellung leer gelassen wird, werden die Standardgrafik, -farbe und der Standard-Footer-Link von RealmJoin verwendet. Schlägt ein Download fehl, ist ein Bild ungültig oder ist eine Farbe kein gültiger Hexwert, wird eine Warnung protokolliert und stattdessen der entsprechende Standard verwendet — eine fehlerhafte Branding-Konfiguration verhindert niemals, dass eine Bericht-E-Mail gesendet wird.
Alle Einstellungen sind optional und gelten für alle Runbooks, die Bericht-E-Mails senden.
Hinweis: Die Farbeinstellungen erfordern RealmJoin.RunbookHelper 0.8.9 oder höher im Automation Account. Mit älteren Modulversionen gelten die Bildeinstellungen weiterhin, und die Farben werden ignoriert.
Zustellung über Storage Account
Reporting-Runbooks, die diesen Übermittlungskanal unterstützen, können ihre Ausgabe in einen Azure Blob Storage-Container hochladen. Nach einem erfolgreichen Upload gibt das Runbook einen zeitlich begrenzten SAS-Link zurück, über den die Datei direkt heruntergeladen werden kann. Dieser Kanal kann unabhängig von der E-Mail-Zustellung oder zusätzlich dazu verwendet werden.
Voraussetzungen
Ein vorhandenes Azure Storage Account ist erforderlich. Die verwaltete Identität des Automation Account (oder der von den Runbooks verwendete Service Principal) benötigt mindestens Storage Blob Data Contributor Berechtigungen auf dem Storage Account oder dessen Ressourcengruppe.
Konfiguration
Navigieren Sie zu RealmJoin Runbook-Anpassung und fügen Sie einen StorageAccount Unterabschnitt zum RJReport Block hinzu:
Parameter:
ResourceGroup
ja
—
Ressourcengruppe, die den Storage Account enthält
StorageAccountName
ja
—
Name des Azure Storage Account
LinkExpiryDays
nein
6
Anzahl der Tage, bis der generierte SAS-Downloadlink abläuft
Hinweis: Einstellungen, die für ein einzelnes Runbook spezifisch sind — etwa der Name des Zielcontainers oder ein benutzerdefinierter Blob-Name — werden direkt in diesem Runbook konfiguriert und sind absichtlich nicht Teil dieser zentralen Konfiguration. Dasselbe gilt für das Präfixieren von Blob-Namen: Ob ein Zeitstempelpräfix (
yyyyMMdd-HHmmss) dem Blob-Namen vorangestellt wird, um Überschreibungen zu verhindern, wird durch denAddBlobNamePrefixParameter vonPublish-RjRbFilesToStorageContainer(Standard$false), den jedes Runbook explizit übergibt.
Kombiniertes Beispiel
Das folgende Snippet zeigt eine vollständige RJReport Konfiguration mit allen aktivierten Funktionen:
Zuletzt aktualisiert
War das hilfreich?