Mitglieder hinzufügen

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Hinzufügen eines Mitglieds zu einer Sicherheits- oder Microsoft 365-Gruppe. Wenn Sie die API verwenden, um mehrere Mitglieder in einer Anfrage hinzuzufügen, können Sie bis zu 20 Mitglieder hinzufügen.

Hinweis

Diese Anforderung kann zu Replikationsverzögerungen für Gruppen führen, die kürzlich erstellt wurden. Wenn eine Gruppe erstellt wird, kann es eine kurze Zeit dauern, bis das Objekt vollständig über Microsoft Entra ID-Verzeichnisreplikate hinweg repliziert wurde. Während dieses Zeitfensters können Anforderungen zum Hinzufügen von Mitgliedern zur Gruppe eine 400 Bad Request Fehlermeldung mit folgender Meldung zurückgeben: "Das Quellressourcenobjekt oder eines der Objekte, auf die verwiesen wird, ist nicht vorhanden."

So mindern Sie dieses Verhalten:

Wiederholen Sie den Vorgang nach einer kurzen Verzögerung : Warten Sie einige Sekunden, und wiederholen Sie die Anforderung. Die Verzögerung ist in der Regel nur kurz.

Weitere Informationen finden Sie unter Entwerfen für letztliche Konsistenz für Microsoft Entra.

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

Objekttyp	Mitglied der Sicherheitsgruppe	Mitglied einer Microsoft 365-Gruppe
Benutzer
Sicherheitsgruppe
Microsoft 365 Gruppe
Gerät
Dienstprinzipal
Organisationskontakte

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Die folgende Tabelle zeigt die Berechtigung mit den geringsten Berechtigungen, die für jeden Ressourcentyp beim Aufrufen dieser API erforderlich ist. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Unterstützte Ressource	Delegiert (Geschäfts-, Schul- oder Unikonto)	Delegiert (persönliches Microsoft-Konto)	Application
device	GroupMember.ReadWrite.All und Device.Read.All	Nicht unterstützt	GroupMember.ReadWrite.All und Device.ReadWrite.All
Gruppe	GroupMember.ReadWrite.All	Nicht unterstützt	GroupMember.ReadWrite.All
orgContact	GroupMember.ReadWrite.All und OrgContact.Read.All	Nicht unterstützt	GroupMember.ReadWrite.All und OrgContact.Read.All
servicePrincipal	GroupMember.ReadWrite.All und Application.ReadWrite.All	Nicht unterstützt	GroupMember.ReadWrite.All und Application.ReadWrite.All
user	GroupMember.ReadWrite.All	Nicht unterstützt	GroupMember.ReadWrite.All

Wichtig

In delegierten Szenarien muss dem angemeldeten Benutzer auch eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit der microsoft.directory/groups/members/update Rollenberechtigung zugewiesen werden. Die folgenden Rollen sind die am wenigsten privilegierten Rollen, die für diesen Vorgang unterstützt werden, mit Ausnahme von Rollenzuweisungsgruppen:

Gruppenbesitzer
Verzeichnisautoren
Gruppenadministrator
Identity Governance Administrator
Benutzeradministrator
Exchange-Administrator – nur für Microsoft 365-Gruppen
SharePoint-Administrator – nur für Microsoft 365-Gruppen
Teams-Administrator – nur für Microsoft 365-Gruppen
Yammer Administrator – nur für Microsoft 365-Gruppen
Intune Administrator – nur für Sicherheitsgruppen

Um einer rollenzuweisbaren Gruppe Mitglieder hinzuzufügen, muss der App auch die Berechtigung "RoleManagement.ReadWrite.Directory" zugewiesen werden, und dem aufrufenden Benutzer muss eine unterstützte Rolle Microsoft Entra zugewiesen werden. Der Administrator mit den geringsten Berechtigungen ist die Rolle, die für diesen Vorgang unterstützt wird.

HTTP-Anforderung

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

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-type	application/json. Erforderlich.

Anforderungstext

Wenn Sie die POST /groups/{group-id}/members/$ref Syntax verwenden, geben Sie ein JSON-Objekt an, das eine @odata.id-Eigenschaft mit einem Verweis per ID auf einen unterstützten Objekttyp eines Gruppenmitglieds enthält.

Wenn Sie die PATCH /groups/{group-id} Syntax verwenden, geben Sie ein JSON-Objekt an, das eine members@odata.bind Eigenschaft mit einem oder mehreren Verweisen durch IDs auf einen unterstützten Objekttyp eines Gruppenmitglieds enthält. Das heißt:

Nur https://graph.microsoft.com/v1.0/directoryObjects/{id} für Microsoft 365-Gruppen und https://graph.microsoft.com/v1.0/groups/{id} ist zulässig, wenn {id} ein Benutzer sein muss, da nur Benutzer Mitglied von Microsoft 365-Gruppen sein können.
Für Sicherheitsgruppen sind die folgenden ID-Verweise zulässig:
- https://graph.microsoft.com/v1.0/directoryObjects/{id} die zu {id} einem Benutzer, einer Sicherheitsgruppe, einem Gerät, einem Dienstprinzipal oder einem Organisationskontakt gehören müssen.
- https://graph.microsoft.com/v1.0/groups/{id} wobei muss {id} zu einer anderen Sicherheitsgruppe gehören. Microsoft 365 Gruppen dürfen keine Mitglieder von Sicherheitsgruppen sein.
- https://graph.microsoft.com/v1.0/devices/{id} wo zu {id} einem Gerät gehört.
- https://graph.microsoft.com/v1.0/servicePrincipal/{id} Hierzu {id} gehört ein Dienstprinzipal.
- https://graph.microsoft.com/v1.0/orgContact/{id} wobei zu {id} einem organisatorischen Kontakt gehört.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Sie gibt einen 400 Bad Request Antwortcode zurück, wenn das Objekt bereits Mitglied der Gruppe ist, als Gruppenmitglied nicht unterstützt wird oder wenn die Gruppe kürzlich erstellt und nicht vollständig repliziert wurde (Fehlermeldung: "Das Quellressourcenobjekt oder eines der Objekte, auf die verwiesen wird, ist nicht vorhanden." – Wiederholen Sie den Vorgang nach einer kurzen Verzögerung). Sie gibt einen 404 Not Found Antwortcode zurück, wenn das hinzugefügte Objekt nicht vorhanden ist. Sie gibt in einem der folgenden Szenarien zurück 403 Forbidden :

Sie versuchen, ein Mitglied zu einer Gruppe hinzuzufügen, die nicht über Microsoft Graph verwaltet werden kann. Diese API unterstützt nur Sicherheits- und Microsoft 365-Gruppen.
Sie versuchen, ein Mitglied hinzuzufügen, für das Sie keine Berechtigungen haben. Im obigen Abschnitt "Berechtigungen " finden Sie die Berechtigungen, die zum Hinzufügen verschiedener Mitgliedstypen erforderlich sind.
Sie versuchen, ein Mitglied zu einer Gruppe hinzuzufügen, der eine Rolle zugewiesen werden kann, und verfügen nicht über die erforderlichen Berechtigungen.

Beispiel

Beispiel 1: Hinzufügen eines Mitglieds zu einer Gruppe

Anforderung

Das folgende Beispiel zeigt eine Anforderung, die den directoryObjects-Verweis verwendet, um einer Gruppe ein Mitglied hinzuzufügen.

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new ReferenceCreate
{
	OdataId = "https://graph.microsoft.com/beta/directoryObjects/{id}",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Groups["{group-id}"].Members.Ref.PostAsync(requestBody);

Wichtig

Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewReferenceCreate()
odataId := "https://graph.microsoft.com/beta/directoryObjects/{id}"
requestBody.SetOdataId(&odataId) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Groups().ByGroupId("group-id").Members().Ref().Post(context.Background(), requestBody, nil)

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.beta.models.ReferenceCreate referenceCreate = new com.microsoft.graph.beta.models.ReferenceCreate();
referenceCreate.setOdataId("https://graph.microsoft.com/beta/directoryObjects/{id}");
graphClient.groups().byGroupId("{group-id}").members().ref().post(referenceCreate);

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
  '@odata.id': 'https://graph.microsoft.com/beta/directoryObjects/{id}'
};

await client.api('/groups/{group-id}/members/$ref')
	.version('beta')
	.post(directoryObject);

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\ReferenceCreate;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new ReferenceCreate();
$requestBody->setOdataId('https://graph.microsoft.com/beta/directoryObjects/{id}');

$graphServiceClient->groups()->byGroupId('group-id')->members()->ref()->post($requestBody)->wait();

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


Import-Module Microsoft.Graph.Beta.Groups

$params = @{
	"@odata.id" = "https://graph.microsoft.com/beta/directoryObjects/{id}"
}

New-MgBetaGroupMemberByRef -GroupId $groupId -BodyParameter $params

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.reference_create import ReferenceCreate
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ReferenceCreate(
	odata_id = "https://graph.microsoft.com/beta/directoryObjects/{id}",
)

await graph_client.groups.by_group_id('group-id').members.ref.post(request_body)

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die 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. In einer einzigen Anfrage können bis zu 20 Mitglieder hinzugefügt werden. Wenn eine Fehlerbedingung im Hauptteil der Anforderung vorliegt, werden keine Mitglieder hinzugefügt, und der entsprechende Antwortcode wird zurückgegeben.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new Group
{
	AdditionalData = new Dictionary<string, object>
	{
		{
			"members@odata.bind" , new List<string>
			{
				"https://graph.microsoft.com/beta/directoryObjects/{id}",
				"https://graph.microsoft.com/beta/directoryObjects/{id}",
				"https://graph.microsoft.com/beta/directoryObjects/{id}",
			}
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Groups["{group-id}"].PatchAsync(requestBody);

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewGroup()
additionalData := map[string]interface{}{
	odataBind := []string {
		"https://graph.microsoft.com/beta/directoryObjects/{id}",
		"https://graph.microsoft.com/beta/directoryObjects/{id}",
		"https://graph.microsoft.com/beta/directoryObjects/{id}",
	}
}
requestBody.SetAdditionalData(additionalData)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
groups, err := graphClient.Groups().ByGroupId("group-id").Patch(context.Background(), requestBody, nil)

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Group group = new Group();
HashMap<String, Object> additionalData = new HashMap<String, Object>();
LinkedList<String> membersOdataBind = new LinkedList<String>();
membersOdataBind.add("https://graph.microsoft.com/beta/directoryObjects/{id}");
membersOdataBind.add("https://graph.microsoft.com/beta/directoryObjects/{id}");
membersOdataBind.add("https://graph.microsoft.com/beta/directoryObjects/{id}");
additionalData.put("members@odata.bind", membersOdataBind);
group.setAdditionalData(additionalData);
Group result = graphClient.groups().byGroupId("{group-id}").patch(group);

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


const options = {
	authProvider,
};

const client = Client.init(options);

const group = {
  'members@odata.bind': [
    'https://graph.microsoft.com/beta/directoryObjects/{id}',
    'https://graph.microsoft.com/beta/directoryObjects/{id}',
    'https://graph.microsoft.com/beta/directoryObjects/{id}'
    ]
};

await client.api('/groups/{group-id}')
	.version('beta')
	.update(group);

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Group;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new Group();
$additionalData = [
	'members@odata.bind' => [
'https://graph.microsoft.com/beta/directoryObjects/{id}', 'https://graph.microsoft.com/beta/directoryObjects/{id}', 'https://graph.microsoft.com/beta/directoryObjects/{id}', ],
];
$requestBody->setAdditionalData($additionalData);

$result = $graphServiceClient->groups()->byGroupId('group-id')->patch($requestBody)->wait();

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


Import-Module Microsoft.Graph.Beta.Groups

$params = @{
	"members@odata.bind" = @(
	"https://graph.microsoft.com/beta/directoryObjects/{id}"
"https://graph.microsoft.com/beta/directoryObjects/{id}"
"https://graph.microsoft.com/beta/directoryObjects/{id}"
)
}

Update-MgBetaGroup -GroupId $groupId -BodyParameter $params

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.group import Group
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Group(
	additional_data = {
			"members@odata_bind" : [
				"https://graph.microsoft.com/beta/directoryObjects/{id}",
				"https://graph.microsoft.com/beta/directoryObjects/{id}",
				"https://graph.microsoft.com/beta/directoryObjects/{id}",
			],
	}
)

result = await graph_client.groups.by_group_id('group-id').patch(request_body)

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Feedback

War diese Seite hilfreich?

Last updated on 2026-08-18

Mitglieder hinzufügen

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiel

Beispiel 1: Hinzufügen eines Mitglieds zu einer Gruppe

Anforderung

Antwort

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

Anforderung

Antwort

Verwandte Inhalte

Feedback

Zusätzliche Ressourcen