Runbook-Berichtseinstellungen

Zentrale E-Mail- und Speicherzustellungseinstellungen für Reporting-Runbooks konfigurieren.

Übersicht

Mehrere RealmJoin-Runbooks enthalten automatisierte Berichtsfunktionen, um Berichte, Benachrichtigungen und Warnungen direkt an Administratoren zu liefern. Abhängig von der Konfiguration können Berichte:

• per E-Mail gesendet — unter Verwendung der Microsoft Graph API im Auftrag einer konfigurierten Absenderadresse

• in ein Azure Storage Account hochgeladen — und als zeitlich begrenzter SAS-Download-Link bereitgestellt

Die Unterstützung beider Übermittlungskanäle ist künftig der angestrebte Standard für alle Reporting-Runbooks. Möglicherweise unterstützen noch 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 konfiguriert und gelten automatisch für alle Runbooks, die die jeweilige Funktion verwenden. 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-RjReportEmail und Publish-RjRbFilesToStorageContainer — werden bereitgestellt durch das RealmJoin.RunbookHelper PowerShell-Modul. Siehe Berichtsfunktionen für eine detaillierte Nutzungsdokumentation.

E-Mail-Zustellung

Voraussetzungen

Wir empfehlen die Verwendung eines dedizierten freigegebenen Postfachs, wie z. B. [email protected]. 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 ausführlich in der JSON-basierten Customizing Dokumentation beschrieben, navigieren Sie zu RealmJoin Runbook-Anpassung im RealmJoin Portal (Settings > Runbook Customizations).

In der Einstellungen Block fügen Sie den RJReport Abschnitt hinzu, um die EmailSender Eigenschaft mit Ihrer gewünschten Absender-E-Mail-Adresse zu enthalten:

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]"
        }
    }
}

Ersetzen Sie [email protected] durch die tatsächliche Adresse Ihres freigegebenen Postfachs.

Service-Desk-Kontaktinformationen (optional)

Um Service-Desk-Kontaktinformationen in Benachrichtigungs-E-Mails einzuschließen, fügen Sie die folgenden Eigenschaften zur RJReport Abschnitt hinzu:

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]",
            "ServiceDesk_DisplayName": "IT Service Desk",
            "ServiceDesk_EMail": "[email protected]",
            "ServiceDesk_Phone": "[phone]"
        }
    }
}

Parameter:

• ServiceDesk_DisplayName — Anzeigename Ihres Service Desk (z. B. "IT Support", "Help Desk")

• ServiceDesk_EMail — E-Mail-Adresse des Service Desk (wird als klickbarer mailto: Link angezeigt)

• ServiceDesk_Phone — Telefonnummer des Service Desk im internationalen Format (wird als klickbarer tel: Link angezeigt)

Alle drei Parameter sind optional. Wenn sie konfiguriert sind, werden sie in der Fußzeile der E-Mail als klickbare Links angezeigt.

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 Accounts (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 und fügen Sie eine StorageAccount Unterabschnitt zum RJReport Block hinzu:

{
    "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-Download-Link abläuft
AddBlobNamePrefix	nein	wahr	Fügt einen Zeitstempel (yyyyMMdd-HHmmss) dem Blob-Namen voran, um Überschreibungen zu verhindern
UseRandomPrefix	nein	falsch	Verwendet statt eines Zeitstempels eine 6-stellige alphanumerische Zufallszeichenfolge als Präfix; gilt nur, wenn AddBlobNamePrefix ist wahr

Hinweis: Einstellungen, die für ein einzelnes Runbook spezifisch sind — etwa 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:

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]",
            "ServiceDesk_DisplayName": "IT Service Desk",
            "ServiceDesk_EMail": "[email protected]",
            "ServiceDesk_Phone": "[phone]",
            "StorageAccount": {
                "ResourceGroup": "rg-reports",
                "StorageAccountName": "stcontosoreports",
                "LinkExpiryDays": 6,
                "AddBlobNamePrefix": true,
                "UseRandomPrefix": false
            }
        }
    }
}