Mitglieder hinzufügen

Namespace: microsoft.graph

Fügen Sie ein Mitglied über die Navigationseigenschaft Mitglieder zu einer Sicherheitsgruppe oder einer Microsoft 365-Gruppe hinzu.

Die folgende Tabelle zeigt die Typen von Mitgliedern, die entweder Sicherheitsgruppen oder Microsoft 365-Gruppen hinzugefügt werden können.

Objekttyp Mitglied von Sicherheitsgruppen Mitglied einer Microsoft 365-Gruppe
Benutzer Kann Gruppenmitglied sein Kann Gruppenmitglied sein
Sicherheitsgruppen Kann Gruppenmitglied sein Kann kein Gruppenmitglied sein
Microsoft 365-Gruppen Kann kein Gruppenmitglied sein Kann kein Gruppenmitglied sein
Geräte Kann Gruppenmitglied sein Kann kein Gruppenmitglied sein
Dienstprinzipale Kann Gruppenmitglied sein Kann kein Gruppenmitglied sein
Organisationskontakte Kann Gruppenmitglied sein Kann kein Gruppenmitglied sein

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung GroupMember.ReadWrite.All, Group.ReadWrite.All und Directory.ReadWrite.All

Wichtig

Um Mitglieder einer rollenzuweisbaren Gruppe hinzuzufügen, muss dem aufrufenden Benutzer oder der aufrufenden App auch die Berechtigung RoleManagement.ReadWrite.Directory zugewiesen werden.

HTTP-Anforderung

POST /groups/{group-id}/members/$ref

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich.
Content-type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung eines directoryObject- oder user-, group- oder organizational contact-Objekts an, das hinzugefügt werden soll.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Im Antworttext wird nichts zurückgegeben. Diese Methode gibt einen 400 Bad Request-Antwortcode zurück, wenn das Objekt bereits ein Mitglied der Gruppe ist. Diese Methode gibt einen 404 Not Found-Antwortcode zurück, wenn das hinzuzufügende Objekt nicht existiert.

Beispiele

Beispiel 1: Hinzufügen eines Mitglieds zu einer Gruppe

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/v1.0/groups/{group-id}/members/$ref
Content-type: application/json

{
  "@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/{id}"
}

Geben Sie im Anforderungstext eine JSON-Darstellung der ID des directoryObject-, user- oder group-Objekts an, das hinzugefügt werden soll.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Hinzufügen von mehreren Mitgliedern zu einer Gruppe im Rahmen einer einzigen Anforderung

In diesem Beispiel wird gezeigt, wie Sie einer Gruppe mit OData-Bindungsunterstützung mehrere Mitglieder hinzufügen. Beachten Sie, dass in einer einzigen Anforderung bis zu 20 Mitglieder hinzugefügt werden können. Der POST-Vorgang wird nicht unterstützt. Wenn eine Fehlerbedingung im Hauptteil der Anforderung vorliegt, werden keine Mitglieder hinzugefügt, und der entsprechende Antwortcode wird zurückgegeben.

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/v1.0/groups/{group-id}
Content-type: application/json

{
  "members@odata.bind": [
    "https://graph.microsoft.com/v1.0/directoryObjects/{id}",
    "https://graph.microsoft.com/v1.0/directoryObjects/{id}",
    "https://graph.microsoft.com/v1.0/directoryObjects/{id}"
    ]
}

Geben Sie im Anforderungstext eine JSON-Darstellung der ID des directoryObject-, user- oder group-Objekts an, das hinzugefügt werden soll.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 204 No Content

Siehe auch