= group()
:description: Gibt die Attribute einer einzelnen Gruppe als ECMGroup-Objekt zurück (mng.GetGroupAttributes). Enthält interner Name, Anzeigename und Beschreibung.
:keywords: group, mng.GetGroupAttributes, ECMGroup, interner Name, Anzeigename
:page-tags: api, security

Gibt die Attribute einer einzelnen Gruppe anhand ihres Namens zurück.

== Signatur

[tabs]
====
Sync::
+
[source,python]
----
ecm.security.group(name: str) -> ECMGroup | None
----

Async::
+
[source,python]
----
await ecm.security.group(name: str) -> ECMGroup | None
----
====

== Parameter

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

|`name`
|—
|Name der Gruppe.
|===

== Rückgabewert

`ECMGroup`-Instanz, oder `None` wenn die Gruppe nicht existiert.

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

== Beispiele

=== Einzelne Gruppe laden

[tabs]
====
Sync::
+
[source,python]
----
group = ecm.security.group("Administrators")
if group:
    print(group.guid, group.description)
else:
    print("Gruppe nicht gefunden")
----

Async::
+
[source,python]
----
group = await ecm.security.group("Administrators")
if group:
    print(group.guid, group.description)
----
====

== Siehe auch

* xref:api/security/groups.adoc[groups()] — Alle Gruppen abrufen
* xref:api/security/group_members.adoc[group_members()] — Mitglieder einer Gruppe abrufen
