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

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 per E-Mail in der Vorschau an, ohne etwas anzuwenden.

### Häufige Anwendungsfälle

* Eine Verteiler- oder Conditional Access-Zielgruppe mit „wer derzeit ein verwaltetes Gerät hat“ synchron halten, gefiltert nach Plattform, durch einen erweiterten OData-Filter oder durch einen Einschluss-/Ausschluss-Gruppenbereich.
* Validiert einen neuen oder geänderten Filter oder Bereich, bevor er in eine Produktionsgruppe schreiben darf.

Ein täglicher Zeitplan wird empfohlen.

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

Aktivieren `Nur-Bericht` um dieselbe Hinzufügen-/Entfernen-Differenz zu berechnen, die ein echter Lauf erzeugen würde, ohne eine Änderung an der Gruppe vorzunehmen. Stattdessen wird eine Markdown-Vorschau-E-Mail mit den betroffenen Benutzern nach UPN 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 werden als Berichtsdatei(en) im von `ReportFileFormat`. Führe nach dem Ändern der Plattformauswahl diesen Modus einmal aus, `Erweiterter Filter` oder der Einschluss-/Ausschluss-Gruppen, überprüfe die Vorschau und deaktiviere dann `Nur-Bericht` damit die Synchronisierung angewendet wird.

### Parameterinteraktionen

* `Erweiterter Filter`, ersetzt, wenn gesetzt, die Plattformauswahl Windows/macOS/iOS/Android vollständig, statt sie damit zu kombinieren.
* `RemoveUsersWhenNoDeviceMatch` steuert sowohl den echten Lauf als auch die `Nur-Bericht` Vorschau: Wenn deaktiviert, werden in beiden Fällen keine Benutzer entfernt, sodass die Vorschau immer dem entspricht, was ein echter Lauf tun würde.

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

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn die `Nur-Bericht` Option aktiviert ist; ein Empfänger (`EmailTo`) ist dann erforderlich. Die Absenderadresse wird aus der `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ßzeilenbildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, 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 niemals die Bericht-E-Mail – stattdessen wird der entsprechende Standardwert verwendet.

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

### Speicherort

Organization → General → Add Primary Users Of Devices To Group (Scheduled)

**Voller 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 nach Betriebssystem gefilterte Intune-verwaltete Geräte, um den primären Benutzer jedes Geräts zu erfassen*
  * Group.Read.All
    * *Validiert die Ziel-/Einschluss-/Ausschlussgruppen und liest ihre Mitgliederlisten*
  * GroupMember.ReadWrite.All
    * *Fügt Benutzer in der Zielgruppe über gebündelte /groups/{id}/members/$ref-Aufrufe hinzu und entfernt sie*
  * User.Read.All
    * *Liest die Mitglieder-ID und UPN, um Benutzer-Mitglieder zu identifizieren und Entfernungen zu protokollieren*

### Parameter

#### TargetGroupId

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

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

#### Windows

Enthält die primären Benutzer von Windows-Geräten.

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

#### MacOS

Enthält die primären Benutzer von macOS-Geräten.

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

#### iOS

Enthält die primären Benutzer von iOS- und iPadOS-Geräten.

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

#### Android

Enthält die primären Benutzer von Android-Geräten.

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

#### Erweiterter Filter

OData-Filter für die Geräte anstelle der Plattform-Schalter, zum Beispiel 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? |

#### Einschlussgruppen-ID

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

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

#### ExcludeGroupId

Mitglieder dieser Gruppe werden nie hinzugefügt und werden entfernt, wenn sie vorhanden sind.

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

#### Nur-Bericht

Zeigt die Änderungen in der Vorschau an, ohne sie anzuwenden. Die Vorschau wird per E-Mail versendet; im Nachrichtentext stehen die ersten 10 Benutzer pro Liste, die vollständigen Listen sind angehängt.

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

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

#### EmailTo

Die 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 | Dateiformat des Vorschauberichts |

**Portaloptionen**

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

[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/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.