> 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/fr/automatisation/runbooks/runbook-references/org/general/add-primary-users-of-devices-to-group_scheduled.md).

# Ajouter les utilisateurs principaux des appareils à un groupe planifié

Maintenir un groupe synchronisé avec les utilisateurs principaux des appareils Intune

{% hint style="info" %}
Il s'agit d'un runbook planifié. Il est conçu pour s'exécuter selon une planification récurrente plutôt que d'être déclenché pour un seul objet. Voir [Planification](/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook.
{% endhint %}

### Description

Collecte les utilisateurs principaux de tous les appareils Intune des plateformes choisies et maintient un groupe Entra ID synchronisé avec eux. Les utilisateurs sans appareil correspondant sont supprimés, sauf si la suppression est désactivée. Un groupe d’inclusion limite les utilisateurs éligibles, un groupe d’exclusion bloque les utilisateurs. Un mode rapport uniquement prévisualise les changements par e-mail sans rien appliquer.

### Cas d’utilisation courants

* Maintenir un groupe cible de distribution ou de Conditional Access aligné sur « qui possède actuellement un appareil géré », filtré par plateforme, par un filtre OData avancé ou par un périmètre de groupe d’inclusion/exclusion.
* Valider un filtre ou un périmètre nouveau ou modifié avant qu’il soit autorisé à écrire dans un groupe de production.

Une planification quotidienne est recommandée.

### Mode rapport uniquement pour les pilotes et les tests

Activer `ReportOnly` pour calculer le même diff d’ajout/suppression qu’une exécution réelle produirait, sans appliquer de modification au groupe. À la place, un e-mail d’aperçu en Markdown listant les utilisateurs concernés par UPN est envoyé à `EmailTo`: chaque liste (qui seraient ajoutés, qui seraient supprimés) affiche au maximum 10 utilisateurs dans le corps du message, avec une mention « ... et N de plus » lorsqu’une liste est plus longue, et les listes complètes sont jointes en tant que fichier(s) de rapport dans le format choisi par `ReportFileFormat`. Exécutez-le une fois dans ce mode après avoir modifié la sélection de plateforme, `AdvancedFilter` ou les groupes d’inclusion/exclusion, examinez l’aperçu, puis désactivez `ReportOnly` pour laisser la synchronisation s’appliquer.

### Interactions des paramètres

* `AdvancedFilter`, lorsqu’il est défini, remplace entièrement la sélection de plateforme Windows/macOS/iOS/Android au lieu de la combiner avec elle.
* `RemoveUsersWhenNoDeviceMatch` contrôle à la fois l’exécution réelle et l’ `ReportOnly` aperçu : lorsqu’il est désactivé, aucun utilisateur n’est supprimé dans les deux cas, de sorte que l’aperçu reflète toujours ce qu’une exécution réelle ferait.

### Configuration de l’envoi d’e-mails

L'envoi d'un rapport par e-mail est facultatif et ne se produit que lorsque le `ReportOnly` option est activée ; un destinataire (`EmailTo`) est alors requis. L'adresse de l'expéditeur est prise à partir de la `RJReport.EmailSender` paramètre Tenant.

Ce runbook envoie des e-mails à l’aide de l’API Microsoft Graph. Pour envoyer des e-mails via l’API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Voir la [documentation des paramètres de rapport RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails sur tous les paramètres disponibles.

#### Branding des e-mails

L’e-mail du rapport prend en compte l’optionnel `RJReport.Branding.*` paramètres Tenant :

* **Image d’en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune
* **Lien de pied de page** – cible de l’image de pied de page
* **Couleur d’accent et de texte** – valeurs hexadécimales à 6 chiffres, par ex. `#0052cc`

Lorsque ces paramètres ne sont pas configurés, les graphismes et couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur non valide, n’empêche jamais l’envoi de l’e-mail du rapport : le défaut correspondant est utilisé à la place.

Instructions de configuration et exigences relatives aux images : [Branding des e-mails](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Emplacement

Organisation → Général → Ajouter les utilisateurs principaux des appareils au groupe (planifié)

**Nom complet du runbook**

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

### Détails

| Propriété      | Valeur                                                                                   |
| -------------- | ---------------------------------------------------------------------------------------- |
| Version        | 1.2.0                                                                                    |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Planifiable    | oui                                                                                      |

### Autorisations

#### Autorisations d’application

* **Type**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lit les appareils gérés Intune filtrés par système d’exploitation pour récupérer l’utilisateur principal de chaque appareil*
  * Group.Read.All
    * *Valide les groupes cible/d’inclusion/d’exclusion et lit leurs listes de membres*
  * GroupMember.ReadWrite.All
    * *Ajoute et supprime des utilisateurs dans le groupe cible via des appels groupés /groups/{id}/members/$ref*
  * User.Read.All
    * *Lit l’ID du membre et l’UPN pour identifier les membres utilisateurs et consigner les suppressions*

### Paramètres

#### TargetGroupId

Groupe qui reçoit les utilisateurs principaux. Son appartenance est gérée uniquement par ce runbook.

| Propriété                  | Valeur       |
| -------------------------- | ------------ |
| Obligatoire                | vrai         |
| Valeur par défaut          |              |
| Type                       | Chaîne       |
| Nom d’affichage du portail | Groupe cible |

#### Windows

Inclut les utilisateurs principaux des appareils Windows.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | faux                            |
| Valeur par défaut          | Faux                            |
| Type                       | Booléen                         |
| Nom d’affichage du portail | Inclure les appareils Windows ? |

#### macOS

Inclut les utilisateurs principaux des appareils macOS.

| Propriété                  | Valeur                        |
| -------------------------- | ----------------------------- |
| Obligatoire                | faux                          |
| Valeur par défaut          | Faux                          |
| Type                       | Booléen                       |
| Nom d’affichage du portail | Inclure les appareils macOS ? |

#### iOS

Inclut les utilisateurs principaux des appareils iOS et iPadOS.

| Propriété                  | Valeur                      |
| -------------------------- | --------------------------- |
| Obligatoire                | faux                        |
| Valeur par défaut          | Faux                        |
| Type                       | Booléen                     |
| Nom d’affichage du portail | Inclure les appareils iOS ? |

#### Android

Inclut les utilisateurs principaux des appareils Android.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | faux                            |
| Valeur par défaut          | Faux                            |
| Type                       | Booléen                         |
| Nom d’affichage du portail | Inclure les appareils Android ? |

#### AdvancedFilter

Filtre OData pour les appareils à la place des commutateurs de plateforme, par exemple startsWith(deviceName,'FWP-') and operatingSystem eq 'Windows'.

| Propriété                  | Valeur              |
| -------------------------- | ------------------- |
| Obligatoire                | faux                |
| Valeur par défaut          |                     |
| Type                       | Chaîne              |
| Nom d’affichage du portail | Filtre personnalisé |

#### RemoveUsersWhenNoDeviceMatch

Supprime les utilisateurs du groupe cible lorsqu’ils ne sont plus l’utilisateur principal d’un appareil correspondant. Désactivez cette option pour n’effectuer que des ajouts.

| Propriété                  | Valeur                                                   |
| -------------------------- | -------------------------------------------------------- |
| Obligatoire                | faux                                                     |
| Valeur par défaut          | Vrai                                                     |
| Type                       | Booléen                                                  |
| Nom d’affichage du portail | Supprimer les utilisateurs sans appareil correspondant ? |

#### IncludeGroupId

Seuls les membres de ce groupe peuvent être ajoutés au groupe cible.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Inclure les utilisateurs du groupe                 |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### ExcludeGroupId

Les membres de ce groupe ne sont jamais ajoutés et sont supprimés s’ils sont présents.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Exclure les utilisateurs du groupe                 |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### ReportOnly

Prévisualise les changements sans les appliquer. L’aperçu est envoyé par e-mail, avec les 10 premiers utilisateurs par liste dans le corps du message et les listes complètes en pièce jointe.

| Propriété                  | Valeur               |
| -------------------------- | -------------------- |
| Obligatoire                | faux                 |
| Valeur par défaut          | Faux                 |
| Type                       | Booléen              |
| Nom d’affichage du portail | Rapport uniquement ? |

#### EmailFrom

Adresse de l’expéditeur de l’e-mail du rapport. Prise dans le paramètre Tenant RJReport.EmailSender.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingHeaderImageUrl

Image d’en-tête de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.HeaderImageUrl ; l’en-tête RealmJoin par défaut est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterImageUrl

Image de pied de page de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterLink

Lien derrière l’image de pied de page de l’e-mail du rapport. Pris dans le paramètre Tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingAccentColor

Couleur d’accent de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingTextColor

Couleur du texte de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### EmailTo

Adresse à laquelle l’aperçu est envoyé. Utilisée uniquement en mode rapport uniquement.

| Propriété                  | Valeur                        |
| -------------------------- | ----------------------------- |
| Obligatoire                | faux                          |
| Valeur par défaut          |                               |
| Type                       | Chaîne                        |
| Nom d’affichage du portail | Envoyer le rapport d’aperçu à |

#### ReportFileFormat

Joindre les listes complètes au format CSV, dans un classeur Excel, ou les deux. Utilisée uniquement en mode rapport uniquement.

| Propriété                  | Valeur                                |
| -------------------------- | ------------------------------------- |
| Obligatoire                | faux                                  |
| Valeur par défaut          | CSV et XLSX                           |
| Type                       | Chaîne                                |
| Nom d’affichage du portail | Format du fichier de rapport d’aperçu |

**Options du portail**

| Option du portail | Valeur          |
| ----------------- | --------------- |
| CSV et XLSX       | CSV et XLSX     |
| CSV uniquement    | CSV uniquement  |
| XLSX uniquement   | XLSX uniquement |

[Retour à l’aperçu de la référence du runbook](/fr/automatisation/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/fr/automatisation/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.