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.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen. Die spezifische erforderliche Berechtigung 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. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
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 | String | 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 der Anforderungstexteigenschaft 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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Feedback senden und anzeigen für