> 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

Konfigurieren Sie zentrale E-Mail- und Speicherauslieferungseinstellungen für Reporting-Runbooks.

## Übersicht

Mehrere RealmJoin-Runbooks verfügen über 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 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 Customization](https://portal.realmjoin.com/settings/runbooks-customizations) und gelten automatisch für alle Runbooks, die die jeweilige Funktion verwenden. Einstellungen, die sich je nach Runbook unterscheiden (z. B. der Name des Ziel-Containers), sind nicht Teil dieser zentralen Konfiguration und werden direkt im jeweiligen Runbook gesetzt.

Die Funktionen, die diese Einstellungen verwenden — [`Send-RjRbReportEmail`](https://docs.realmjoin.com/de/dev-reference/report-functions/send-rjrbreportemail.md) und [`Publish-RjRbFilesToStorageContainer`](https://docs.realmjoin.com/de/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — werden vom **RealmJoin.RunbookHelper** PowerShell-Modul bereitgestellt. Siehe [Report Functions](https://docs.realmjoin.com/de/dev-reference/report-functions.md) für eine ausführliche 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.

> **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 Bericht **Empfänger** funktionieren technisch, werden jedoch nicht empfohlen: Ob Mitglieder die E-Mail tatsächlich erhalten, hängt von den Follow-/Abonnement-Einstellungen der Gruppe ab, und Zustellfehler sind nur als Unzustellbarkeitsberichte im Postfach des Absenders sichtbar.

### Konfiguration

Wie im Abschnitt [JSON Based Customizing](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) ausführlich beschrieben, navigieren Sie zu [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) im RealmJoin Portal (Einstellungen > Runbook-Anpassungen).

In der `Einstellungen` Abschnitt fügen Sie den `RJReport` Abschnitt hinzu, um die `EmailSender` Eigenschaft mit Ihrer 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 lediglich die einheitlichen Service-Desk-Werte für alle Runbooks bereit. Ob die Kontaktinformationen tatsächlich in einer Benachrichtigungs-E-Mail enthalten sind, entscheidet das jeweilige Runbook selbst — nur Runbooks, die die entsprechenden Service-Desk-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 angezeigt)
* `ServiceDesk_Phone` — Telefonnummer des Service Desks 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, erscheinen sie in der E-Mail-Fußzeile als anklickbare Links.

> **Hinweis:** Einige Runbooks akzeptieren zusätzlich einen Ticket-Link pro Ausführung (z. B. `ServiceDeskTicketUrl`), um auf das konkrete Ticket zu verweisen, das die Anforderung ausgelöst hat. Dies ist ein Runbook-Parameter und nicht Teil dieser zentralen Konfiguration.

### E-Mail-Branding (optional)

Bericht-E-Mails können Tenant-spezifisches Branding tragen: Die standardmäßigen RealmJoin-Kopf- und Fußgrafiken können durch Ihre eigenen Bilder ersetzt werden, das Footer-Bild kann auf ein benutzerdefiniertes Ziel verlinken — z. B. Ihr Intranet oder IT-Portal — und die Vorlagenfarben können an Ihr Corporate Design angepasst werden.

Um Branding zu konfigurieren, fügen Sie einen `Branding` Unterabschnitt zum `RJReport` Abschnitt 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 Kopfbildes, das die standardmäßige RealmJoin-Kopfgrafik ersetzt |
| `FooterImageUrl` | nein         | RealmJoin-Fußgrafik          | Öffentliche HTTPS-URL eines benutzerdefinierten Fußbildes, 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, Listeneinträge, Code                            |

**Bildanforderungen:**

* Das Bild muss über eine **öffentliche HTTPS-URL** — z. B. 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 und nicht anhand der Dateiendung erkannt.
* 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 mit den Berichtsanhängen die gesamte E-Mail-Größenbeschränkung von ca. 4 MB (zum Vergleich: Die standardmäßigen RealmJoin-Grafiken sind 52 KB und 15 KB).

**Farbanforderungen:**

* Die Werte müssen 6-stellige hexadezimale Farben sein, 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 Light- **und** Dark-Mode gelesen: Wählen Sie eine Textfarbe, die auf einer weißen Inhaltskarte lesbar bleibt, und eine Akzentfarbe mit genügend Kontrast zu weißem Schaltflächentext.
* Statusfarben (Grün/Rot/Amber für Erfolgs-, Fehler- und Warnzustände) sowie die neutralen Grautöne sind absichtlich nicht konfigurierbar — sie transportieren eine Bedeutung, die sich nicht je Tenant ändern sollte.

Die Bilder werden bei jedem Durchlauf vom Runbook heruntergeladen und validiert. Wenn eine Einstellung leer gelassen wird, werden die standardmäßige RealmJoin-Grafik, Farbe und der Footer-Link verwendet. Wenn ein Download fehlschlägt, ein Bild ungültig ist oder eine Farbe kein gültiger Hex-Wert ist, 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 neuer im Automation Account. Mit älteren Modulversionen gelten die Bildeinstellungen weiterhin, und die Farben werden ignoriert.

## 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, der zum direkten Herunterladen der Datei verwendet werden kann. Dieser Kanal kann unabhängig von der E-Mail-Zustellung oder zusätzlich dazu verwendet werden.

### Voraussetzungen

Es ist ein vorhandenes Azure Storage Account erforderlich. Die verwaltete Identität des Automation Accounts (oder der von den Runbooks verwendete Service Principal) benötigt die integrierte Azure RBAC-Rolle **Reader and Data Access**, direkt auf dem Storage Account zugewiesen.

Der Upload ruft den Schlüssel des Storage Accounts über `listKeys` ab und verwendet ihn, um den Container zu erstellen, die Dateien hochzuladen und die SAS-Downloadlinks zu signieren. **Reader and Data Access** ist die kleinste integrierte Rolle, die diese Aktion enthält. **Storage Account Contributor** funktioniert ebenfalls, ermöglicht jedoch zusätzlich die Verwaltung und das Löschen des Storage Accounts. **Storage Blob Data Contributor** ist nicht ausreichend, da sie Folgendes nicht enthält: `listKeys`.

> **Hinweis:** Der Kontoschlüssel gewährt Zugriff auf alle Daten im Storage Account. Verwenden Sie einen dedizierten Storage Account für Berichte und weisen Sie die Rolle auf dem Storage Account und nicht auf dessen Ressourcengruppe zu. Der Zugriff mit gemeinsam genutztem Schlüssel muss auf dem Storage Account erlaubt sein (`allowSharedKeyAccess` darf nicht `falsch`sein, beispielsweise über die Azure Policy „Storage accounts should prevent shared key access“), andernfalls schlägt der Upload fehl.

### Konfiguration

Navigieren Sie zu [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) und fügen Sie einen `StorageAccount` Unterabschnitt zum `RJReport` Abschnitt hinzu:

```json
{
    "Settings": {
        "RJReport": {
            "StorageAccount": {
                "ResourceGroup": "rg-reports",
                "StorageAccountName": "stcontosoreports",
                "SubscriptionId": "00000000-0000-0000-0000-000000000000",
                "LinkExpiryDays": 6
            }
        }
    }
}
```

**Parameter:**

| Einstellung          | Erforderlich    | Standard                              | Beschreibung                                                                                                                             |
| -------------------- | --------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `ResourceGroup`      | ja              | —                                     | Ressourcengruppe, die den Storage Account enthält                                                                                        |
| `StorageAccountName` | ja              | —                                     | Name des Azure Storage Account                                                                                                           |
| `SubscriptionId`     | nein, empfohlen | beim Anmelden ausgewähltes Abonnement | ID der Azure-Subscription, die den Storage Account enthält, siehe [Abonnement des Storage Account](#subscription-of-the-storage-account) |
| `LinkExpiryDays`     | nein            | `6`                                   | Anzahl der Tage, bis der generierte SAS-Downloadlink abläuft                                                                             |

> **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 absichtlich nicht Teil dieser zentralen Konfiguration. Gleiches gilt für das Voranstellen eines Blob-Namens: Ob ein Zeitstempel-Präfix (`yyyyMMdd-HHmmss`) dem Blob-Namen vorangestellt wird, um Überschreibungen zu verhindern, wird gesteuert durch den `AddBlobNamePrefix` Parameter von [`Publish-RjRbFilesToStorageContainer`](https://docs.realmjoin.com/de/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) (Standard `$false`), den jedes Runbook explizit übergibt.

### Abonnement des Storage Account

Einstellung `SubscriptionId` ist optional, aber empfohlen. Die Runbooks melden sich bei Azure mit der verwalteten Identität an, ohne ein Abonnement anzugeben, sodass Azure eines der Abonnements auswählt, in denen die verwaltete Identität eine Rollenzuweisung besitzt. Welches das ist, ist nicht dokumentiert, und es ist nicht unbedingt das Abonnement des Automation Accounts. Ohne `SubscriptionId`, sucht der Upload im ausgewählten Abonnement nach dem Storage Account.

Solange die verwaltete Identität Rollenzuweisungen nur in einem einzigen Abonnement besitzt, funktioniert dies, auch wenn sich der Storage Account in einem anderen Abonnement als der Automation Account befindet. Sobald die verwaltete Identität auch in einem anderen Abonnement eine Rolle besitzt, beispielsweise weil andere Runbooks dort Ressourcen verwalten, kann Azure stattdessen dieses Abonnement auswählen. Der Upload schlägt dann fehl, weil der Storage Account dort nicht gefunden wird. Dies kann jederzeit nach einer solchen Rollenzuweisung auftreten, obwohl sich an den Reporting-Runbooks oder deren Einstellungen nichts geändert hat.

Mit `SubscriptionId` festgelegt, verwendet der Upload immer das Abonnement, das den Storage Account enthält. Sie finden die ID auf der **Übersicht** Seite des Storage Account im Azure Portal. Wenn Sie für einzelne Runbooks einen Storage Account in einem anderen Abonnement verwenden, setzen Sie dort auch dessen `SubscriptionId` in diesem Override ebenfalls, siehe [Verwenden Sie für einzelne Runbooks einen anderen Storage Account](#use-a-different-storage-account-for-individual-runbooks).

### Verwenden Sie für einzelne Runbooks einen anderen Storage Account

Die `RJReport.StorageAccount` Einstellungen gelten für alle Reporting-Runbooks. Wenn ein oder mehrere Runbooks in einen anderen Storage Account oder eine andere Ressourcengruppe hochladen oder eine andere Link-Laufzeit verwenden sollen, fügen Sie für jedes dieser Runbooks einen Override zum `Runbooks` Abschnitt derselben Anpassung hinzu:

```json
{
    "Settings": {
        "RJReport": {
            "StorageAccount": {
                "ResourceGroup": "rg-reports",
                "StorageAccountName": "stcontosoreports",
                "SubscriptionId": "00000000-0000-0000-0000-000000000000"
            }
        }
    },
    "Runbooks": {
        "rjgit-org_general_report-license-assignment_scheduled": {
            "Settings": {
                "RJReport": {
                    "StorageAccount": {
                        "ResourceGroup": "rg-licensing",
                        "StorageAccountName": "stcontosolicensing",
                        "LinkExpiryDays": 1
                    }
                }
            }
        }
    }
}
```

In diesem Beispiel lädt Report License Assignment (Scheduled) in `stcontosolicensing` und seine Downloadlinks laufen nach einem Tag ab. Alle anderen Reporting-Runbooks verwenden weiterhin `stcontosoreports`.

* **Runbook-Name:** Der untenstehende Schlüssel `Runbooks` ist der vollständige Runbook-Name, der auf der Referenzseite des Runbooks unter **Ort** → **Vollständiger Runbook-Name**. Er muss exakt übereinstimmen, einschließlich Groß- und Kleinschreibung. Fügen Sie pro Runbook einen Block hinzu.
* **Vererbung:** Für jede Einstellung werden zunächst die runbook-eigenen `Einstellungen` Einstellungen geprüft, dann die globalen `Einstellungen`. Nur die von Ihnen gesetzten Schlüssel werden überschrieben, alle anderen werden vererbt. Um die Link-Laufzeit eines einzelnen Runbooks zu verkürzen, `LinkExpiryDays` allein reicht aus. Wenn sich der Storage Account in einer anderen Ressourcengruppe befindet, setzen Sie immer `ResourceGroup` und `StorageAccountName` zusammen; wenn er sich in einem anderen Abonnement befindet, setzen Sie zusätzlich auch `SubscriptionId`.
* **Berechtigungen:** Die verwaltete Identität benötigt außerdem **Reader and Data Access** auf jedem Storage Account, der in einem Override verwendet wird, wie oben in den Voraussetzungen beschrieben.
* **Geplante Ausführungen:** Einstellungen werden angewendet, wenn ein Lauf gestartet oder geplant wird. Vorhandene Zeitpläne behalten den Storage Account, mit dem sie erstellt wurden; erstellen Sie sie neu, um den Override zu verwenden.
* **Container:** Der Container ist nicht Teil von `RJReport.StorageAccount`. Um ihn für ein einzelnes Runbook zu ändern, legen Sie einen Standardwert für den Container-Parameter des Runbooks fest (üblicherweise `ContainerName`) im selben Block fest, zum Beispiel `"Default": { "ContainerName": "license-reports" }`.

## 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",
            "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",
                "SubscriptionId": "00000000-0000-0000-0000-000000000000",
                "LinkExpiryDays": 6
            }
        }
    }
}
```

## Runbook-spezifische Storage Account-Einstellungen (veraltet)

Einige ältere Reporting-Runbooks lesen ihren Storage Account aus einem eigenen Einstellungsabschnitt. Sie verwenden inzwischen auch `RJReport.StorageAccount`, lesen aber weiterhin ihren eigenen Abschnitt, damit bestehende Konfigurationen weiterhin funktionieren:

| Einstellungsblock       | Runbooks                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `IntuneDevicesReport`   | [Alle Intune-Geräte exportieren](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/general/export-all-intune-devices.md), [Alle Autopilot-Geräte exportieren](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/general/export-all-autopilot-devices.md), [Nicht konforme Geräte exportieren](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/general/export-non-compliant-devices.md) |
| `EnrolledDevicesReport` | [Bericht über eingeschriebene Geräte (geplant)](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/general/enrolled-devices-report_scheduled.md)                                                                                                                                                                                                                                                                                                  |
| `TenantPolicyReport`    | [Richtlinienbericht exportieren](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/general/export-policy-report.md)                                                                                                                                                                                                                                                                                                                              |
| `OfficeLicensingReport` | [Office365-Lizenzbericht](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/general/office365-license-report.md)                                                                                                                                                                                                                                                                                                                                 |
| `CaPoliciesExport`      | [Conditional Access-Richtlinien sichern](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/security/backup-conditional-access-policies.md)                                                                                                                                                                                                                                                                                                       |
| `ListAdminsReport`      | [Administratoren auflisten](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/security/list-admin-users.md)                                                                                                                                                                                                                                                                                                                                      |
| `InactiveDevices`       | [Inaktive Geräte auflisten](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/security/list-inactive-devices.md)                                                                                                                                                                                                                                                                                                                                 |
| `VulnAppRegExport`      | [Anfällige App-Registrierungen auflisten](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/security/list-vulnerable-app-regs.md)                                                                                                                                                                                                                                                                                                                |
| `EntAppsReport`         | [Benutzer von Enterprise-Anwendungen exportieren](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/applications/export-enterprise-application-users.md)                                                                                                                                                                                                                                                                                         |

Die Speicherschlüssel dieser Blöcke entsprechen `RJReport.StorageAccount` wie folgt:

| Runbook-spezifischer Schlüssel                                           | `RJReport.StorageAccount` Schlüssel                                                                                                                                          |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ResourceGroup`                                                          | `ResourceGroup`                                                                                                                                                              |
| `StorageAccount.Name`                                                    | `StorageAccountName`                                                                                                                                                         |
| `LinkExpiryDays` (nur `EntAppsReport`)                                   | `LinkExpiryDays`                                                                                                                                                             |
| `StorageAccount.Location`, `StorageAccount.Sku`                          | keine: wird ignoriert, da der Storage Account nicht mehr automatisch erstellt wird                                                                                           |
| `SubscriptionId` (nur `IntuneDevicesReport` und `OfficeLicensingReport`) | `SubscriptionId`                                                                                                                                                             |
| `Container`                                                              | keine: Container pro Runbook festlegen, wie in [Verwenden Sie für einzelne Runbooks einen anderen Storage Account](#use-a-different-storage-account-for-individual-runbooks) |

Andere Schlüssel in diesen Blöcken, wie `CreateLinks` oder die Berichtsoptionen von `OfficeLicensingReport`, sind nicht betroffen und funktionieren weiterhin.

### Priorität

Diese Runbooks beziehen die Ressourcengruppe und den Namen des Storage Account aus der ersten dieser Quellen, die sie bereitstellt:

1. Direkt an das Runbook übergebene Werte, z. B. durch eine geplante Ausführung, einen API-Aufruf oder einen Parameter-Standardwert in der Runbook-Anpassung
2. Der runbook-spezifische Einstellungsblock
3. Die Automation-Variable `SettingsExports` (nur Export All Autopilot Devices, Backup Conditional Access Policies, List Inactive Devices und Export Enterprise Application Users)
4. `RJReport.StorageAccount`, einschließlich der Overrides für einzelne Runbooks

`RJReport.StorageAccount` wird nur verwendet, wenn die oben genannten Quellen nicht sowohl die Ressourcengruppe als auch den Namen des Storage Account bereitstellen; dann stellt sie beides bereit, zusammen mit ihrem `SubscriptionId`. `RJReport.StorageAccount.LinkExpiryDays` gilt in jedem Fall, außer dass `EntAppsReport.LinkExpiryDays` bei Export Enterprise Application Users Vorrang hat.

### Umstellung auf RJReport.StorageAccount

1. Konfigurieren Sie `RJReport.StorageAccount` wie in [Zustellung über Storage Account](#storage-account-delivery)beschrieben. Wenn ein Runbook einen anderen Storage Account als die anderen verwendete, fügen Sie für dieses Runbook einen Override mit dessen `SubscriptionId` an, wenn sich das Konto in einem anderen Abonnement befindet, wie in [Verwenden Sie für einzelne Runbooks einen anderen Storage Account](#use-a-different-storage-account-for-individual-runbooks).
2. Weisen Sie **Reader and Data Access** auf jedem Storage Account der verwalteten Identität zu, wie in den Voraussetzungen von [Zustellung über Storage Account](#storage-account-delivery).
3. Entfernen Sie die runbook-spezifischen Blöcke aus der Anpassung. Wenn ein Block `Container`, `CreateLinks` oder Berichtsoptionen festlegt, die Sie beibehalten möchten, behalten Sie nur diese Schlüssel oder setzen Sie sie als Parameter-Standards des Runbooks.
4. Erstellen Sie die geplanten Ausführungen dieser Runbooks neu. Eine geplante Ausführung behält die Werte vom Zeitpunkt ihrer Erstellung bei, einschließlich des vorherigen Storage Account.

> **Hinweis:** Die Parameter `StorageAccountLocation` und `StorageAccountSku` sind veraltet und werden ignoriert. Geplante Ausführungen, die mit einer früheren Version erstellt wurden, übergeben sie weiterhin; diese Ausführungen funktionieren weiter und protokollieren eine Warnung. Eine spätere Version entfernt beide Parameter, daher sollten solche geplanten Ausführungen vorher neu erstellt werden.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-report-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
