> 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-windows-devices-without-autopilot_scheduled.md).

# Geplante Berichterstattung über Windows-Geräte ohne Autopilot

### Beschreibung

Dieses Runbook listet jedes Windows-Geräteobjekt in Entra ID (Microsoft Entra) auf und gleicht es mit den Windows Autopilot-Geräteidentitäten in Intune ab. Entra-Geräte, deren Geräte-ID von keinem Autopilot-Objekt referenziert wird (über die azureActiveDirectoryDeviceId des Autopilot-Objekts), werden als verwaist gemeldet.

Solche verwaisten Entra-Geräteobjekte sind typische Reste ("Objektleichen") von Geräten, die zurückgesetzt, neu aufgesetzt oder ersetzt wurden, ohne bereinigt zu werden. Der Bericht unterstützt Bereinigungsmaßnahmen, indem er diese Kandidaten sichtbar macht, damit sie geprüft und – falls angebracht – gelöscht werden können.

Optional können die Berichtsdateien in ein Azure Storage Account hochgeladen werden (wobei zeitlich begrenzte Download-Links zurückgegeben werden) und/oder per E-Mail mit den ausgewählten Bericht-Dateiformaten als Anhang versendet werden. Der Parameter ReportFileFormat steuert, welche Dateiformate erzeugt und ausgeliefert werden (nur CSV, CSV & XLSX oder nur XLSX). Wenn der CSV-Anhang das E-Mail-Größenlimit überschreitet und "CSV & XLSX" ausgewählt ist, greift die E-Mail stattdessen nur auf die Excel-Arbeitsmappe zurück.

### Berichterstellung über verwaiste Windows-Geräte

Dieses Runbook listet jedes Windows-Geräteobjekt in Entra ID auf und gleicht es mit den Windows Autopilot-Geräteidentitäten in Intune ab. Geräte, die kein zugehöriges Autopilot-Objekt haben (abgeglichen über die `azureActiveDirectoryDeviceId`) werden als Kandidaten für eine Bereinigung ("Objektleichen") gemeldet.

Zwei Ja/Nein-Schalter steuern die Ausgabe:

* **Bericht per E-Mail senden?** — wenn aktiviert, wird das Feld für die Empfängeradresse (`EmailTo`) angezeigt und der Bericht wird mit der CSV im Anhang per E-Mail versendet.
* **Datei-Download-Link erstellen?** — wenn aktiviert, wird die CSV in ein Azure Storage Account hochgeladen und ein zeitlich begrenzter Download-Link zurückgegeben.

Beide können kombiniert oder unabhängig voneinander verwendet werden. Wenn beide deaktiviert sind, wird der Bericht nur in die Runbook-Ausgabe geschrieben.

### Einrichtung bezüglich des Storage Account

Der CSV-Bericht wird in ein Azure Storage Account hochgeladen. Das Ziel-Storage Account wird aus den gemeinsamen **RJReport** Tenant-Einstellungen abgeleitet, sodass es einmal konfiguriert und über alle Berichts-Runbooks hinweg wiederverwendet werden kann:

* `RJReport.StorageAccount.ResourceGroup`
* `RJReport.StorageAccount.StorageAccountName`
* `RJReport.StorageAccount.LinkExpiryDays` (optional, standardmäßig 6)

Der Name des Containers wird pro Runbook konfiguriert (Parameter `ContainerName`, Standard `windows-devices-without-autopilot`) und ist absichtlich nicht Teil der globalen RJReport-Einstellungen.

Siehe die [RealmJoin-Dokumentation zu den Berichtseinstellungen](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details.

Die verwaltete Identität des Runbooks benötigt mindestens `Contributor` Zugriff auf das Abonnement oder die Ressourcengruppe, die das Storage Account enthält.

### Einrichtung zum E-Mail-Versand

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (`EmailTo`) angegeben ist. Die Absenderadresse wird aus der `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 eine vorhandene E-Mail-Adresse in der Runbook-Anpassung konfigurieren.

Siehe die [RealmJoin-Dokumentation zu den Berichtseinstellungen](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details.

### Ort

Organisation → Geräte → Windows-Geräte ohne Autopilot melden (geplant)

**Vollständiger Runbook-Name**

rjgit-org\_devices\_report-windows-devices-without-autopilot\_scheduled

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Device.Read.All
  * DeviceManagementServiceConfig.Read.All
  * Organization.Read.All
  * Mail.Send

#### Berechtigungshinweise

Azure IaaS: - Contributor - Zugriff auf das Abonnement oder die Ressourcengruppe, die für den Export verwendet wird

### Parameter

#### E-Mail senden

Wenn aktiviert, wird der Bericht per E-Mail mit den ausgewählten Berichtsdateiformaten als Anhang gesendet. Beim Aktivieren werden die Felder für die Empfängeradresse und das Berichtsdateiformat angezeigt.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | Falsch   |
| Typ          | Boolesch |

#### EmailTo

Empfängeradresse(n) für den E-Mail-Bericht. Wird nur verwendet / angezeigt, wenn SendMail aktiviert ist. Kann eine einzelne Adresse oder mehrere durch Kommas getrennte Adressen sein (Zeichenfolge).

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### EmailFrom

Die Absender-E-Mail-Adresse. Stammt aus den RJReport-Tenant-Einstellungen (RJReport.EmailSender).

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### ReportFileFormat

Steuert, welche Berichtsdateiformate generiert und bereitgestellt werden: "Nur CSV", "CSV & XLSX" (Standard) oder "Nur XLSX".

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert | CSV & XLSX   |
| Typ          | Zeichenfolge |

#### CreateDownloadLink

Wenn aktiviert, werden die Berichtsdateien in ein Azure Storage Account hochgeladen und zeitlich begrenzte Download-Links zurückgegeben.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### ContainerName

Name des Speichercontainers, der für den Upload verwendet wird. Pro Runbook konfiguriert (keine globale RJReport-Einstellung).

| Eigenschaft  | Wert                              |
| ------------ | --------------------------------- |
| Erforderlich | false                             |
| Standardwert | windows-devices-without-autopilot |
| Typ          | Zeichenfolge                      |

#### ResourceGroupName

Ressourcengruppe, die das Storage Account enthält. Wird aus den Tenant-Einstellungen von RJReport bezogen.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### StorageAccountName

Name des Storage Account, der für den Upload verwendet wird. Wird aus den Tenant-Einstellungen von RJReport bezogen.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### LinkExpiryDays

Anzahl der Tage, bis der generierte Download-Link abläuft. Wird aus den Tenant-Einstellungen von RJReport bezogen.

| Eigenschaft  | Wert  |
| ------------ | ----- |
| Erforderlich | false |
| Standardwert | 6     |
| Typ          | Int32 |

[Zurück zur Übersicht der Runbook-Referenzen](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/devices/report-windows-devices-without-autopilot_scheduled.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.