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

# Gruppenmitgliedschaften auflisten

Die Gruppenmitgliedschaften dieses Benutzers auflisten

### Beschreibung

Listet die Gruppen auf, denen dieser Benutzer angehört, mit Filtern für Gruppentyp, Mitgliedschaftstyp, Rollen-Zuweisbarkeit, Teams, Quelle und Writeback. Das Ergebnis wird als CSV-Text und als Output Data-Tabellen angezeigt. Der Bericht kann auch per E-Mail gesendet oder als Download-Link bereitgestellt werden. Es werden keine Änderungen vorgenommen.

### Ausgabe und Berichtszustellung

Jeder Lauf listet die passenden Gruppen als CSV-Text in der Runbook-Ausgabe auf und schreibt zwei Output Data-Tabellen, die im RealmJoin-Portal sortiert, gefiltert und exportiert werden können:

* `Zusammenfassung` - den Benutzer, die ausgewählten Filter, die Anzahl direkter Gruppenmitgliedschaften und die Anzahl der Gruppen, die den Filtern entsprechen.
* `Gruppenmitgliedschaften` - eine Zeile pro passender Gruppe mit denselben Spalten wie die CSV-Datei und dem `Gruppenmitgliedschaften` Arbeitsblatt. Wenn keine Gruppe übereinstimmt, wird stattdessen eine Statuszeile angezeigt.

Die **Berichtsübermittlung** Die Option fügt zusätzlich Berichtdateien hinzu:

* **Nur Output Data** (Standard) – keine Berichtdateien.
* **Den Bericht zusätzlich per E-Mail senden** - das Feld für die Empfängeradresse (`EmailTo`) wird angezeigt und ist erforderlich, und der Bericht wird per E-Mail mit angehängten Berichtdatei(en) gesendet.
* **Erstelle außerdem einen Downloadlink** - die Berichtdatei(en) werden in ein Azure Storage Account hochgeladen und ein zeitlich begrenzter Download-Link wird zurückgegeben.
* **Den Bericht zusätzlich per E-Mail und Downloadlink senden** - beides.

**Format der Berichtdatei** wählt CSV, XLSX oder beides für die Berichtdateien. Wenn keine Gruppe den Filtern entspricht, werden keine Berichtdateien erstellt, hochgeladen oder per E-Mail gesendet.

Die Option setzt die Parameter `SendMail` und `CreateDownloadLink`. Zeitpläne und API-Aufrufe, die diese Parameter direkt übergeben, funktionieren weiterhin wie bisher.

### Einrichtung bezüglich des Storage Accounts

Für den Download-Link werden die Berichtdateien in ein Azure Storage Account hochgeladen. Der Ziel-Storage Account wird aus den gemeinsamen **RJReport** Tenant-Einstellungen übernommen, sodass er einmal konfiguriert und für alle Bericht-Runbooks wiederverwendet werden kann:

* `RJReport.StorageAccount.ResourceGroup`
* `RJReport.StorageAccount.StorageAccountName`
* `RJReport.StorageAccount.SubscriptionId` (optional, empfohlen; siehe [Abonnement des Storage Account](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#subscription-of-the-storage-account))
* `RJReport.StorageAccount.LinkExpiryDays` (optional, Standardwert 6)

Der Containername wird pro Runbook konfiguriert (Parameter `ContainerName`, Standard `user-group-memberships`). Die verwaltete Identität des Automation Accounts benötigt die `Reader and Data Access` Rolle auf dem Storage Account.

### Einrichtung in Bezug auf den E-Mail-Versand

Das Senden eines Berichts per E-Mail ist optional und erfolgt nur, wenn *Den Bericht zusätzlich per E-Mail senden* oder *Den Bericht zusätzlich per E-Mail und Downloadlink senden* als Berichtszustellung ausgewählt ist (Parameter `SendMail`); ein Empfänger (`EmailTo`) ist dann erforderlich. Die Absenderadresse wird aus dem `RJReport.EmailSender` Tenant-Einstellung übernommen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Anpassung des Runbooks eine vorhandene E-Mail-Adresse 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 Berichts-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Tenant-Einstellungen:

* **Header- und Footer-Bild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. jeweils 200 KB
* **Footer-Link** – Ziel des Footer-Bildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert die Berichts-E-Mail niemals – stattdessen wird der entsprechende Standard verwendet.

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

### Ort

Benutzer → Allgemein → Gruppenmitgliedschaften auflisten

**Vollständiger Runbook-Name**

rjgit-user\_general\_list-group-memberships

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Group.Read.All
    * *Liest die Gruppen des Benutzers über /users/{id}/memberOf aus, einschließlich Mitgliedschaftsregeln zum Filtern*
  * Organization.Read.All
    * *Liest /organization für den Anzeigenamen des Tenant im E-Mail-Bericht*
  * User.Read.All
    * *Löst den Zielbenutzer auf, um ID und UPN für den Bericht zu erhalten*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die Bericht-E-Mail über Send-RjRbReportEmail, wenn SendMail aktiviert und EmailTo konfiguriert ist*

### Parameter

#### Benutzername

Der Benutzerprinzipalname des Benutzers, für den das Runbook ausgeführt wird. Vom Portal anhand des ausgewählten Benutzers festgelegt.

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

#### Gruppentyp

Nur Sicherheitsgruppen, nur Microsoft 365-Gruppen oder alle Gruppen.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert | Alle         |
| Typ          | Zeichenfolge |

#### Mitgliedschaftstyp

Zugewiesene Mitgliedschaften, dynamische Mitgliedschaften oder alle.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert | Alle         |
| Typ          | Zeichenfolge |

#### Rollen zuweisbar

Ja beschränkt die Liste auf Gruppen, denen Entra ID-Rollen zugewiesen werden können.

| Eigenschaft  | Wert             |
| ------------ | ---------------- |
| Erforderlich | falsch           |
| Standardwert | Nicht festgelegt |
| Typ          | Zeichenfolge     |

#### Teams aktiviert

Ja beschränkt die Liste auf Gruppen, die ein Microsoft Teams-Team unterstützen.

| Eigenschaft  | Wert             |
| ------------ | ---------------- |
| Erforderlich | falsch           |
| Standardwert | Nicht festgelegt |
| Typ          | Zeichenfolge     |

#### Quelle

Nur-Cloud-Gruppen, aus Active Directory vor Ort synchronisierte Gruppen oder alle.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert | Alle         |
| Typ          | Zeichenfolge |

#### Writeback aktiviert

Gruppen mit Writeback zu Active Directory vor Ort, Gruppen ohne Writeback oder alle.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert | Alle         |
| Typ          | Zeichenfolge |

#### SendMail

Senden Sie den Bericht an die E-Mail-Adresse des Empfängers. Wird über die Auswahl "Report delivery" im Portal festgelegt.

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

#### EmailTo

Senden Sie den Bericht an diese Adressen. Mehrere mit Kommas trennen; jeder Empfänger erhält eine separate E-Mail. Erforderlich, wenn "Report delivery" eine E-Mail umfasst.

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

#### EmailFrom

Absenderadresse der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.EmailSender übernommen.

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

#### BrandingHeaderImageUrl

Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Header verwendet.

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

#### BrandingFooterImageUrl

Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Footer verwendet.

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

#### BrandingFooterLink

Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

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

#### BrandingAccentColor

Akzentfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### BrandingTextColor

Textfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### ReportFileFormat

Liefern Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides. Wird angezeigt, wenn "Report delivery" eine E-Mail oder einen Download-Link umfasst.

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

**Portaloptionen**

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

#### CreateDownloadLink

Laden Sie den Bericht außerdem hoch und geben Sie einen Download-Link zurück, der nach einigen Tagen abläuft. Wird über die Auswahl "Report delivery" im Portal festgelegt.

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

#### ContainerName

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

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

#### ResourceGroupName

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

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

#### StorageAccountName

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

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

#### SubscriptionId

Abonnement-ID des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.SubscriptionId übernommen; wenn leer, wird das Abonnement verwendet, bei dem sich die verwaltete Identität anmeldet.

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

#### LinkExpiryDays

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

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

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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/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.
