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

### Beschreibung

Dieses Runbook erfasst die primären Benutzer aller von Intune verwalteten Geräte, die mit der/den ausgewählten Plattform(en) übereinstimmen, und synchronisiert sie in eine Ziel-Entra ID-Gruppe. Benutzer, denen auf keinem passenden Gerät mehr ein primärer Benutzer zugewiesen ist, werden aus der Gruppe entfernt. Eine optionale Einschlussgruppe schränkt ein, welche Benutzer berechtigt sind, und eine optionale Ausschlussgruppe verhindert, dass bestimmte Benutzer hinzugefügt werden, oder sorgt dafür, dass sie entfernt bleiben.

### Speicherort

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
  * Group.Read.All
  * GroupMember.ReadWrite.All
  * User.Read.All

### Parameter

#### TargetGroupId

Die Entra ID-Gruppe, in die primäre Benutzer synchronisiert werden sollen. Mitglieder dieser Gruppe werden ausschließlich von diesem Runbook verwaltet.

| Eigenschaft  | Wert   |
| ------------ | ------ |
| Erforderlich | true   |
| Standardwert |        |
| Typ          | String |

#### Windows

Primäre Benutzer von Windows-Geräten einschließen. (Verwendeter OData-Filter "operatingSystem eq 'Windows'")

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | False   |
| Typ          | Boolean |

#### MacOS

Primäre Benutzer von macOS-Geräten einschließen. (Verwendeter OData-Filter "operatingSystem eq 'macOS'")

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | False   |
| Typ          | Boolean |

#### iOS

Primäre Benutzer von iOS- und iPadOS-Geräten einschließen. (Verwendeter OData-Filter "operatingSystem eq 'iOS'")

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | False   |
| Typ          | Boolean |

#### Android

Primäre Benutzer von Android-Geräten einschließen. (Verwendeter OData-Filter "operatingSystem eq 'Android'")

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | False   |
| Typ          | Boolean |

#### AdvancedFilter

Optional. Benutzerdefinierter OData-Filter, der beim Abrufen von Geräten angewendet wird. Überschreibt die plattformbasierten Filter, sofern angegeben. Beispiel: startsWith(deviceName,'FWP-') and operatingSystem eq 'Windows' .

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

#### RemoveUsersWhenNoDeviceMatch

Wenn aktiviert (Standard), werden Benutzer, die kein primäres Gerät mehr haben, das mit der/den ausgewählten Plattform(en) übereinstimmt, aus der Zielgruppe entfernt. Deaktivieren, um in den Nur-Hinzufügen-Modus zu wechseln — bestehende Mitglieder werden niemals entfernt.

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | True    |
| Typ          | Boolean |

#### IncludeGroupId

Optional. Nur Benutzer, die Mitglieder dieser Gruppe sind, können der Zielgruppe hinzugefügt werden. Leer lassen, um alle primären Benutzer zu berücksichtigen.

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

#### ExcludeGroupId

Optional. Benutzer, die Mitglieder dieser Gruppe sind, werden nicht hinzugefügt und aus der Zielgruppe entfernt, wenn sie bereits vorhanden sind.

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

[Zurück zur Übersicht der Runbook-Referenz](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references)