Freigeben über

Erstellen von deviceManagementAutopilotEvent

Namespace: microsoft.graph

Wichtig: Microsoft unterstützt Intune/beta-APIs, die jedoch häufiger geändert werden. Microsoft empfiehlt, nach Möglichkeit Version 1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version 1.0 mithilfe der Versionsauswahl.

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

Erstellen Sie ein neues deviceManagementAutopilotEvent-Objekt .

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

Weltweiter Service 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.

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

HTTP-Anforderung

POST /deviceManagement/autopilotEvents

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 für das deviceManagementAutopilotEvent-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von deviceManagementAutopilotEvent erforderlich sind.

Eigenschaft Typ Beschreibung
id String UUID für das Objekt
deviceId Zeichenfolge Dem Objekt zugeordnete Geräte-ID
userId String Dem Objekt zugeordnete UserId-ID
eventDateTime DateTimeOffset Uhrzeit, zu der das Ereignis aufgetreten ist.
deviceRegisteredDateTime DateTimeOffset Datum der Geräteregistrierung.
enrollmentStartDateTime DateTimeOffset Startdatum der Geräteregistrierung.
enrollmentType windowsAutopilotEnrollmentType Registrierungstyp. Mögliche Werte: unknown, azureADJoinedWithAutopilotProfile, offlineDomainJoined, azureADJoinedUsingDeviceAuthWithAutopilotProfile, azureADJoinedUsingDeviceAuthWithoutAutopilotProfile, azureADJoinedWithOfflineAutopilotProfile, azureADJoinedWithWhiteGlove, offlineDomainJoinedWithWhiteGlove, offlineDomainJoinedWithOfflineAutopilotProfile.
deviceSerialNumber Zeichenfolge Seriennummer des Geräts.
managedDeviceName Zeichenfolge Name des verwalteten Geräts.
userPrincipalName Zeichenfolge Benutzerprinzipalname, der zum Registrieren des Geräts verwendet wird.
windowsAutopilotDeploymentProfileDisplayName Zeichenfolge Name des Autopilot-Profils.
enrollmentState enrollmentState Registrierungsstatus wie Registriert, Fehler. Mögliche Werte sind: unknown, enrolled, pendingReset, failed, notContacted und blocked.
windows10EnrollmentCompletionPageConfigurationDisplayName Zeichenfolge Profilname der Registrierungsstatusseite
windows10EnrollmentCompletionPageConfigurationId Zeichenfolge Profil-ID der Registrierungsstatusseite
deploymentState windowsAutopilotDeploymentState Bereitstellungsstatus wie Success, Failure, InProgress, SuccessWithTimeout. Mögliche Werte: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled, successOnRetry.
deviceSetupStatus windowsAutopilotDeploymentState Bereitstellungs-status für die Geräteeinrichtungsphase der Seite "Registrierung status". Mögliche Werte: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled, successOnRetry.
accountSetupStatus windowsAutopilotDeploymentState Bereitstellung status für die Kontoeinrichtungsphase der Seite "Registrierung status". Mögliche Werte: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled, successOnRetry.
osVersion Zeichenfolge Version des Gerätebetriebssystems.
deploymentDuration Dauer Dauer der Autopilot-Bereitstellung einschließlich Registrierung.
deploymentTotalDuration Dauer Gesamtdauer der Bereitstellung von der Registrierung bis zum Desktopbildschirm.
deviceSetupDuration Dauer Zeitaufwand für Geräte-ESP.
accountSetupDuration Dauer Zeit, die für die Benutzer-ESP aufgewendet wurde.
deploymentStartDateTime DateTimeOffset Startzeit der Bereitstellung.
deploymentEndDateTime DateTimeOffset Endzeit der Bereitstellung.
enrollmentFailureDetails Zeichenfolge Details zu Registrierungsfehlern.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein objekt des Typs deviceManagementAutopilotEvent im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/autopilotEvents
Content-type: application/json
Content-length: 1468

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "deviceId": "Device Id value",
  "userId": "User Id value",
  "eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
  "deviceRegisteredDateTime": "2017-01-01T00:02:48.7185581-08:00",
  "enrollmentStartDateTime": "2017-01-01T00:00:19.6280481-08:00",
  "enrollmentType": "azureADJoinedWithAutopilotProfile",
  "deviceSerialNumber": "Device Serial Number value",
  "managedDeviceName": "Managed Device Name value",
  "userPrincipalName": "User Principal Name value",
  "windowsAutopilotDeploymentProfileDisplayName": "Windows Autopilot Deployment Profile Display Name value",
  "enrollmentState": "enrolled",
  "windows10EnrollmentCompletionPageConfigurationDisplayName": "Windows10Enrollment Completion Page Configuration Display Name value",
  "windows10EnrollmentCompletionPageConfigurationId": "Windows10Enrollment Completion Page Configuration Id value",
  "deploymentState": "success",
  "deviceSetupStatus": "success",
  "accountSetupStatus": "success",
  "osVersion": "Os Version value",
  "deploymentDuration": "PT3M21.5549443S",
  "deploymentTotalDuration": "PT1M43.5284261S",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "enrollmentFailureDetails": "Enrollment Failure Details value"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

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

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "id": "3e455cab-5cab-3e45-ab5c-453eab5c453e",
  "deviceId": "Device Id value",
  "userId": "User Id value",
  "eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
  "deviceRegisteredDateTime": "2017-01-01T00:02:48.7185581-08:00",
  "enrollmentStartDateTime": "2017-01-01T00:00:19.6280481-08:00",
  "enrollmentType": "azureADJoinedWithAutopilotProfile",
  "deviceSerialNumber": "Device Serial Number value",
  "managedDeviceName": "Managed Device Name value",
  "userPrincipalName": "User Principal Name value",
  "windowsAutopilotDeploymentProfileDisplayName": "Windows Autopilot Deployment Profile Display Name value",
  "enrollmentState": "enrolled",
  "windows10EnrollmentCompletionPageConfigurationDisplayName": "Windows10Enrollment Completion Page Configuration Display Name value",
  "windows10EnrollmentCompletionPageConfigurationId": "Windows10Enrollment Completion Page Configuration Id value",
  "deploymentState": "success",
  "deviceSetupStatus": "success",
  "accountSetupStatus": "success",
  "osVersion": "Os Version value",
  "deploymentDuration": "PT3M21.5549443S",
  "deploymentTotalDuration": "PT1M43.5284261S",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "enrollmentFailureDetails": "Enrollment Failure Details value"
}
  • Last updated on