> 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 geplantes Runbook. Es ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, statt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Zeitplanung](https://docs.realmjoin.com/de/automatisierung/runbooks/scheduling.md) für Details zur Konfiguration von Runbook-Zeitplänen.
{% 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 später gesehen hat als RealmJoin zuletzt, deutet auf einen fehlenden, blockierten oder defekten RealmJoin-Agenten hin. Auch Geräte, die RealmJoin nie gesehen hat, sowie Geräte, die nur einer Seite bekannt sind, können aufgeführt werden. Der Bericht kann per E-Mail versendet oder als Downloadlink bereitgestellt werden.

### So funktioniert es

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

* **Intune**: alle Windows-Geräte, die innerhalb der letzten *Intune letzte Synchronisierung innerhalb von (Tagen)*. Geräte, die die Synchronisierung mit Intune eingestellt haben, werden absichtlich ausgelassen; sie gehören in den **Bericht über veraltete Geräte (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 an den Benutzer und an das Gerät, sodass der neueste dieser Werte der letzte Agentenkontakt des Geräts ist.

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

| Status               | Bedeutung                                                                                                                                                                                                                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Synchron`           | Der Agent hat kürzlich genug berichtet; der Abstand liegt unter dem zulässigen Wert.                                                                                                                                                                                                              |
| `AgentVeraltet`      | Intune hat das Gerät mindestens *Zulässige Lücke zu RealmJoin bei letzter Sichtung (Tage)* nachdem der Agent zuletzt gemeldet hatte. Das Gerät war im Einsatz, während der Agent nicht meldete: 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, zum Beispiel 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 nicht innerhalb des Synchronisierungsfensters mit Intune synchronisiert. Nicht zusammen mit einem Geräte-Namenspräfix verfügbar, da RealmJoin-Geräte keinen Gerätenamen zur Zuordnung tragen.                                                          |

`AgentVeraltet` ist immer Teil des Berichts. Die anderen Kategorien werden mit den *Einbeziehen ...* Auswahlmöglichkeiten. Die Registerkarte Ausgabedaten der Ausführung zeigt eine Zusammenfassung und eine Tabelle pro Kategorie; die Berichtsdateien enthalten dieselben Zeilen.

Ob die Primärbenutzer eines Geräts übereinstimmen und wer sich darauf anmeldet, sind unterschiedliche Fragen; das **Bericht über Abweichungen beim primären Benutzer (geplant)** Runbook beantwortet sie.

#### Warum der Abstand und nicht das Alter

Der Vergleich des RealmJoin-Zeitstempels mit dem heutigen Datum würde jedes Gerät auflisten, das einfach ausgeschaltet ist, etwa während des Urlaubs. Der Abstand vergleicht die beiden Quellen miteinander: Ein Gerät, das Intune ebenfalls nicht gesehen hat, ist kein Problem des RealmJoin-Agenten. Nur ein Gerät, das weiter mit Intune kommuniziert, während RealmJoin nichts hört, weist auf den Agenten hin. Die Standardeinstellung 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* Zeitstempel dieses Benutzers auf diesem Gerät und des Geräts selbst. Ein Gerät ohne angemeldeten Benutzer, beispielsweise 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 `AgentVeraltet` obwohl der Agent in Ordnung ist. Schließen Sie solche Geräte mit *Geräte aus Gruppe ausschließen*, oder erhöhen Sie den zulässigen Abstand.

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

#### Plausibilitätszeile

Das Runbook liest außerdem die eigenen Clientstatistiken von RealmJoin aus und gibt aus, wie viele Clients RealmJoin als aktiv zählt. Der Schwellenwert hinter dieser Zählung ist eine Tenant-Einstellung von RealmJoin (standardmäßig 90 Tage), daher ist die Zahl in der Regel höher als die Anzahl der hier synchronisierten Geräte; ein großer Unterschied in die andere Richtung bedeutet, dass das Synchronisierungsfenster oder der zulässige Abstand für den Tenant zu eng eingestellt ist.

### Einrichtung für RealmJoin-API-Anmeldedaten

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

1. **API-Anmeldedaten abrufen** - Wenn du noch keine RealmJoin-API-Anmeldedaten hast, fordere sie unter <support@realmjoin.com> an. Der Benutzername hat das Format `t-<tenant id>`, das Kennwort ist das API-Geheimnis. Eine Anmeldung im Portal funktioniert hier nicht.
2. **Nach der Funktion für Gerätebenutzer fragen** - Die Geräteliste der Kunden-API ist eine Funktion, die RealmJoin pro Tenant aktiviert. Bitte 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. **Das Automation Account öffnen** - Öffne im Azure Portal das Automation Account, das für Runbooks verwendet wird.
4. **Zu Gemeinsame Ressourcen > Anmeldeinformationen gehen** - Klicke im linken Menü unter *Gemeinsame Ressourcen*, auf *Anmeldeinformationen*.
5. **Neue Anmeldeinformation hinzufügen** - Klicke auf *Anmeldeinformation hinzufügen*.
6. **Benenne sie exakt `RJAPI`** - Das Runbook sucht genau nach diesem Namen; jeder andere Name führt zum Fehlschlagen der Anmeldeinformationssuche.
7. **API-Benutzername und Geheimnis eingeben** - Verwende die Werte aus Schritt 1.
8. **Speichern Sie** - Klicke auf *Erstellen* und führe 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 zwei Anfragen pro Lauf und wiederholt eine gedrosselte Anfrage nach einer kurzen Verzögerung bis zu fünfmal, bevor es aufgibt.

### Berichtsübermittlung

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

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

### Einrichtung in Bezug auf den E-Mail-Versand

Das Senden eines Berichts per E-Mail ist optional und erfolgt nur, wenn *Den Bericht zusätzlich per E-Mail senden* oder *Den Bericht zusätzlich per E-Mail und Downloadlink senden* ist als Berichtsübermittlung ausgewählt; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus dem `RJReport.EmailSender` Tenant-Einstellung übernommen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Anpassung des Runbooks eine vorhandene E-Mail-Adresse 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 Berichts-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Tenant-Einstellungen:

* **Header- und Footer-Bild** - öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Footer-Link** - Ziel des Footer-Bildes
* **Akzent- und Textfarbe** - 6-stellige Hexwerte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die Berichts-E-Mail – stattdessen wird der entsprechende Standard verwendet.

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

### Zeitplanung

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

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

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

Siehe die [Anleitung zur Runbook-Anpassung](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 läuft.
* 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 primäre Benutzer in Intune ist der in Intune erfasste Benutzer, nicht unbedingt der Benutzer, den der Agent zuletzt gesehen hat; beide sind für die `AgentVeraltet` Zeilen aufgeführt.

### Ort

Organisation → Geräte → Bericht zum RealmJoin-Agentenkontakt (geplant)

**Vollständiger Runbook-Name**

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

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 1.1.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ären Benutzer und der letzten Synchronisierungszeit für den Vergleich*
  * GroupMember.Read.All
    * *Liest die Geräte-Mitglieder der optionalen Ein- und Ausschlussgruppen, die den Umfang eingrenzen*
  * 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-Kunden-API: Eine Automation-Account-Anmeldeinformation namens 'RJAPI' mit dem API-Benutzernamen des Tenants (t-) und dem von RealmJoin-Support ausgestellten Geheimnis. RealmJoin-Kunden-API: Die Funktion für Gerätebenutzer der API muss für den Tenant von RealmJoin-Support aktiviert werden (andernfalls antwortet die Geräteliste mit HTTP 403) Azure Storage Account: Rolle 'Reader and Data Access' für die verwaltete Identität des Automation Accounts im Ziel-Storage Account - der Upload ruft die Kontoschlüssel über listKeys ab (nur für die Download-Link-Optionen erforderlich)

### Parameter

#### SyncThresholdDays

Nur Geräte, die sich innerhalb dieser Anzahl von Tagen mit Intune synchronisiert haben, werden verglichen. Geräte, die die Synchronisierung ganz eingestellt haben, gehören stattdessen in den Bericht über veraltete Geräte.

| Eigenschaft           | Wert                                                 |
| --------------------- | ---------------------------------------------------- |
| Erforderlich          | falsch                                               |
| Standardwert          | 30                                                   |
| Typ                   | Int32                                                |
| Anzeigename im Portal | Intune letzte Synchronisierung innerhalb von (Tagen) |

#### AgentContactThresholdDays

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

| Eigenschaft           | Wert                                                     |
| --------------------- | -------------------------------------------------------- |
| Erforderlich          | falsch                                                   |
| Standardwert          | 14                                                       |
| Typ                   | Int32                                                    |
| Anzeigename im Portal | Zulässige Lücke zu RealmJoin bei letzter Sichtung (Tage) |

#### DeviceNamePrefix

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

| 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; das ist ein Zeichen für einen Agenten, der nicht mehr meldet.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | Wahr                                         |
| Typ                    | Boolesch                                     |
| Im Portal ausgeblendet | ja (vordefiniert ü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 einbeziehen, die RealmJoin nie gesehen hat? |

**Portaloptionen**

| Portaloption | Wert   |
| ------------ | ------ |
| Ja           | wahr   |
| Kein         | 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   |
| Kein         | falsch |

#### IncludeMissingInIntune

Listet Geräte auf, die in RealmJoin existieren, aber innerhalb des Synchronisierungsfensters nicht mit Intune synchronisiert wurden. Nicht zusammen mit einem Geräte-Namensprä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   |
| Kein         | falsch |

#### IncludeDeviceGroup

Nur Geräte in dieser Entra ID-Gruppe. Leer lassen für alle Geräte.

| 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 nur 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 Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.EmailSender übernommen.

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

#### BrandingHeaderImageUrl

Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Header verwendet.

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

#### BrandingFooterImageUrl

Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Footer verwendet.

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

#### BrandingFooterLink

Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

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

#### BrandingAccentColor

Akzentfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### BrandingTextColor

Textfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### SendEmailReport

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

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

#### EmailTo

Senden Sie den Bericht an diese Adressen. Mehrere mit Kommas trennen; 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 (vordefiniert über die Runbook-Anpassung) |

#### ReportFileFormat

Stellt den Bericht als CSV, als Excel-Arbeitsmappe oder beides bereit.

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

**Portaloptionen**

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

#### CreateDownloadLink

Lädt den Bericht zusätzlich 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 (vordefiniert über die Runbook-Anpassung) |

#### ContainerName

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

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

#### ResourceGroupName

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

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

#### StorageAccountName

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

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

#### SubscriptionId

Abonnement-ID des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.SubscriptionId übernommen; wenn leer, wird das Abonnement verwendet, bei dem sich die verwaltete Identität anmeldet.

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

#### LinkExpiryDays

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

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

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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.
