> 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/sync-shared-channel-owners_scheduled.md).

# Synchronisation planifiée des propriétaires de Shared Channel

S'assurer que les membres d'un Security Group sont propriétaires des Teams mappées et de leurs Shared Channel.

{% hint style="info" %}
Ceci est 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 objet unique. Voir [Planification](/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook.
{% endhint %}

### Description

Les canaux partagés Teams n’héritent pas de la propriété de leur équipe parente. Ce runbook planifié comble cette lacune : pour chaque équipe nommée dans un mappage, il s’assure que les membres d’un groupe de sécurité mappé sont propriétaires de l’équipe et de chaque canal partagé hébergé par l’équipe. Le mappage du nom de l’équipe vers le groupe de propriétaires est géré de façon centralisée dans un paramètre d’organisation RealmJoin. Le runbook est en ajout uniquement - les propriétaires et membres existants ne sont jamais supprimés - ainsi les canaux partagés nouvellement créés sont simplement pris en compte lors de l’exécution suivante. Il peut éventuellement envoyer un rapport par e-mail et/ou téléverser les fichiers du rapport sous forme de lien de téléchargement. Le paramètre ReportFileFormat contrôle les formats de fichiers de rapport générés et remis (CSV uniquement, CSV et XLSX, ou XLSX uniquement). Lorsque les pièces jointes CSV dépassent la limite de taille des e-mails et que « CSV & XLSX » est sélectionné, l’e-mail retombe sur le classeur Excel seul. Consultez la documentation d’accompagnement pour les règles de mappage et la configuration.

### Fonctionnement

À chaque exécution, le runbook :

1. Lit le mappage du nom d’équipe vers le groupe de propriétaires depuis le paramètre d’organisation `SharedChannelOwners.Mapping`.
2. Pour chaque entrée, recherche l’équipe par son **nom d’affichage exact**.
3. Développe le groupe de propriétaires de cette entrée jusqu’à ses **utilisateurs** membres transitifs (les invités sont ignorés - ils ne peuvent pas appartenir à un canal partagé).
4. S’assure que ces utilisateurs sont propriétaires de l’équipe et de chaque **canal partagé** hébergé

Le runbook est **en ajout uniquement**: il ne rétrograde ni ne supprime jamais les propriétaires ou membres existants. Les canaux partagés nouvellement créés sont donc pris en compte automatiquement lors de l’exécution planifiée suivante, sans perturber ce qui est déjà en place.

#### Configuration du mappage

Le mappage est stocké de manière centralisée dans les paramètres d’organisation RealmJoin (Personnalisation du runbook → `Paramètres` → `SharedChannelOwners.Mapping`) `{ TeamName, OwnerGroupId }` objets, où `TeamName` est le **nom d’affichage exact de l’équipe** (voir la *Notes* section pour un exemple prêt à l’emploi). Le `TeamOwnerGroupMapping` paramètre masqué est injecté à partir de ce paramètre ; le runbook l’accepte soit comme tableau structuré (forme de sous-paramètre recommandée), soit comme chaîne JSON, et normalise les deux.

#### Correspondance des équipes

Chaque entrée de mappage cible une équipe explicitement nommée :

* Une équipe est mise en correspondance par son **nom d’affichage exact** (insensible à la casse, conformément à Microsoft Graph ; les espaces de début et de fin dans le nom configuré sont ignorés). Seule cette équipe est traitée - il n’y a pas de comportement de préfixe ni de caractère générique, donc nommer une entrée `EXT Service A` n’affecte jamais `EXT Service A Backup` ou similaire.
* Les noms d’affichage ne sont pas garantis uniques dans Entra ID. Si plusieurs équipes partagent le nom configuré, le groupe de propriétaires est appliqué à **toutes** d’entre elles. Si aucune équipe ne correspond, l’entrée est signalée comme *introuvable* et ignorée.

#### Sélection des équipes

Pour chaque `TeamName` configuré, le runbook exécute une requête Graph `displayName eq '...'` et ne conserve que les groupes Microsoft 365 provisionnés comme **une équipe**.

#### Ce qui est modifié

* **Équipe (facultatif, `IncludeTeamOwners`, par défaut activé) :** les utilisateurs du groupe de propriétaires sont ajoutés comme propriétaires et membres du groupe M365 parent. L’appartenance à l’équipe est également le prérequis technique pour devenir propriétaire d’un canal partagé, donc cette étape active l’étape du canal.
* **Canaux partagés :** pour chaque canal partagé hébergé (`membershipType eq 'shared'`), chaque utilisateur du groupe de propriétaires est garanti comme **propriétaire** du canal - ajouté directement s’il est absent, ou promu s’il est déjà membre. Si l’ajout direct d’un propriétaire est rejeté (par ex. retard de réplication de l’appartenance), le runbook se rabat sur l’ajout de l’utilisateur comme membre d’abord, puis sur sa promotion.

#### Exécution à blanc

Définissez **`WhatIfMode`** pour journaliser ce qui changerait sans rien écrire. Dans ce mode, le runbook affiche à l’avance les équipes qu’il traiterait (avec leur groupe de propriétaires) et les noms d’équipe configurés qui n’ont pas été trouvés.

#### Rapport (facultatif, les deux désactivés par défaut)

* **`SendEmailReport`** envoie un e-mail brandé RealmJoin (via `Send-RjReportEmail`) avec les statistiques d’exécution et deux pièces jointes CSV : un résumé par équipe et une liste détaillée des changements. L’expéditeur est pris depuis le paramètre `RJReport.EmailSender` .
* **`CreateDownloadLink`** téléverse les mêmes CSV dans un compte de stockage et renvoie des liens de téléchargement SAS à durée limitée (également intégrés dans l’e-mail lorsque les deux options sont activées). Le compte de stockage cible est pris depuis les paramètres `RJReport.StorageAccount.*` .

Le téléversement vers le compte de stockage s’authentifie avec l’identité managée du compte Automation ; cette identité a besoin du rôle RBAC **Storage Account Contributor** sur le compte de stockage cible (il s’agit d’une affectation Azure RBAC, pas d’une autorisation d’application Graph).

#### Planification

Conçu pour s’exécuter sans surveillance selon un planning. Comme la configuration est centralisée dans les paramètres d’organisation et que le runbook est en ajout uniquement et idempotent, un seul planning récurrent permet de maintenir synchronisés tous les Teams mappés et leurs canaux partagés au fur et à mesure que des personnes et des canaux arrivent et partent.

### Branding des e-mails

Le courriel de rapport respecte les paramètres facultatifs `RJReport.Branding.*` du tenant :

* **Image d’en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune
* **Lien du pied de page** – cible de l’image de pied de page
* **Couleur d’accent et du 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 du courriel de 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 → Synchroniser les propriétaires de canaux partagés (planifié)

**Nom complet du runbook**

rjgit-org\_general\_sync-shared-channel-owners\_scheduled

### Détails

| Propriété      | Valeur                                                                                                            |
| -------------- | ----------------------------------------------------------------------------------------------------------------- |
| Version        | 1.3.0                                                                                                             |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)<br>Az.Accounts (>= 5.5.2)</p> |
| Planifiable    | oui                                                                                                               |

### Notes

Configurez le mappage une fois de manière centralisée (Personnalisation du runbook -> Paramètres) comme sous-paramètre structuré sous "SharedChannelOwners.Mapping". Chaque entrée nomme une équipe par son nom d’affichage exact. Le paramètre masqué TeamOwnerGroupMapping est injecté à partir de celui-ci à l’exécution. { "Settings": { "SharedChannelOwners": { "Mapping": \[ { "TeamName": "EXT Service A", "OwnerGroupId": "11111111-1111-1111-1111-111111111111" }, { "TeamName": "EXT Service B", "OwnerGroupId": "22222222-2222-2222-2222-222222222222" } ] } } }

### Autorisations

#### Autorisations d'application

* **Type**: Microsoft Graph
  * Group.ReadWrite.All
    * *Liste les équipes, lit les propriétaires du groupe et ajoute les propriétaires d’équipe manquants via /groups/{id}/owners/$ref*
  * GroupMember.ReadWrite.All
    * *Lit les membres transitifs du groupe de propriétaires et ajoute d’abord les utilisateurs comme membres de l’équipe*
  * Channel.ReadBasic.All
    * *Liste /teams/{id}/channels pour trouver les canaux partagés à traiter*
  * ChannelMember.ReadWrite.All
    * *Lit les membres du canal et ajoute des utilisateurs ou les promeut au rang de propriétaire de canal partagé*
  * Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Envoie l’e-mail de rapport de synchronisation via Send-RjReportEmail lorsque EmailTo est configuré*
  * User.Read.All
    * *Lit les propriétés des utilisateurs membres (UPN, userType) via transitiveMembers pour filtrer les invités*
  * Organization.Read.All *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Lit le nom d’affichage du Tenant pour l’e-mail de rapport*

### Paramètres

#### TeamOwnerGroupMapping

Correspondance d’un nom d’affichage exact d’équipe vers l’ID d’objet d’un groupe de sécurité propriétaire, par ex. \[{ "TeamName": "EXT Service A", "OwnerGroupId": "00000000-0000-0000-0000-000000000000" }]. Paramètre masqué, lié au paramètre d’organisation "SharedChannelOwners.Mapping". Le portail RealmJoin injecte cette valeur ; le runbook l’accepte soit comme objet/tableau désérialisé (sous-paramètres structurés), soit comme chaîne JSON, et normalise les deux.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut | \[]    |
| Type              | Objet  |

#### IncludeTeamOwners

Lorsqu’il est activé (par défaut), les membres du groupe de propriétaires sont également garantis comme propriétaires et membres de l’équipe parente elle-même (propriétaires/membres du groupe M365). L’appartenance à l’équipe est également le prérequis pour la propriété du canal.

| Propriété         | Valeur  |
| ----------------- | ------- |
| Obligatoire       | false   |
| Valeur par défaut | True    |
| Type              | Booléen |

#### WhatIfMode

Lorsqu’il est activé, le runbook journalise seulement les changements qu’il ferait, sans rien écrire.

| Propriété         | Valeur  |
| ----------------- | ------- |
| Obligatoire       | false   |
| Valeur par défaut | Faux    |
| Type              | Booléen |

#### SendEmailReport

Lorsqu’il est activé, un rapport par e-mail brandé RealmJoin est envoyé via Send-RjReportEmail après l’exécution. Le corps contient les statistiques d’exécution ; les fichiers de rapport (résumé par équipe et détail par changement) sont joints dans le ou les formats de fichier de rapport sélectionnés.

| Propriété         | Valeur  |
| ----------------- | ------- |
| Obligatoire       | false   |
| Valeur par défaut | Faux    |
| Type              | Booléen |

#### EmailTo

Adresse(s) e-mail du ou des destinataires pour le rapport (séparées par des virgules). Utilisé uniquement lorsque SendEmailReport est activé.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### EmailFrom

Boîte aux lettres expéditrice pour le rapport. Liée au paramètre d’organisation "RJReport.EmailSender".

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### BrandingHeaderImageUrl

URL HTTPS publique facultative d’une image d’en-tête personnalisée (PNG/JPEG/GIF, 200 Ko max.) pour le courriel de rapport. Provenant du paramètre du tenant RJReport.Branding.HeaderImageUrl. Lorsqu’elle est vide, l’image d’en-tête par défaut de RealmJoin est utilisée.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### BrandingFooterImageUrl

URL HTTPS publique facultative d’une image de pied de page personnalisée (PNG/JPEG/GIF, 200 Ko max.) pour le courriel de rapport. Provenant du paramètre du tenant RJReport.Branding.FooterImageUrl. Lorsqu’elle est vide, l’image de pied de page par défaut de RealmJoin est utilisée.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### BrandingFooterLink

URL facultative vers laquelle renvoie l’image de pied de page. Provenant du paramètre du tenant RJReport.Branding.FooterLink. Lorsqu’elle est vide, le lien par défaut (<https://www.realmjoin.com>) est utilisé.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### BrandingAccentColor

Remplacement facultatif de la couleur d’accent (hexadécimal à 6 chiffres, par ex. « #0052cc ») pour le modèle de courriel de rapport. Provenant du paramètre du tenant RJReport.Branding.AccentColor. Lorsqu’elle est vide ou invalide, la couleur d’accent par défaut de RealmJoin est utilisée.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### BrandingTextColor

Remplacement facultatif de la couleur du texte (hexadécimal à 6 chiffres) pour le modèle de courriel de rapport. Provenant du paramètre du tenant RJReport.Branding.TextColor. Lorsqu’elle est vide ou invalide, la couleur du texte par défaut de RealmJoin est utilisée.

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### ReportFileFormat

Contrôle quels formats de fichiers du rapport sont générés et livrés : « CSV only », « CSV & XLSX » (par défaut) ou « XLSX only ».

| Propriété         | Valeur     |
| ----------------- | ---------- |
| Obligatoire       | false      |
| Valeur par défaut | CSV & XLSX |
| Type              | String     |

#### CreateDownloadLink

Lorsqu’il est activé, le ou les fichiers de rapport sont téléversés vers un compte de stockage et des liens de téléchargement à durée limitée sont renvoyés (et inclus dans le rapport par e-mail si celui-ci est également activé). Désactivé par défaut.

| Propriété         | Valeur  |
| ----------------- | ------- |
| Obligatoire       | false   |
| Valeur par défaut | Faux    |
| Type              | Booléen |

#### ContainerName

Conteneur de stockage utilisé pour le téléversement. Configuré par runbook (et non comme paramètre RJReport global).

| Propriété         | Valeur                |
| ----------------- | --------------------- |
| Obligatoire       | false                 |
| Valeur par défaut | shared-channel-owners |
| Type              | String                |

#### ResourceGroupName

Groupe de ressources contenant le compte de stockage. Lié à "RJReport.StorageAccount.ResourceGroup".

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### StorageAccountName

Compte de stockage utilisé pour le téléversement. Lié à "RJReport.StorageAccount.StorageAccountName".

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut |        |
| Type              | String |

#### LinkExpiryDays

Nombre de jours avant l’expiration du lien de téléchargement généré. Lié à "RJReport.StorageAccount.LinkExpiryDays".

| Propriété         | Valeur |
| ----------------- | ------ |
| Obligatoire       | false  |
| Valeur par défaut | 6      |
| Type              | Int32  |

[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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/general/sync-shared-channel-owners_scheduled.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.