> 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/de/automatisierung/runbooks/runbook-references/org/collab/report-teams-channels_scheduled.md).

# Teams-Kanäle geplant melden

Private und freigegebene Kanäle aller Teams mit ihren Besitzern auflisten

{% hint style="info" %}
Dies ist ein geplanter Runbook-Lauf. Er ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, anstatt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Planung](/de/automatisierung/runbooks/scheduling.md) für Details dazu, wie Runbook-Zeitpläne konfiguriert werden.
{% endhint %}

### Beschreibung

Geht jedes Team im Mandanten durch und listet seine privaten und Shared Channel mit dem Team, zu dem sie gehören, ihren Besitzern und, falls gewünscht, ihren Mitgliedern auf. Private Kanäle sind in der Gruppenansicht des RealmJoin Portal nicht sichtbar, daher zeigt dieser Bericht, wem sie gehören und wer auf sie zugreifen kann. Kanäle ohne Besitzer werden separat aufgeführt. Der Bericht kann per E-Mail gesendet oder als Download-Link bereitgestellt werden.

### So funktioniert es

Das Runbook listet jede Microsoft 365-Gruppe auf, die als Teams bereitgestellt wurde, optional eingeschränkt durch *Präfix des Teamnamens*. Für jedes Team liest es die Kanäle der ausgewählten Typen und für jeden Kanal die Mitgliederliste.

* **Private Kanäle** gehören zu einem Team; nur ihre Mitglieder sehen sie, und sie erscheinen weder in der Gruppenansicht des RealmJoin Portal noch in der Gruppenmitgliedschaft des Teams. Dieser Bericht ist die Möglichkeit, sie auf einen Blick zu sehen.
* **Shared Channel** werden von einem Team gehostet und können mit anderen Teams und mit Personen aus anderen Mandanten geteilt werden. Der Bericht listet die Shared Channel auf, die ein Team hostet; Kanäle, die von anderswo in ein Team geteilt wurden, werden unter diesem Team nicht erneut aufgeführt.

Jede Zeile nennt das Team und seine Sichtbarkeit, den Kanal, seinen Typ, ob er archiviert ist, das Erstellungsdatum, die Anzahl der Besitzer, Mitglieder und externen Mitglieder sowie die Besitzer mit Name und E-Mail. Mit *Auch die Mitglieder auflisten?* wenn auf Ja gesetzt, werden die Mitglieder ebenfalls namentlich aufgeführt; lassen Sie es in großen Mandanten ausgeschaltet, um den Bericht kurz zu halten.

Kanäle ohne Besitzer werden in ihrer eigenen Tabelle und ihrem eigenen Arbeitsblatt aufgeführt. Ein privater oder Shared Channel funktioniert auch ohne Besitzer weiter, aber niemand kann seine Mitgliedschaft direkt in Teams verwalten, daher sind solche Kanäle die ersten Kandidaten für eine Bereinigung.

#### Externe Mitglieder

Ein Mitglied, dessen Mandant sich vom Heimmandanten unterscheidet, wird markiert *(extern)* und in der *ExternalCount* Spalte gezählt. Gastkonten des Heimmandanten werden nicht markiert, da sie Mitglieder des Mandantenverzeichnisses sind.

#### Teams und Kanäle, die nicht gelesen werden können

Ein Team, dessen Kanäle nicht gelesen werden können, etwa weil es gelöscht wurde, während der Bericht lief, oder weil das Team archiviert und nicht zugänglich ist, wird in der *Nicht lesbare Teams* Tabelle mit dem Grund aufgeführt und stoppt den Lauf nicht. Ein Kanal, dessen Mitgliederliste nicht gelesen werden kann, behält seine Zeile mit dem Grund in der *Hinweis* Spalte und wird nicht als Kanal ohne Besitzer gezählt.

#### Laufzeit

Kanäle und Mitglieder werden über Graph-Batchanforderungen gelesen, jeweils zwanzig auf einmal. Ein Mandant mit mehreren tausend Teams braucht trotzdem eine Weile; das Auftragsprotokoll zeigt den Fortschritt. Verwenden Sie *Präfix des Teamnamens* um über einen Teilbestand zu berichten.

### Berichtszustellung

Die Ergebnisse erscheinen im Tab Output Data des Laufs im RealmJoin-Portal immer als benannte Tabellen. Berichtsdateien werden nur erzeugt, wenn die **Berichtszustellung** Option eine E-Mail und/oder einen Download-Link enthält; *Nur Ausgabedaten* werden keine Berichtsdateien erstellt. E-Mail-Zustellung und die Generierung des Download-Links sind unabhängig und können kombiniert werden.

Für den Downloadlink werden die Berichtsdateien in den in den Azure Storage Account hochgeladen, der in den `RJReport.StorageAccount.*` Tenant-Einstellungen konfiguriert ist, und zeitlich begrenzte SAS-Downloadlinks werden zurückgegeben. Der Speicher-Upload authentifiziert sich mit der verwalteten Identität des Automation-Kontos; diese Identität benötigt die **Reader and Data Access** RBAC-Rolle auf dem Ziel-Storage Account (dies ist eine Azure-RBAC-Zuweisung, keine Graph-Anwendungsberechtigung).

### Konfiguration für den E-Mail-Versand

Das Senden eines Berichts per E-Mail ist optional und erfolgt nur, wenn *Den Bericht auch per E-Mail senden* oder *Den Bericht auch per E-Mail senden & Downloadlink* als Berichtsversand ausgewählt ist; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus dem `RJReport.EmailSender` Mandanteneinstellung bezogen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph-API zu senden, müssen Sie eine vorhandene E-Mail-Adresse in der Runbook-Anpassung konfigurieren.

Siehe die [RealmJoin Report Settings Dokumentation](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details zu allen verfügbaren Einstellungen.

#### E-Mail-Branding

Die Bericht-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Mandanteneinstellungen:

* **Kopf- und Fußzeilenbild** - öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Fußzeilenlink** - Ziel des Fußzeilenbilds
* **Akzent- und Textfarbe** - 6-stellige Hexwerte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert die Berichts-E-Mail nie - stattdessen wird der entsprechende Standardwert verwendet.

Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Hinweise und Einschränkungen

* Der Bericht ist schreibgeschützt. Besitzer und Mitglieder privater und Shared Channel werden im Teams Admin Center oder direkt in Teams geändert; die Runbooks **Mitglieder von Kanal oder Gruppe synchronisieren (geplant)** und **Besitzer von Shared Channel synchronisieren (geplant)** decken die automatisierten Fälle für Shared Channel ab.
* Standardkanäle werden nicht aufgeführt; ihre Mitgliedschaft entspricht der Teammitgliedschaft, die das RealmJoin Portal anzeigt.
* Die Mitgliederliste eines Shared Channel enthält seine direkten Mitglieder. Personen, die einen Shared Channel über ein anderes Team erreichen, mit dem der Kanal geteilt wurde, werden nicht aufgeführt.

### Speicherort

Organisation → Collab → Teams-Kanäle-Bericht (geplant)

**Voller Runbook-Name**

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

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 1.0.1                                                                                                              |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planbar              | ja                                                                                                                 |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Channel.ReadBasic.All
    * *Listet die privaten und Shared Channel jedes Teams über /teams/{id}/channels auf*
  * ChannelMember.Read.All
    * *Liest die Mitglieder jedes aufgeführten Kanals, um Besitzer, Mitglieder und externe Mitglieder voneinander zu unterscheiden*
  * Group.Read.All
    * *Listet die Microsoft 365-Gruppen auf, die als Teams bereitgestellt werden, mit ihrem Namen und ihrer Sichtbarkeit*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die Berichts-E-Mail über Send-RjRbReportEmail, wenn die E-Mail-Zustellung ausgewählt ist*
  * Organization.Read.All *(optional — Funktion: E-Mail-Bericht)*
    * *Liest den Anzeigenamen des Tenant für den E-Mail-Betreff, den E-Mail-Text und die Dateinamen des Berichts*

#### Hinweise zu Berechtigungen

Azure Storage Account: Rolle 'Reader and Data Access' für die verwaltete Identität des Automation-Kontos auf dem Ziel-Storage Account - der Upload ruft die Kontoschlüssel über listKeys ab (nur für die Downloadlink-Optionen erforderlich)

### Parameter

#### IncludePrivateChannels

Listet die von jedem Team gehosteten privaten Kanäle auf.

| Eigenschaft           | Wert                         |
| --------------------- | ---------------------------- |
| Erforderlich          | falsch                       |
| Standardwert          | Wahr                         |
| Typ                   | Boolesch                     |
| Anzeigename im Portal | Private Kanäle einschließen? |

**Portaloptionen**

| Portaloption | Wert   |
| ------------ | ------ |
| Ja           | wahr   |
| Nein         | falsch |

#### IncludeSharedChannels

Listet die von jedem Team gehosteten Shared Channel auf. Mitglieder aus anderen Mandanten werden als extern markiert.

| Eigenschaft           | Wert                         |
| --------------------- | ---------------------------- |
| Erforderlich          | falsch                       |
| Standardwert          | Wahr                         |
| Typ                   | Boolesch                     |
| Anzeigename im Portal | Shared Channel einschließen? |

**Portaloptionen**

| Portaloption | Wert   |
| ------------ | ------ |
| Ja           | wahr   |
| Nein         | falsch |

#### IncludeMembers

Listet auch die Mitglieder jedes Kanals namentlich auf. Bei Nein werden nur die Besitzer aufgelistet, was den Bericht in großen Mandanten kurz hält.

| Eigenschaft           | Wert                           |
| --------------------- | ------------------------------ |
| Erforderlich          | falsch                         |
| Standardwert          | Falsch                         |
| Typ                   | Boolesch                       |
| Anzeigename im Portal | Auch die Mitglieder auflisten? |

**Portaloptionen**

| Portaloption                | Wert   |
| --------------------------- | ------ |
| Ja, Besitzer und Mitglieder | wahr   |
| Nein, nur Besitzer          | falsch |

#### TeamNamePrefix

Nur Teams, deren Name mit diesem Text beginnt. Leer lassen für alle Teams.

| Eigenschaft           | Wert                  |
| --------------------- | --------------------- |
| Erforderlich          | falsch                |
| Standardwert          |                       |
| Typ                   | Zeichenfolge          |
| Anzeigename im Portal | Präfix des Teamnamens |

#### EmailFrom

Absenderadresse der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.EmailSender übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingHeaderImageUrl

Kopfzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Kopfbereich verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterImageUrl

Fußzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird die standardmäßige RealmJoin-Fußzeile verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterLink

Link hinter dem Fußzeilenbild der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingAccentColor

Akzentfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingTextColor

Textfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### SendEmailReport

Sendet den Bericht an die E-Mail-Adresse des Empfängers.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### EmailTo

Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere durch Kommas; jeder Empfänger erhält eine separate E-Mail.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Empfänger-E-Mail-Adresse(n)                     |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ReportFileFormat

Liefern Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | CSV & XLSX                                      |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Berichtsdateiformat                             |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

**Portaloptionen**

| Portaloption | Wert       |
| ------------ | ---------- |
| CSV & XLSX   | CSV & XLSX |
| Nur CSV      | Nur CSV    |
| Nur XLSX     | Nur XLSX   |

#### CreateDownloadLink

Lädt den Bericht außerdem hoch und gibt einen Downloadlink zurück, der nach einigen Tagen abläuft.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ContainerName

Speichercontainer, in den die Berichtsdateien hochgeladen werden. Pro Runbook festlegen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | report-teams-channels                           |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### StorageAccountName

Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | 6                                               |
| Typ                    | Int32                                           |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/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/de/automatisierung/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.