> 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-references/org/devices/report-realmjoin-agent-contact_scheduled.md).

# RealmJoin-Agent-Kontakt geplant melden

Geräte melden, deren RealmJoin-Agent keine Berichte mehr sendet

{% hint style="info" %}
Dies ist ein geplanter Runbook-Lauf. Er ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, anstatt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Planung](/de/automatisierung/runbooks/scheduling.md) für Details dazu, wie Runbook-Zeitpläne konfiguriert werden.
{% endhint %}

### Beschreibung

Vergleicht bei Windows-Geräten, wann RealmJoin das Gerät zuletzt gesehen hat, mit dem Zeitpunkt der letzten Synchronisierung mit Intune. Ein Gerät, das Intune deutlich nach dem letzten RealmJoin-Kontakt gesehen hat, deutet auf einen fehlenden, blockierten oder defekten RealmJoin-Agenten hin. Geräte, die RealmJoin nie gesehen hat, und Geräte, die nur einer Seite bekannt sind, können ebenfalls aufgelistet werden. Der Bericht kann per E-Mail gesendet oder als Download-Link bereitgestellt werden.

### So funktioniert es

Das Runbook liest zwei Listen ein und gleicht sie über die Entra-Geräte-ID ab (ersatzweise über die Intune-Geräte-ID):

* **Intune**: alle Windows-Geräte, die innerhalb der letzten *Letzte Intune-Synchronisierung innerhalb (Tage)*. Geräte, die nicht mehr mit Intune synchronisieren, werden absichtlich ausgelassen; sie gehören in den **Veraltete Geräte berichten (geplant)** Runbook.
* **RealmJoin**: die Geräteliste der RealmJoin-Kunden-API. Für jedes Gerät enthält sie die Benutzer, die der RealmJoin-Agent als angemeldet gemeldet hat, jeweils mit einem *zuletzt gesehenen* Zeitstempel. RealmJoin schreibt bei jedem Agentenbericht denselben Zeitstempel für den Benutzer und für das Gerät, daher ist der neueste dieser Werte der letzte Agentenkontakt des Geräts.

Für jedes Intune-Gerät berechnet das Runbook den **Abstand**: wie viele Tage Intune das Gerät weiterhin gesehen hat, nachdem der RealmJoin-Agent zuletzt gemeldet hat. Jedes Gerät erhält einen Status:

| Status               | Bedeutung                                                                                                                                                                                                                                                                                              |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Synchron`           | Der Agent hat erst vor Kurzem gemeldet; der Abstand liegt unter dem zulässigen Wert.                                                                                                                                                                                                                   |
| `Agent veraltet`     | Intune hat das Gerät mindestens *Zulässige Lücke seit dem letzten RealmJoin-Kontakt (Tage)* nachdem der Agent zuletzt gemeldet hat. Das Gerät wurde verwendet, während der Agent nicht gemeldet hat: Der Agent fehlt, wird von einem Proxy oder einer Firewall blockiert, läuft nicht oder ist defekt. |
| `Nie gesehen`        | RealmJoin kennt das Gerät, aber der Agent hat darauf noch nie einen angemeldeten Benutzer gemeldet, etwa ein Gerät, das registriert und nie verwendet wurde, oder ein Kiosk.                                                                                                                           |
| `MissingInRealmJoin` | Das Gerät existiert in Intune, aber nicht in RealmJoin: Der Agent hat es nie registriert.                                                                                                                                                                                                              |
| `MissingInIntune`    | Das Gerät existiert in RealmJoin, hat aber innerhalb des Synchronisierungsfensters nicht mit Intune synchronisiert. Nicht zusammen mit einem Geräte-Namenspräfix verfügbar, da RealmJoin-Geräte keinen Gerätenamen zum Abgleich mitführen.                                                             |

`Agent veraltet` ist immer Teil des Berichts. Die anderen Kategorien werden mit den *Einbeziehen ...* Optionen aktiviert. Die Registerkarte „Ausgabedaten“ des Laufs zeigt eine Zusammenfassung und je eine Tabelle pro Kategorie; die Berichtsdateien enthalten dieselben Zeilen.

Ob die Primärbenutzer eines Geräts übereinstimmen und wer sich daran anmeldet, sind unterschiedliche Fragen; das **Abweichung des primären Benutzers berichten (geplant)** Runbook beantwortet sie.

#### Warum der Abstand und nicht das Alter

Ein Vergleich des RealmJoin-Zeitstempels mit heute würde jedes Gerät auflisten, das einfach ausgeschaltet ist, zum Beispiel während der Ferien. Der Abstand vergleicht die beiden Quellen miteinander: Ein Gerät, das auch Intune nicht gesehen hat, ist ebenfalls kein Problem des RealmJoin-Agenten. Nur ein Gerät, das weiterhin mit Intune spricht, während RealmJoin nichts hört, weist auf den Agenten hin. Der Standardwert von 14 Tagen entspricht dem Punkt, an dem das RealmJoin Portal ein Gerät als veraltet markiert.

#### Was der RealmJoin-Zeitstempel bedeutet

Der RealmJoin-Agent läuft im Kontext des angemeldeten Benutzers und meldet alle 15 Minuten, solange jemand angemeldet ist. Jeder Bericht aktualisiert den *zuletzt gesehenen* dieses Benutzers auf diesem Gerät sowie des Geräts selbst. Ein Gerät ohne angemeldeten Benutzer, zum Beispiel ein Kioskgerät, ein gemeinsam genutztes Gerät ohne angemeldetes Konto oder ein Gerät, das nur für Updates eingeschaltet wird, erzeugt keinen neuen Zeitstempel und kann als `Agent veraltet` erscheinen, obwohl der Agent in Ordnung ist. Schließen Sie solche Geräte mit *Geräte aus Gruppe ausschließen*aus, oder erhöhen Sie die zulässige Lücke.

Das *Zuletzt gesehen* Die Spalte „Zuletzt gesehen“ im RealmJoin Portal ist nicht derselbe Wert: Das Portal zeigt den neuesten Wert aus Agentenkontakt, Intune-Synchronisierung und Entra ID-Anmeldeaktivität. Dieser Bericht verwendet absichtlich nur den Agentenkontakt, weil nur dieser zeigt, ob der Agent funktioniert.

#### Plausibilitätslinie

Das Runbook liest außerdem die eigenen Client-Statistiken von RealmJoin und gibt aus, wie viele Clients RealmJoin als aktiv zählt. Der Schwellwert hinter dieser Zahl ist eine Tenant-Einstellung von RealmJoin (standardmäßig 90 Tage), daher ist die Zahl in der Regel höher als die Anzahl der hier synchronen Geräte; eine große Abweichung in die andere Richtung bedeutet, dass das Synchronisierungsfenster oder die zulässige Lücke für den Tenant zu eng eingestellt ist.

### Einrichtung der RealmJoin-API-Anmeldedaten

Das Runbook fragt die RealmJoin-Kunden-API ab und benötigt dafür eine dedizierte Anmeldeinformation, die im Azure Automation Account gespeichert ist. Dieselbe Anmeldeinformation wird von jedem Runbook verwendet, das die API nutzt, daher ist dies eine einmalige Einrichtung pro Automation Account.

1. **API-Anmeldedaten abrufen** - Wenn Sie noch keine RealmJoin-API-Anmeldedaten haben, fordern Sie sie unter <support@realmjoin.com> an. Der Benutzername hat das Format `t-<Tenant-ID>`, das Kennwort ist das API-Geheimnis. Eine Portal-Anmeldung funktioniert hier nicht.
2. **Nach der Gerätebenutzerfunktion fragen** - Die Geräteliste der Kunden-API ist eine Funktion, die RealmJoin pro Tenant aktiviert. Bitten Sie den Support, sie zusammen mit den Anmeldedaten zu aktivieren; ohne sie antwortet die API mit HTTP 403 und das Runbook bricht mit dieser Meldung ab.
3. **Öffnen Sie das Automation Account** - Öffnen Sie im Azure Portal das für Runbooks verwendete Automation Account.
4. **Gehen Sie zu Freigegebene Ressourcen > Anmeldeinformationen** - Klicken Sie im linken Menü unter *Freigegebene Ressourcen*, auf *Anmeldeinformationen*.
5. **Neue Anmeldeinformation hinzufügen** - Klicken Sie auf *Anmeldeinformation hinzufügen*.
6. **Benennen Sie sie genau `RJAPI`** - Das Runbook sucht genau nach diesem Namen; jeder andere Name führt dazu, dass die Suche nach der Anmeldeinformation fehlschlägt.
7. **Geben Sie den API-Benutzernamen und das Geheimnis ein** - Verwenden Sie die Werte aus Schritt 1.
8. **Speichern** - Klicken Sie auf *Erstellen* und führen Sie das Runbook erneut aus.

Die API erlaubt 30 Anfragen pro Minute pro Tenant und antwortet darüber hinaus mit HTTP 429. Das Runbook benötigt pro Ausführung zwei Anfragen und wiederholt eine gedrosselte Anfrage nach einer kurzen Verzögerung bis zu fünfmal, bevor es aufgibt.

### Berichtszustellung

Die Ergebnisse erscheinen im Tab Output Data des Laufs im RealmJoin-Portal immer als benannte Tabellen. Berichtsdateien werden nur erzeugt, wenn die **Berichtszustellung** Option eine E-Mail und/oder einen Download-Link enthält; *Nur Ausgabedaten* werden keine Berichtsdateien erstellt. E-Mail-Zustellung und die Generierung des Download-Links sind unabhängig und können kombiniert werden.

Für den Downloadlink werden die Berichtsdateien in den in den Azure Storage Account hochgeladen, der in den `RJReport.StorageAccount.*` Tenant-Einstellungen konfiguriert ist, und zeitlich begrenzte SAS-Downloadlinks werden zurückgegeben. Der Speicher-Upload authentifiziert sich mit der verwalteten Identität des Automation-Kontos; diese Identität benötigt die **Reader and Data Access** RBAC-Rolle auf dem Ziel-Storage Account (dies ist eine Azure-RBAC-Zuweisung, keine Graph-Anwendungsberechtigung).

### Konfiguration für den E-Mail-Versand

Das Senden eines Berichts per E-Mail ist optional und erfolgt nur, wenn *Den Bericht auch per E-Mail senden* oder *Den Bericht auch per E-Mail senden & Downloadlink* als Berichtsversand ausgewählt ist; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus dem `RJReport.EmailSender` Mandanteneinstellung bezogen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph-API zu senden, müssen Sie eine vorhandene E-Mail-Adresse in der Runbook-Anpassung konfigurieren.

Siehe die [RealmJoin Report Settings Dokumentation](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details zu allen verfügbaren Einstellungen.

#### E-Mail-Branding

Die Bericht-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Mandanteneinstellungen:

* **Kopf- und Fußzeilenbild** - öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Fußzeilenlink** - Ziel des Fußzeilenbilds
* **Akzent- und Textfarbe** - 6-stellige Hexwerte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert die Berichts-E-Mail nie - stattdessen wird der entsprechende Standardwert verwendet.

Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Planung

Führen Sie den Bericht wöchentlich aus. Beginnen Sie mit dem Standardwert von 14 Tagen für die zulässige Lücke und einem Synchronisierungsfenster von 30 Tagen; verringern Sie die Lücke, sobald die Liste sauber ist, oder erhöhen Sie sie, wenn Geräte mit langen Leerlaufzeiten weiter auftauchen.

Eine Anpassung, die beide Werte festlegt und den Bericht per E-Mail zustellt:

```json
"rjgit-org_devices_report-realmjoin-agent-contact_scheduled": {
    "parameters": {
        "SyncThresholdDays": {
            "Default": 30
        },
        "AgentContactThresholdDays": {
            "Default": 14
        },
        "EmailTo": {
            "Default": "endpoint-team@contoso.com"
        }
    }
}
```

Siehe die [Runbook-Anpassungsleitfaden](https://docs.realmjoin.com/automation/runbooks/runbook-customization) für die Syntax.

### Hinweise und Einschränkungen

* Es werden nur Windows-Geräte verglichen, da der RealmJoin-Agent unter Windows ausgeführt wird.
* Die Kunden-API von RealmJoin stellt weder die Agentenversion noch die Intune-Synchronisierungszeit pro Gerät bereit; der Vergleich basiert auf dem oben beschriebenen Agentenkontakt.
* Der in den Tabellen angezeigte Intune-Primärbenutzer ist der in Intune erfasste Benutzer, nicht notwendigerweise der Benutzer, den der Agent zuletzt gesehen hat; beide werden für die `Agent veraltet` Zeilen aufgeführt.

### Speicherort

Organisation → Geräte → Realmjoin Agentenkontakt-Bericht (geplant)

**Voller Runbook-Name**

rjgit-org\_devices\_report-realmjoin-agent-contact\_scheduled

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 1.0.0                                                                                                              |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planbar              | ja                                                                                                                 |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Liest die Windows-Geräte in Intune mit ihrem Primärbenutzer und ihrer letzten Synchronisierungszeit für den Vergleich*
  * GroupMember.Read.All
    * *Liest die Geräte-Mitglieder der optionalen Ein- und Ausschlussgruppen, die den Umfang einschränken*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die Berichts-E-Mail über Send-RjRbReportEmail, wenn die E-Mail-Zustellung ausgewählt ist*
  * Organization.Read.All *(optional — Funktion: E-Mail-Bericht)*
    * *Liest den Anzeigenamen des Tenant für den E-Mail-Betreff, den E-Mail-Text und die Dateinamen des Berichts*

#### Hinweise zu Berechtigungen

RealmJoin customer API: ein Anmeldeinformationseintrag im Automation Account mit dem API-Benutzernamen (t-) des Tenants und dem Geheimnis, bereitgestellt vom RealmJoin-Support RealmJoin customer API: Die Gerätebenutzerfunktion der API muss für den Tenant vom RealmJoin-Support aktiviert sein (sonst antwortet die Geräteliste mit HTTP 403) Azure Storage Account: die Rolle 'Reader and Data Access' für die verwaltete Identität des Automation Account auf dem Ziel-Storage Account - der Upload ruft die Konto-Schlüssel über listKeys ab (nur für die Download-Link-Optionen erforderlich)

### Parameter

#### SyncThresholdDays

Es werden nur Geräte verglichen, die innerhalb dieser Anzahl von Tagen mit Intune synchronisiert haben. Geräte, die gar nicht mehr synchronisieren, gehören stattdessen in den Bericht über veraltete Geräte.

| Eigenschaft           | Wert                                            |
| --------------------- | ----------------------------------------------- |
| Erforderlich          | falsch                                          |
| Standardwert          | 30                                              |
| Typ                   | Int32                                           |
| Anzeigename im Portal | Letzte Intune-Synchronisierung innerhalb (Tage) |

#### AgentContactThresholdDays

Ein Gerät gilt als veraltet, wenn Intune es mindestens so viele Tage nach dem letzten Mal von RealmJoin gesehen hat. Kurze Lücken sind normal, da der Agent nur meldet, solange ein Benutzer angemeldet ist.

| Eigenschaft           | Wert                                                      |
| --------------------- | --------------------------------------------------------- |
| Erforderlich          | falsch                                                    |
| Standardwert          | 14                                                        |
| Typ                   | Int32                                                     |
| Anzeigename im Portal | Zulässige Lücke seit dem letzten RealmJoin-Kontakt (Tage) |

#### DeviceNamePrefix

Nur Geräte, deren Name mit diesem Text beginnt. Für alle leer lassen.

| Eigenschaft           | Wert              |
| --------------------- | ----------------- |
| Erforderlich          | falsch            |
| Standardwert          |                   |
| Typ                   | Zeichenfolge      |
| Anzeigename im Portal | Gerätenamenpräfix |

#### IncludeAgentStale

Listet Geräte auf, die Intune deutlich später gesehen hat als RealmJoin zuletzt, ein Zeichen für einen Agenten, der nicht mehr meldet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Wahr                                            |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### IncludeNeverSeen

Listet Geräte auf, die RealmJoin kennt, auf denen aber noch nie ein angemeldeter Benutzer gesehen wurde, zum Beispiel Geräte, die zwar registriert, aber noch nicht verwendet wurden.

| Eigenschaft           | Wert                                                |
| --------------------- | --------------------------------------------------- |
| Erforderlich          | falsch                                              |
| Standardwert          | Wahr                                                |
| Typ                   | Boolesch                                            |
| Anzeigename im Portal | Geräte einschließen, die RealmJoin nie gesehen hat? |

**Portaloptionen**

| Portaloption | Wert   |
| ------------ | ------ |
| Ja           | wahr   |
| Nein         | falsch |

#### IncludeMissingInRealmJoin

Listet Geräte auf, die in Intune existieren, aber nicht in RealmJoin.

| Eigenschaft           | Wert                                          |
| --------------------- | --------------------------------------------- |
| Erforderlich          | falsch                                        |
| Standardwert          | Falsch                                        |
| Typ                   | Boolesch                                      |
| Anzeigename im Portal | Geräte einschließen, die in RealmJoin fehlen? |

**Portaloptionen**

| Portaloption | Wert   |
| ------------ | ------ |
| Ja           | wahr   |
| Nein         | falsch |

#### IncludeMissingInIntune

Listet Geräte auf, die in RealmJoin existieren, aber innerhalb des Synchronisierungsfensters nicht mit Intune synchronisiert haben. Nicht zusammen mit einem Gerätenamenpräfix verfügbar.

| Eigenschaft           | Wert                                       |
| --------------------- | ------------------------------------------ |
| Erforderlich          | falsch                                     |
| Standardwert          | Falsch                                     |
| Typ                   | Boolesch                                   |
| Anzeigename im Portal | Geräte einschließen, die in Intune fehlen? |

**Portaloptionen**

| Portaloption | Wert   |
| ------------ | ------ |
| Ja           | wahr   |
| Nein         | falsch |

#### IncludeDeviceGroup

Nur Geräte in dieser Entra ID-Gruppe. Für alle Geräte leer lassen.

| Eigenschaft           | Wert                           |
| --------------------- | ------------------------------ |
| Erforderlich          | falsch                         |
| Standardwert          |                                |
| Typ                   | Zeichenfolge                   |
| Anzeigename im Portal | Geräte aus Gruppe einschließen |

#### ExcludeDeviceGroup

Überspringt Geräte in dieser Entra ID-Gruppe, zum Beispiel Kiosk- oder gemeinsam genutzte Geräte, die selten einen angemeldeten Benutzer haben. Leer lassen, um keine zu überspringen.

| Eigenschaft           | Wert                           |
| --------------------- | ------------------------------ |
| Erforderlich          | falsch                         |
| Standardwert          |                                |
| Typ                   | Zeichenfolge                   |
| Anzeigename im Portal | Geräte aus Gruppe ausschließen |

#### EmailFrom

Absenderadresse der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.EmailSender übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingHeaderImageUrl

Kopfzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Kopfbereich verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterImageUrl

Fußzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird die standardmäßige RealmJoin-Fußzeile verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterLink

Link hinter dem Fußzeilenbild der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingAccentColor

Akzentfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingTextColor

Textfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### SendEmailReport

Sendet den Bericht an die E-Mail-Adresse des Empfängers.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### EmailTo

Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere durch Kommas; jeder Empfänger erhält eine separate E-Mail.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Empfänger-E-Mail-Adresse(n)                     |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ReportFileFormat

Liefern Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | CSV & XLSX                                      |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Berichtsdateiformat                             |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

**Portaloptionen**

| Portaloption | Wert       |
| ------------ | ---------- |
| CSV & XLSX   | CSV & XLSX |
| Nur CSV      | Nur CSV    |
| Nur XLSX     | Nur XLSX   |

#### CreateDownloadLink

Lädt den Bericht außerdem hoch und gibt einen Downloadlink zurück, der nach einigen Tagen abläuft.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ContainerName

Speichercontainer, in den die Berichtsdateien hochgeladen werden. Pro Runbook festlegen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | report-realmjoin-agent-contact                  |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### StorageAccountName

Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | 6                                               |
| Typ                    | Int32                                           |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/runbooks/runbook-references.md)


---

# 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-references/org/devices/report-realmjoin-agent-contact_scheduled.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.