deviceManagementAutopilotEvent aktualisieren

Namespace: microsoft.graph

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

Dient zum Aktualisieren der Eigenschaften eines deviceManagementAutopilotEvent-Objekts.

Voraussetzungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

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

HTTP-Anforderung

PATCH /deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des deviceManagementAutopilotEvent-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs "deviceManagementAutopilotEvent"erstellen.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	UUID für das Objekt
deviceId	String	Geräte-ID, die dem Objekt zugeordnet ist
eventDateTime	DateTimeOffset	Uhrzeit, zu der das Ereignis aufgetreten ist.
deviceRegisteredDateTime	DateTimeOffset	Geräteregistrierungsdatum.
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	String	Name des verwalteten Geräts.
userPrincipalName	Zeichenfolge	Benutzerprinzipalname, der zum Registrieren des Geräts verwendet wird.
windowsAutopilotDeploymentProfileDisplayName	Zeichenfolge	Autopilot-Profilname.
enrollmentState	enrollmentState	Registrierungsstatus wie "Registriert", "Fehlgeschlagen". 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 "Erfolgreich", "Failure", "InProgress", "SuccessWithTimeout". Mögliche Werte: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled.
deviceSetupStatus	windowsAutopilotDeploymentState	Bereitstellungsstatus für die Einrichtungsphase der Registrierungsstatusseite des Geräts. Mögliche Werte: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled.
accountSetupStatus	windowsAutopilotDeploymentState	Bereitstellungsstatus für die Einrichtungsphase der Registrierungsstatusseite des Kontos. Mögliche Werte: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled.
osVersion	String	Betriebssystemversion des Geräts.
deploymentDuration	Dauer	Dauer der Autopilot-Bereitstellung einschließlich Registrierung.
deploymentTotalDuration	Dauer	Gesamtbereitstellungsdauer von der Registrierung auf dem Desktopbildschirm.
devicePreparationDuration	Dauer	Für die Geräteregistrierung aufgewendete Zeit.
deviceSetupDuration	Dauer	In Geräte-ESP aufgewendete Zeit.
accountSetupDuration	Dauer	In Benutzer-ESP aufgewendete Zeit.
deploymentStartDateTime	DateTimeOffset	Startzeit der Bereitstellung.
deploymentEndDateTime	DateTimeOffset	Endzeit der Bereitstellung.
targetedAppCount	Int32	Anzahl der gezielten Anwendungen.
targetedPolicyCount	Int32	Anzahl der zielgerichteten Richtlinien.
enrollmentFailureDetails	Zeichenfolge	Details zu Registrierungsfehlern.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 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/v1/deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}
Content-type: application/json
Content-length: 1545

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "deviceId": "Device 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",
  "devicePreparationDuration": "-PT1M32.1347897S",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "targetedAppCount": 0,
  "targetedPolicyCount": 3,
  "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: 1594

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "id": "3e455cab-5cab-3e45-ab5c-453eab5c453e",
  "deviceId": "Device 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",
  "devicePreparationDuration": "-PT1M32.1347897S",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "targetedAppCount": 0,
  "targetedPolicyCount": 3,
  "enrollmentFailureDetails": "Enrollment Failure Details value"
}