> 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/general/add-primary-users-of-devices-to-group_scheduled.md).

# Primäre Benutzer von Geräten zu Gruppe hinzufügen, geplant

Eine Gruppe mit den primären Benutzern von Intune-Geräten synchron halten

{% 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

Sammelt die primären Benutzer aller Intune-Geräte der ausgewählten Plattformen und hält eine Entra ID-Gruppe mit ihnen synchron. Benutzer ohne passendes Gerät werden entfernt, sofern die Entfernung nicht deaktiviert ist. Eine Einschlussgruppe beschränkt, welche Benutzer berechtigt sind, eine Ausschlussgruppe blockiert Benutzer. Ein Nur-Bericht-Modus zeigt die Änderungen vorab per E-Mail an, ohne etwas anzuwenden.

### Häufige Anwendungsfälle

* Die Ausrichtung einer Verteilungs- oder Conditional Access-Zielgruppe auf „wer derzeit ein verwaltetes Gerät hat“, gefiltert nach Plattform, durch einen erweiterten OData-Filter oder durch einen Einschluss-/Ausschlussgruppenbereich.
* Validierung eines neuen oder geänderten Filters oder Bereichs, bevor er in eine Produktionsgruppe schreiben darf.

Ein täglicher Zeitplan wird empfohlen.

### Nur-Bericht-Modus für Piloten und Tests

Aktivieren `ReportOnly` um denselben Hinzufügen-/Entfernen-Diff zu berechnen, den ein echter Lauf erzeugen würde, ohne irgendeine Änderung an der Gruppe vorzunehmen. Stattdessen wird eine Markdown-Vorschau-E-Mail, die die betroffenen Benutzer nach UPN auflistet, an `EmailTo`: jede Liste (würde hinzugefügt werden, würde entfernt werden) zeigt im E-Mail-Text höchstens 10 Benutzer, mit einem „... und N weitere“ Hinweis, wenn eine Liste länger ist, und die vollständigen Listen sind als Berichtsdatei(en) im von `ReportFileFormat`. Einmal in diesem Modus ausführen, nachdem die Plattformauswahl geändert wurde, `AdvancedFilter` oder die Einschluss-/Ausschlussgruppen, überprüfen Sie die Vorschau, und deaktivieren Sie dann `ReportOnly` damit die Synchronisierung angewendet wird.

### Parameterwechselwirkungen

* `AdvancedFilter`, wenn festgelegt, ersetzt die Plattformauswahl Windows/macOS/iOS/Android vollständig, statt sie mit ihr zu kombinieren.
* `RemoveUsersWhenNoDeviceMatch` steuert sowohl den echten Lauf als auch die `ReportOnly` Vorschau: wenn deaktiviert, werden in keinem der beiden Fälle Benutzer entfernt, sodass die Vorschau immer widerspiegelt, was ein echter Lauf tun würde.

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

Der Versand eines E-Mail-Berichts ist optional und erfolgt nur, wenn die `ReportOnly` Option aktiviert ist; ein Empfänger (`EmailTo`) ist dann 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. jeweils 200 KB
* **Footer-Link** – Ziel des Footer-Bildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, 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 die Berichts-E-Mail niemals – stattdessen wird der entsprechende Standard verwendet.

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

### Ort

Organisation → Allgemein → Primäre Benutzer von Geräten zur Gruppe hinzufügen (Geplant)

**Vollständiger Runbook-Name**

rjgit-org\_general\_add-primary-users-of-devices-to-group\_scheduled

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Liest Intune-verwaltete Geräte, gefiltert nach Betriebssystem, um den primären Benutzer jedes Geräts zu erfassen*
  * Group.Read.All
    * *Validiert die Ziel-/Einschluss-/Ausschlussgruppen und liest ihre Mitgliedslisten*
  * GroupMember.ReadWrite.All
    * *Fügt Benutzer in der Zielgruppe hinzu und entfernt sie daraus über gebündelte /groups/{id}/members/$ref-Aufrufe*
  * User.Read.All
    * *Liest die Mitglieds-ID und den UPN, um Benutzer-Mitglieder zu identifizieren und Entfernungen zu protokollieren*

### Parameter

#### TargetGroupId

Gruppe, die die primären Benutzer erhält. Ihre Mitgliedschaft wird ausschließlich von diesem Runbook verwaltet.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | wahr         |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Zielgruppe   |

#### Windows

Schließt die primären Benutzer von Windows-Geräten ein.

| Eigenschaft           | Wert                        |
| --------------------- | --------------------------- |
| Erforderlich          | falsch                      |
| Standardwert          | Falsch                      |
| Typ                   | Boolesch                    |
| Anzeigename im Portal | Windows-Geräte einbeziehen? |

#### macOS

Schließt die primären Benutzer von macOS-Geräten ein.

| Eigenschaft           | Wert                      |
| --------------------- | ------------------------- |
| Erforderlich          | falsch                    |
| Standardwert          | Falsch                    |
| Typ                   | Boolesch                  |
| Anzeigename im Portal | macOS-Geräte einbeziehen? |

#### iOS

Schließt die primären Benutzer von iOS- und iPadOS-Geräten ein.

| Eigenschaft           | Wert                     |
| --------------------- | ------------------------ |
| Erforderlich          | falsch                   |
| Standardwert          | Falsch                   |
| Typ                   | Boolesch                 |
| Anzeigename im Portal | iOS-Geräte einschließen? |

#### Android

Schließt die primären Benutzer von Android-Geräten ein.

| Eigenschaft           | Wert                         |
| --------------------- | ---------------------------- |
| Erforderlich          | falsch                       |
| Standardwert          | Falsch                       |
| Typ                   | Boolesch                     |
| Anzeigename im Portal | Android-Geräte einschließen? |

#### AdvancedFilter

OData-Filter für die Geräte statt der Plattform-Schalter, z. B. startsWith(deviceName,'FWP-') und operatingSystem eq 'Windows'.

| Eigenschaft           | Wert                       |
| --------------------- | -------------------------- |
| Erforderlich          | falsch                     |
| Standardwert          |                            |
| Typ                   | Zeichenfolge               |
| Anzeigename im Portal | Benutzerdefinierter Filter |

#### RemoveUsersWhenNoDeviceMatch

Entfernt Benutzer aus der Zielgruppe, wenn sie nicht mehr primärer Benutzer eines passenden Geräts sind. Deaktivieren, um nur hinzuzufügen.

| Eigenschaft           | Wert                                     |
| --------------------- | ---------------------------------------- |
| Erforderlich          | falsch                                   |
| Standardwert          | Wahr                                     |
| Typ                   | Boolesch                                 |
| Anzeigename im Portal | Benutzer ohne passendes Gerät entfernen? |

#### IncludeGroupId

Nur Mitglieder dieser Gruppe können der Zielgruppe hinzugefügt werden.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Benutzer aus Gruppe einbeziehen              |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### ExcludeGroupId

Mitglieder dieser Gruppe werden niemals hinzugefügt und werden bei Vorhandensein entfernt.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Benutzer aus Gruppe ausschließen             |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### ReportOnly

Zeigt die Änderungen ohne Anwendung an. Die Vorschau erfolgt per E-Mail, mit den ersten 10 Benutzern pro Liste im Text und den vollständigen Listen als Anhang.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | falsch       |
| Standardwert          | Falsch       |
| Typ                   | Boolesch     |
| Anzeigename im Portal | Nur-Bericht? |

#### 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) |

#### EmailTo

Adresse, an die die Vorschau gesendet wird. Nur im Nur-Bericht-Modus verwendet.

| Eigenschaft           | Wert                      |
| --------------------- | ------------------------- |
| Erforderlich          | falsch                    |
| Standardwert          |                           |
| Typ                   | Zeichenfolge              |
| Anzeigename im Portal | Vorschaubericht senden an |

#### ReportFileFormat

Die vollständigen Listen als CSV, als Excel-Arbeitsmappe oder beides anhängen. Nur im Nur-Bericht-Modus verwendet.

| Eigenschaft           | Wert                              |
| --------------------- | --------------------------------- |
| Erforderlich          | falsch                            |
| Standardwert          | CSV & XLSX                        |
| Typ                   | Zeichenfolge                      |
| Anzeigename im Portal | Format der Vorschau-Berichtsdatei |

**Portaloptionen**

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

[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/general/add-primary-users-of-devices-to-group_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.
