deviceManagementAutopilotEvent aktualisieren

Namespace: microsoft.graph

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

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

Aktualisieren sie die Eigenschaften eines deviceManagementAutopilotEvent-Objekts .

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
Anwendung	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

HTTP-Anforderung

PATCH /deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}

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	String	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	String	Seriennummer des Geräts.
managedDeviceName	String	Name des verwalteten Geräts.
userPrincipalName	String	Benutzerprinzipalname, der zum Registrieren des Geräts verwendet wird.
windowsAutopilotDeploymentProfileDisplayName	String	Name des Autopilot-Profils.
enrollmentState	enrollmentState	Registrierungsstatus wie Registriert, Fehler. Mögliche Werte sind: unknown, enrolled, pendingReset, failed, notContacted und blocked.
windows10EnrollmentCompletionPageConfigurationDisplayName	String	Profilname der Registrierungsstatusseite
windows10EnrollmentCompletionPageConfigurationId	String	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	String	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	String	Details zu Registrierungsfehlern.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes deviceManagementAutopilotEvent-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}
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 200 OK
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"
}