Benutzer erstellen

Namespace: microsoft.graph

Wichtig: APIs unter der /beta-Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Dient zum Erstellen eines neuen user-Objekts.

Voraussetzungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen. Welche Berechtigung erforderlich ist, hängt vom Kontext ab.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den meisten Rechten zu der mit den wenigsten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)
Geräteverwaltung	DeviceManagementManagedDevices.ReadWrite.All
MAM	DeviceManagementApps.ReadWrite.All
Onboarding	DeviceManagementServiceConfig.ReadWrite.All
Problembehandlung	DeviceManagementManagedDevices.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung
Geräteverwaltung	DeviceManagementManagedDevices.ReadWrite.All
MAM	DeviceManagementApps.ReadWrite.All
Onboarding	DeviceManagementServiceConfig.ReadWrite.All
Problembehandlung	DeviceManagementManagedDevices.ReadWrite.All

HTTP-Anforderung

POST /users

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer<token> erforderlich
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Benutzerobjekts an.

In der folgenden Tabelle sind die Eigenschaften dargestellt, die zum Erstellen des Benutzers erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Eindeutiger Bezeichner des Benutzers
Onboarding
deviceEnrollmentLimit	Int32	Der Grenzwert für die maximale Anzahl von Geräten, die der Benutzer registrieren kann. Zulässige Werte sind 5 oder 1000.

Die Unterstützung von Anforderungstexteigenschaften variiert je nach Kontext.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201 Created und ein user-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/users
Content-type: application/json
Content-length: 46

{
  "@odata.type": "#microsoft.graph.user"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Die von einem tatsächlichen Aufruf zurückgegebenen Eigenschaften variieren je nach Kontext.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 95

{
  "@odata.type": "#microsoft.graph.user",
  "id": "d36894ae-94ae-d368-ae94-68d3ae9468d3"
}