> 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-Berichteinstellungen ## Überblick Mehrere RealmJoin Runbooks enthalten automatisierte Berichtsfunktionen, um Berichte, Benachrichtigungen und Warnungen direkt an Administratoren zu liefern. Je nach Konfiguration können Berichte: * **per E-Mail gesendet werden** — unter Verwendung der Microsoft Graph API im Namen einer konfigurierten Absenderadresse * **in ein Azure Storage Account hochgeladen werden** — und als zeitlich begrenzter SAS-Downloadlink bereitgestellt werden Die Unterstützung beider Zustellkanäle ist künftig der vorgesehene 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 gemeinsam genutzten Einstellungen werden einmalig in der [RealmJoin Runbook-Anpassung](https://portal.realmjoin.com/settings/runbooks-customizations) konfiguriert und werden automatisch auf alle Runbooks angewendet, die die jeweilige Funktion verwenden. Einstellungen, die sich pro 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 keine Antwort auf automatisierte Berichte erwartet wird. ### Konfiguration Wie in der [JSON-basierten Anpassung](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) Dokumentation, navigieren Sie zu [RealmJoin Runbook-Anpassung](https://portal.realmjoin.com/settings/runbooks-customizations) im RealmJoin Portal (Einstellungen > Runbook-Anpassungen). Im `Einstellungen` Block, fügen Sie den `RJReport` Abschnitt hinzu oder ändern Sie ihn, um die `EmailSender` Eigenschaft mit Ihrer gewünschten Absender-E-Mail-Adresse einzuschließen: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` Ersetzen Sie `realmjoin-report@contoso.com` durch Ihre tatsächliche Adresse des 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 ServiceDesk-Parameter implementieren (z. B. `ServiceDeskDisplayName`, `ServiceDeskPortalUrl`) lesen diese Werte aus 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 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) * `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`) zur Referenz auf das spezifische Ticket, das die Anfrage ausgelöst hat. Dies ist ein Runbook-Parameter und nicht Teil dieser zentralen Konfiguration. ## Zustellung über Storage Account Reporting-Runbooks, die diesen Zustellkanal 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 oder zusätzlich zur E-Mail-Zustellung 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 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 einen `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 dem Blob-Namen einen Zeitstempel (`yyyyMMdd-HHmmss`) voran, um Überschreibungen zu verhindern | | `UseRandomPrefix` | nein | `false` | Verwendet als Präfix einen 6-stelligen alphanumerischen Zufallsstring anstelle eines Zeitstempels; gilt nur, wenn `AddBlobNamePrefix` ist `true` | > **Hinweis:** Einstellungen, die spezifisch für ein einzelnes Runbook sind — z. B. der Name des Ziel-Containers oder ein benutzerdefinierter Blob-Name — werden direkt in diesem Runbook konfiguriert und sind absichtlich 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", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com", "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, 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.