> 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/collab/report-teams-channels_scheduled.md).

# Rapport des canaux Teams planifiés

Lister les canaux privés et partagés de toutes les équipes avec leurs propriétaires

{% 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

Passe en revue chaque équipe du Tenant et répertorie ses canaux privés et partagés avec l’équipe à laquelle ils appartiennent, leurs propriétaires et, si souhaité, leurs membres. Les canaux privés ne sont pas visibles dans la vue de groupe du portail RealmJoin, donc ce rapport indique qui en est propriétaire et qui peut y accéder. Les canaux sans propriétaire sont répertoriés séparément. Le rapport peut être envoyé par e-mail ou fourni sous forme de lien de téléchargement.

### Fonctionnement

Le runbook répertorie tous les groupes Microsoft 365 provisionnés en tant qu'équipe, éventuellement filtrés par *Préfixe du nom de l'équipe*. Pour chaque équipe, il lit les canaux des types sélectionnés et, pour chaque canal, la liste des membres.

* **Canaux privés** appartiennent à une seule équipe ; seuls leurs membres les voient, et ils n'apparaissent pas dans la vue de groupe du portail RealmJoin ni dans l'appartenance au groupe de l'équipe. Ce rapport permet de les voir d’un coup d’œil.
* **Canaux partagés** sont hébergés par une équipe et peuvent être partagés avec d'autres équipes et avec des personnes d'autres locataires. Le rapport répertorie les canaux partagés qu'une équipe héberge ; les canaux partagés vers une équipe depuis ailleurs ne sont pas répétés sous cette équipe.

Chaque ligne indique l’équipe et sa visibilité, le canal, son type, s’il est archivé, la date de création, le nombre de propriétaires, de membres et de membres externes, ainsi que les propriétaires par nom et adresse e-mail. Avec *Lister aussi les membres ?* réglé sur oui, les membres sont également listés par nom ; laissez-le désactivé dans les grands locataires pour garder le rapport court.

Les canaux sans propriétaire sont répertoriés dans leur propre table et feuille de calcul. Un canal privé ou partagé continue de fonctionner sans propriétaire, mais personne ne peut gérer son appartenance depuis Teams, donc ces canaux sont les premiers candidats au nettoyage.

#### Membres externes

Un membre dont le locataire diffère du locataire d'origine est marqué *(externe)* et compté dans la *ExternalCount* colonne. Les comptes invités du locataire d'origine ne sont pas marqués, car ils sont membres du répertoire du locataire.

#### Teams et canaux qui ne peuvent pas être lus

Une équipe dont les canaux ne peuvent pas être lus, par exemple parce qu'elle a été supprimée pendant l'exécution du rapport ou parce que l'équipe est archivée et inaccessible, est répertoriée dans la *Teams non lisibles* table avec la raison et n'interrompt pas l'exécution. Un canal dont la liste des membres ne peut pas être lue conserve sa ligne avec la raison dans la *Remarque* colonne et n'est pas compté comme un canal sans propriétaire.

#### Temps d'exécution

Les canaux et les membres sont lus via des requêtes batch Graph, vingt à la fois. Un locataire avec plusieurs milliers d'équipes prend tout de même du temps ; le journal des tâches affiche la progression. Utilisez *Préfixe du nom de l'équipe* pour établir un rapport sur un sous-ensemble.

### Livraison du rapport

Les résultats apparaissent toujours sous forme de tables nommées dans l'onglet Output Data de l'exécution dans le portail RealmJoin. Les fichiers de rapport ne sont générés que lorsque l' **Livraison du rapport** option inclut un e-mail et/ou un lien de téléchargement ; *Données de sortie uniquement* ne crée aucun fichier de rapport. L'envoi par e-mail et la génération de lien de téléchargement sont indépendants et peuvent être combinés.

Pour le lien de téléchargement, les fichiers du rapport sont téléversés vers le Storage Account Azure configuré dans les `RJReport.StorageAccount.*` paramètres du Tenant, et des liens de téléchargement SAS à durée limitée sont renvoyés. Le téléversement vers le Storage Account s'authentifie avec l'identité managée du compte Automation ; cette identité a besoin du **Lecture et accès aux données** rôle RBAC sur le Storage Account cible (il s'agit d'une attribution Azure RBAC, et non d'une autorisation d'application Graph).

### 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 ; un destinataire est alors requis. L’adresse de l’expéditeur est prise à partir de `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 les 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 rapport par e-mail - 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).

### Notes et limites

* Le rapport est en lecture seule. Les propriétaires et membres des canaux privés et partagés sont modifiés dans le centre d'administration Teams ou dans Teams lui-même ; les runbooks **Synchroniser les membres du Shared Channel ou du groupe (planifié)** et **Synchroniser les propriétaires du Shared Channel (planifié)** couvrent les cas automatisés pour les canaux partagés.
* Les canaux standard ne sont pas listés ; leur appartenance correspond à l'appartenance de l'équipe, que le portail RealmJoin affiche.
* La liste des membres d'un canal partagé contient ses membres directs. Les personnes qui accèdent à un canal partagé via une autre équipe avec laquelle le canal est partagé ne sont pas listées.

### Emplacement

Organisation → Collab → Rapport Teams Channels (planifié)

**Nom complet du runbook**

rjgit-org\_collab\_report-teams-channels\_scheduled

### Détails

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

### Autorisations

#### Autorisations d'application

* **Type**: Microsoft Graph
  * Channel.ReadBasic.All
    * *Répertorie les canaux privés et partagés de chaque équipe via /teams/{id}/channels*
  * ChannelMember.Read.All
    * *Lit les membres de chaque canal listé afin de distinguer les propriétaires, les membres et les membres externes*
  * Group.Read.All
    * *Répertorie les groupes Microsoft 365 provisionnés en tant qu'équipes avec leur nom et leur visibilité*
  * Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Envoie l'e-mail du rapport via Send-RjRbReportEmail lorsque la livraison par e-mail est sélectionnée*
  * Organization.Read.All *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Lit le nom d'affichage du Tenant pour l'objet de l'e-mail, le corps de l'e-mail et les noms de fichier du rapport*

#### Remarques sur les autorisations

Azure Storage Account : rôle « Reader and Data Access » pour l'identité managée du compte Automation sur le Storage Account cible - le téléversement récupère les clés du compte via listKeys (uniquement requis pour les options de lien de téléchargement)

### Paramètres

#### IncludePrivateChannels

Répertorie les canaux privés hébergés par chaque équipe.

| Propriété                  | Valeur                      |
| -------------------------- | --------------------------- |
| Obligatoire                | false                       |
| Valeur par défaut          | Vrai                        |
| Type                       | Booléen                     |
| Nom d'affichage du portail | Inclure les canaux privés ? |

**Options du portail**

| Option du portail | Valeur |
| ----------------- | ------ |
| Oui               | vrai   |
| Aucune            | false  |

#### IncludeSharedChannels

Répertorie les canaux partagés hébergés par chaque équipe. Les membres provenant d'autres locataires sont marqués comme externes.

| Propriété                  | Valeur                        |
| -------------------------- | ----------------------------- |
| Obligatoire                | false                         |
| Valeur par défaut          | Vrai                          |
| Type                       | Booléen                       |
| Nom d'affichage du portail | Inclure les canaux partagés ? |

**Options du portail**

| Option du portail | Valeur |
| ----------------- | ------ |
| Oui               | vrai   |
| Aucune            | false  |

#### IncludeMembers

Répertorie aussi les membres de chaque canal par nom. Désactivé, ne liste que les propriétaires, ce qui permet de garder le rapport court dans les grands locataires.

| Propriété                  | Valeur                     |
| -------------------------- | -------------------------- |
| Obligatoire                | false                      |
| Valeur par défaut          | Faux                       |
| Type                       | Booléen                    |
| Nom d'affichage du portail | Lister aussi les membres ? |

**Options du portail**

| Option du portail             | Valeur |
| ----------------------------- | ------ |
| Oui, propriétaires et membres | vrai   |
| Non, propriétaires uniquement | false  |

#### TeamNamePrefix

Uniquement les équipes dont le nom commence par ce texte. Laisser vide pour toutes les équipes.

| Propriété                  | Valeur                     |
| -------------------------- | -------------------------- |
| Obligatoire                | false                      |
| Valeur par défaut          |                            |
| Type                       | Chaîne                     |
| Nom d'affichage du portail | Préfixe du nom de l'équipe |

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

#### SendEmailReport

Envoyer le rapport à l'adresse e-mail du destinataire.

| 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

Envoyez le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail distinct.

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

#### ReportFileFormat

Remettez le rapport au format CSV, sous forme de classeur Excel, ou les deux.

| 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écharge aussi le rapport et renvoie un lien de téléchargement qui expire après quelques jours.

| 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      | report-teams-channels                              |
| 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/org/collab/report-teams-channels_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.
