= group_members()
:description: Gibt die Mitglieder einer Gruppe als Liste von ECMUser-Objekten zurück (mng.GetGroupMembers). Liefert Login-Namen, GUIDs und Anzeigedaten aller Gruppenmitglieder.
:keywords: group_members, mng.GetGroupMembers, ECMUser, Login, GUID, Gruppenmitglieder
:page-tags: api, security

Gibt alle Benutzer zurück, die Mitglied der angegebenen Gruppe sind.

== Signatur

[tabs]
====
Sync::
+
[source,python]
----
ecm.security.group_members(group_name: str) -> list[ECMUser]
----

Async::
+
[source,python]
----
await ecm.security.group_members(group_name: str) -> list[ECMUser]
----
====

== Parameter

[cols="1,1,3"]
|===
|Parameter |Standard |Beschreibung

|`group_name`
|—
|Name der Gruppe, deren Mitglieder abgerufen werden sollen.
|===

== Rückgabewert

Liste von `ECMUser`-Instanzen. Leere Liste, wenn die Gruppe keine Mitglieder hat oder nicht existiert.

Felder von `ECMUser` — siehe xref:api/security/users.adoc[users()].

== Beispiele

=== Mitglieder einer Gruppe auflisten

[tabs]
====
Sync::
+
[source,python]
----
members = ecm.security.group_members("Administrators")
for user in members:
    print(user.username, user.display_name)
----

Async::
+
[source,python]
----
members = await ecm.security.group_members("Administrators")
for user in members:
    print(user.username, user.display_name)
----
====

=== Alle Gruppen mit ihren Mitgliedern ausgeben

[tabs]
====
Sync::
+
[source,python]
----
for group in ecm.security.groups():
    members = ecm.security.group_members(group.name)
    print(f"{group.name}: {[m.username for m in members]}")
----

Async::
+
[source,python]
----
for group in await ecm.security.groups():
    members = await ecm.security.group_members(group.name)
    print(f"{group.name}: {[m.username for m in members]}")
----
====

== Siehe auch

* xref:api/security/groups.adoc[groups()] — Alle Gruppen abrufen
* xref:api/security/group.adoc[group()] — Attribute einer einzelnen Gruppe
* xref:api/security/user_groups.adoc[user_groups()] — Gruppen eines bestimmten Benutzers
