Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
## Permissions
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 |
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
HTTP-Anforderung
POST /users
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über 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"
}