> 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](https://docs.realmjoin.com/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 des utilisateurs. Un mode rapport uniquement prévisualise les changements par e-mail sans appliquer quoi que ce soit.

### 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 une portée de groupe d’inclusion/exclusion.
* Validation d’un nouveau filtre ou d’une nouvelle portée, ou d’un filtre ou d’une portée modifiés, avant d’être autorisé à écrire dans un groupe de production.

Une planification quotidienne est recommandée.

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

Activer `Rapport uniquement` pour calculer le même diff d’ajout/suppression qu’une exécution réelle produirait, sans appliquer aucun changement au groupe. À la place, un e-mail d’aperçu en Markdown listant les utilisateurs concernés par UPN est envoyé à `EmailTo`: chaque liste (à ajouter, à supprimer) affiche au maximum 10 utilisateurs dans le corps du message, avec une indication « ... 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 une fois dans ce mode après avoir modifié la sélection de plateforme, `Filtre avancé` ou les groupes d’inclusion/exclusion, examinez l’aperçu, puis désactivez `Rapport uniquement` pour laisser la synchronisation s’appliquer.

### Interactions entre paramètres

* `Filtre avancé`, lorsqu’il est défini, remplace entièrement la sélection de plateforme Windows/macOS/iOS/Android au lieu de la combiner avec elle.
* `Supprimer les utilisateurs lorsqu’aucun appareil ne correspond` contrôle à la fois l’exécution réelle et l’ `Rapport uniquement` 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 relative à l'envoi d'e-mails

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

Ce runbook envoie des e-mails en utilisant 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 RealmJoin Report Settings](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 tient compte des paramètres facultatifs du `RJReport.Branding.*` Tenant :

* **Image d'en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, max. 200 Ko chacune
* **Lien du 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 graphiques 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 invalide, n'empêche jamais l'envoi de l'e-mail du rapport – la valeur par défaut correspondante est utilisée à 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 par Intune filtrés par système d’exploitation afin de collecter 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 le 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                | false                           |
| 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                | false                         |
| 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                | false                       |
| 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                | false                           |
| Valeur par défaut          | Faux                            |
| Type                       | Booléen                         |
| Nom d'affichage du portail | Inclure les appareils Android ? |

#### Filtre avancé

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

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

#### Supprimer les utilisateurs lorsqu’aucun appareil ne correspond

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

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

#### ID du groupe d’inclusion

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

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | false                                              |
| 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                | false                                              |
| 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) |

#### Rapport uniquement

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                | false                |
| 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 du paramètre Tenant RJReport.EmailSender.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| 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, max 200 Ko). Prise du paramètre Tenant RJReport.Branding.HeaderImageUrl ; l'en-tête RealmJoin par défaut est utilisé lorsqu'il est vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| 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, max 200 Ko). Prise du paramètre Tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé lorsqu'il est vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| 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 du paramètre Tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé lorsqu'il est vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| 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 du paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée lorsqu'elle est vide ou invalide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| 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 du paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée lorsqu'elle est vide ou invalide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| 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                | false                         |
| 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, sous forme de classeur Excel ou les deux. Utilisé uniquement en mode rapport uniquement.

| Propriété                  | Valeur                                |
| -------------------------- | ------------------------------------- |
| Obligatoire                | false                                 |
| 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](https://docs.realmjoin.com/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.
