> 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/user/general/list-group-memberships.md).

# Lister les appartenances aux groupes

Lister les appartenances aux groupes de cet utilisateur

### Description

Répertorie les groupes dont cet utilisateur est membre, avec des filtres pour le type de groupe, le type d’appartenance, la possibilité d’assignation de rôles, Teams, la source et le writeback. Le résultat est affiché sous forme de texte CSV et de tables Output Data. Le rapport peut également être envoyé par e-mail ou fourni sous forme de lien de téléchargement. Rien n’est modifié.

### Sortie et livraison du rapport

Chaque exécution répertorie les groupes correspondants sous forme de texte CSV dans la sortie du runbook et écrit deux tables Output Data, qui peuvent être triées, filtrées et exportées dans le portail RealmJoin :

* `Résumé` - l’utilisateur, les filtres sélectionnés, le nombre d’appartenances directes à des groupes et le nombre de groupes correspondant aux filtres.
* `Appartenances aux groupes` - une ligne par groupe correspondant avec les mêmes colonnes que le fichier CSV et la `Appartenances aux groupes` feuille de calcul. Lorsqu’aucun groupe ne correspond, une ligne d’état est affichée à la place.

Le **Livraison du rapport** L’option ajoute en plus des fichiers de rapport :

* **Données de sortie uniquement** (par défaut) - aucun fichier de rapport.
* **Envoyer également le rapport par e-mail** - le champ d’adresse du destinataire (`EmailTo`) est affiché et obligatoire, et le rapport est envoyé par e-mail avec le ou les fichiers de rapport en pièce jointe.
* **Créer également un lien de téléchargement** - les fichiers de rapport sont téléversés dans un Azure Storage Account et un lien de téléchargement à durée limitée est renvoyé.
* **Envoyer également par e-mail et lien de téléchargement** - les deux.

**Format du fichier de rapport** choisit CSV, XLSX ou les deux pour les fichiers de rapport. Lorsqu’aucun groupe ne correspond aux filtres, aucun fichier de rapport n’est créé, téléversé ou envoyé par e-mail.

L’option définit les paramètres `SendMail` et `CreateDownloadLink`. Les planifications et les appels API qui transmettent directement ces paramètres continuent de fonctionner comme avant.

### Configuration du Storage Account

Pour le lien de téléchargement, les fichiers de rapport sont téléversés dans un Azure Storage Account. Le Storage Account cible est pris à partir des paramètres partagés du Tenant, afin qu’il puisse être configuré une seule fois et réutilisé dans tous les runbooks de rapport : **RJReport** tenant settings, so it can be configured once and reused across all report runbooks:

* `RJReport.StorageAccount.ResourceGroup`
* `RJReport.StorageAccount.StorageAccountName`
* `RJReport.StorageAccount.SubscriptionId` (facultatif, recommandé ; voir [Abonnement du Storage Account](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#subscription-of-the-storage-account))
* `RJReport.StorageAccount.LinkExpiryDays` (facultatif, valeur par défaut : 6)

Le nom du conteneur est configuré par runbook (paramètre `ContainerName`, valeur par défaut `user-group-memberships`). L’identité managée du compte Automation a besoin de `Lecture et accès aux données` rôle sur le Storage Account.

### Configuration relative à l'envoi d'e-mails

L'envoi d'un rapport par e-mail est facultatif et ne se produit que lorsque *Envoyer également le rapport par e-mail* ou *Envoyer également par e-mail et lien de téléchargement* est sélectionné comme mode de livraison du rapport (paramètre `SendMail`); 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

Utilisateur → Général → Lister les appartenances aux groupes

**Nom complet du runbook**

rjgit-user\_general\_list-group-memberships

### Détails

| Propriété      | Valeur                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version        | 1.8.0                                                                                                              |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planifiable    | non                                                                                                                |

### Autorisations

#### Autorisations d'application

* **Type**: Microsoft Graph
  * Group.Read.All
    * *Lit les groupes de l’utilisateur via /users/{id}/memberOf, y compris les règles d’appartenance pour le filtrage*
  * Organization.Read.All
    * *Lit /organization pour le nom d’affichage du Tenant dans le rapport par e-mail*
  * User.Read.All
    * *Résout l’utilisateur cible pour obtenir l’id et le UPN du rapport*
  * Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Envoie l’e-mail du rapport via Send-RjRbReportEmail lorsque SendMail est activé et qu’EmailTo est configuré*

### Paramètres

#### UserName

Nom principal de l'utilisateur sur lequel le runbook agit. Défini par le portail à partir de l'utilisateur sélectionné.

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

#### Type de groupe

Uniquement les groupes de sécurité, uniquement les groupes Microsoft 365, ou tous les groupes.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut | Tous   |
| Type              | Chaîne |

#### Type d’appartenance

Appartenances attribuées, appartenances dynamiques, ou toutes.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut | Tous   |
| Type              | Chaîne |

#### Assignable aux rôles

Oui limite la liste aux groupes auxquels des rôles Entra ID peuvent être attribués.

| Propriété         | Valeur     |
| ----------------- | ---------- |
| Obligatoire       | false      |
| Valeur par défaut | Non défini |
| Type              | Chaîne     |

#### Teams activé

Oui limite la liste aux groupes qui prennent en charge une équipe Microsoft Teams.

| Propriété         | Valeur     |
| ----------------- | ---------- |
| Obligatoire       | false      |
| Valeur par défaut | Non défini |
| Type              | Chaîne     |

#### Source

Groupes cloud uniquement, groupes synchronisés depuis Active Directory local, ou tous.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut | Tous   |
| Type              | Chaîne |

#### Writeback activé

Groupes avec writeback vers Active Directory local, groupes sans writeback, ou tous.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut | Tous   |
| Type              | Chaîne |

#### SendMail

Envoyer le rapport à l’adresse e-mail du destinataire. Se configure à partir du choix « Report delivery » dans le portail.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### EmailTo

Envoyer le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail séparé. Requis lorsque « Report delivery » inclut un e-mail.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | false                                              |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d'affichage du portail | Adresse(s) e-mail du destinataire                  |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

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

#### ReportFileFormat

Fournir le rapport au format CSV, sous forme de classeur Excel, ou les deux. Affiché lorsque « Report delivery » inclut un e-mail ou un lien de téléchargement.

| 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                       |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

**Options du portail**

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

#### CreateDownloadLink

Téléverser également le rapport et renvoyer un lien de téléchargement qui expire après quelques jours. Se configure à partir du choix « Report delivery » dans le portail.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ContainerName

Conteneur de stockage vers lequel les fichiers du rapport sont téléversés. À définir par runbook.

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

#### ResourceGroupName

Groupe de ressources du Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.ResourceGroup.

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

#### StorageAccountName

Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.StorageAccountName.

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

#### SubscriptionId

ID d'abonnement du Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.SubscriptionId ; lorsque vide, l'abonnement sur lequel l'identité managée se connecte est utilisé.

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

#### LinkExpiryDays

Nombre de jours pendant lesquels un lien de téléchargement reste valide. Pris à partir du paramètre du locataire RJReport.StorageAccount.LinkExpiryDays.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | 6                                                  |
| Type                   | Int32                                              |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

[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/user/general/list-group-memberships.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.
