> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-report-settings.md). # Einstellungen für Runbook-Berichte Zentrale Einstellungen für E-Mail- und Speicherzustellung 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](https://portal.realmjoin.com/settings/runbooks-customizations) 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`](/de/dev-reference/report-functions/send-rjrbreportemail.md) und [`Publish-RjRbFilesToStorageContainer`](/de/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — werden vom **RealmJoin.RunbookHelper** PowerShell-Modul bereitgestellt. Siehe [Berichtsfunktionen](/de/dev-reference/report-functions.md) 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](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) Dokumentation ausführlich beschrieben, navigieren Sie zu [RealmJoin Runbook-Anpassung](https://portal.realmjoin.com/settings/runbooks-customizations) 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: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` 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: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com" } } } ``` **Parameter:** * `ServiceDesk_DisplayName` — Anzeigename Ihres Service Desk (z. B. "IT Support", "Help Desk") * `ServiceDesk_EMail` — E-Mail-Adresse des Service Desk (wird als anklickbarer `mailto:` Link angezeigt) * `ServiceDesk_Phone` — Telefonnummer des Service Desk im internationalen Format (wird als anklickbarer `tel:` 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`): ```json { "Settings": { "RJReport": { "Branding": { "HeaderImageUrl": "https://cdn.contoso.com/branding/email-header.png", "FooterImageUrl": "https://cdn.contoso.com/branding/email-footer.png", "FooterLink": "https://intranet.contoso.com", "AccentColor": "#0052cc", "TextColor": "#1a1a2e" } } } } ``` **Parameter:** | Einstellung | Erforderlich | Standard | Beschreibung | | ---------------- | ------------ | ---------------------------- | -------------------------------------------------------------------------------------------------------------- | | `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](https://portal.realmjoin.com/settings/runbooks-customizations) und fügen Sie einen `StorageAccount` Unterabschnitt zum `RJReport` Block hinzu: ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 } } } } ``` **Parameter:** | Einstellung | Erforderlich | Standard | Beschreibung | | -------------------- | ------------ | -------- | ------------------------------------------------------------ | | `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 den `AddBlobNamePrefix` Parameter von [`Publish-RjRbFilesToStorageContainer`](/de/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) (Standard `$false`), den jedes Runbook explizit übergibt. ## Kombiniertes Beispiel Das folgende Snippet zeigt eine vollständige `RJReport` Konfiguration mit allen aktivierten Funktionen: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com", "Branding": { "HeaderImageUrl": "https://cdn.contoso.com/branding/email-header.png", "FooterImageUrl": "https://cdn.contoso.com/branding/email-footer.png", "FooterLink": "https://intranet.contoso.com", "AccentColor": "#0052cc", "TextColor": "#1a1a2e" }, "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6 } } } } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-report-settings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.