> 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). # Runbook-Berichtseinstellungen ## Überblick Mehrere RealmJoin-Runbooks enthalten automatisierte Berichtsfunktionen, um Berichte, Benachrichtigungen und Warnungen direkt an Administratoren zu übermitteln. Je nach Konfiguration können Berichte: * **per E-Mail gesendet** — unter Verwendung der Microsoft Graph API im Namen einer konfigurierten Absenderadresse * **in ein Azure Storage Account hochgeladen** — und als zeitlich begrenzter SAS-Downloadlink bereitgestellt Die Unterstützung beider Übertragungskanä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 stetig. Beide Kanäle können unabhängig voneinander oder in Kombination aktiviert werden. Alle gemeinsamen Einstellungen werden einmalig in der [RealmJoin Runbook-Anpassung](https://portal.realmjoin.com/settings/runbooks-customizations) festgelegt und werden automatisch auf alle Runbooks angewendet, die die jeweilige Funktion nutzen. Einstellungen, die sich je Runbook unterscheiden (z. B. der Name des Ziel-Containers), sind nicht Teil dieser zentralen Konfiguration und werden direkt im jeweiligen Runbook festgelegt. 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 detaillierte Nutzungsdokumentation. ## 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 nicht erwartet wird, auf automatisierte Berichte zu antworten. ### Konfiguration Wie ausführlich in der [JSON Based Customizing](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) Dokumentation beschrieben, navigieren Sie zu [RealmJoin Runbook-Anpassung](https://portal.realmjoin.com/settings/runbooks-customizations) im RealmJoin-Portal (Settings > Runbook Customizations). Im `Einstellungen` Block, fügen Sie den `RJReport` Abschnitt hinzu, um die `EmailSender` Eigenschaft mit der gewünschten Absender-E-Mail-Adresse anzugeben: ```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) Um Service-Desk-Kontaktinformationen in Benachrichtigungs-E-Mails aufzunehmen, fügen Sie die folgenden Eigenschaften dem `RJReport` Abschnitt hinzu: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT-Service-Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789" } } } ``` **Parameter:** * `ServiceDesk_DisplayName` — Anzeigename Ihres Service-Desks (z. B. "IT Support", "Help Desk") * `ServiceDesk_EMail` — E-Mail-Adresse des Service-Desks (wird als anklickbarer `mailto:` Link) * `ServiceDesk_Phone` — Telefonnummer des Service-Desks im internationalen Format (wird als anklickbarer `tel:` Link) Alle drei Parameter sind optional. Wenn sie konfiguriert sind, erscheinen sie in der E-Mail-Fußzeile als anklickbare Links. ## Zustellung über Storage Account Reporting-Runbooks, die diesen Übertragungskanal 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, mit dem die Datei direkt heruntergeladen werden kann. Dieser Kanal kann unabhängig von oder zusätzlich zur E-Mail-Zustellung verwendet werden. ### Voraussetzungen Es ist ein vorhandenes Azure Storage Account erforderlich. Die verwaltete Identität des Automation-Kontos (oder der von den Runbooks verwendete Dienstprinzipal) benötigt mindestens **Storage Blob Data Contributor** Berechtigungen für das Storage Account oder dessen Ressourcengruppe. ### Konfiguration Navigieren Sie zu [RealmJoin Runbook-Anpassung](https://portal.realmjoin.com/settings/runbooks-customizations) und fügen Sie eine `StorageAccount` Unterabschnitt zum `RJReport` Block hinzu: ```json { "Settings": { "RJReport": { "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` **Parameter:** | Einstellung | Erforderlich | Standard | Beschreibung | | -------------------- | ------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `ResourceGroup` | ja | — | Ressourcengruppe, die das Storage Account enthält | | `StorageAccountName` | ja | — | Name des Azure Storage Account | | `LinkExpiryDays` | nein | `6` | Anzahl der Tage, bis der generierte SAS-Downloadlink abläuft | | `AddBlobNamePrefix` | nein | `true` | Fügt einen Zeitstempel (`yyyyMMdd-HHmmss`) dem Blob-Namen voran, um Überschreibungen zu verhindern | | `UseRandomPrefix` | nein | `false` | Verwendet eine 6-stellige alphanumerische Zufallszeichenfolge als Präfix anstelle eines Zeitstempels; gilt nur, wenn `AddBlobNamePrefix` ist `true` | > **Hinweis:** Einstellungen, die spezifisch für ein einzelnes Runbook sind — wie der Name des Ziel-Containers oder ein benutzerdefinierter Blob-Name — werden direkt in diesem Runbook konfiguriert und sind bewusst nicht Teil dieser zentralen Konfiguration. ## Kombiniertes Beispiel Der folgende Ausschnitt 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", "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` --- # 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: ``` GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-report-settings.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.