Actualizar deviceManagementAutopilotEvent

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualice las propiedades de un objeto deviceManagementAutopilotEvent .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	DeviceManagementManagedDevices.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	DeviceManagementManagedDevices.ReadWrite.All

Solicitud HTTP

PATCH /deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto deviceManagementAutopilotEvent .

En la tabla siguiente se muestran las propiedades necesarias al crear deviceManagementAutopilotEvent.

Propiedad	Tipo	Descripción
id	String	UUID para el objeto
deviceId	Cadena	Id. de dispositivo asociado al objeto
eventDateTime	DateTimeOffset	Hora en que ocurrió el evento.
deviceRegisteredDateTime	DateTimeOffset	Fecha de registro del dispositivo.
enrollmentStartDateTime	DateTimeOffset	Fecha de inicio de inscripción de dispositivos.
enrollmentType	windowsAutopilotEnrollmentType	Tipo de inscripción. Los valores posibles son: unknown, azureADJoinedWithAutopilotProfile, offlineDomainJoined, azureADJoinedUsingDeviceAuthWithAutopilotProfile, azureADJoinedUsingDeviceAuthWithoutAutopilotProfile, azureADJoinedWithOfflineAutopilotProfile, azureADJoinedWithWhiteGlove, offlineDomainJoinedWithWhiteGlove y offlineDomainJoinedWithOfflineAutopilotProfile.
deviceSerialNumber	Cadena	Número de serie del dispositivo.
managedDeviceName	Cadena	Nombre del dispositivo administrado.
userPrincipalName	Cadena	Nombre principal de usuario usado para inscribir el dispositivo.
windowsAutopilotDeploymentProfileDisplayName	Cadena	Nombre del perfil de Autopilot.
enrollmentState	enrollmentState	Estado de inscripción como Inscrito, Con error. Los valores posibles son: unknown, enrolled, pendingReset, failed, notContacted, blocked.
windows10EnrollmentCompletionPageConfigurationDisplayName	Cadena	Nombre del perfil de la página de estado de inscripción
windows10EnrollmentCompletionPageConfigurationId	Cadena	Identificador de perfil de página de estado de inscripción
deploymentState	windowsAutopilotDeploymentState	Estado de implementación como Success, Failure, InProgress, SuccessWithTimeout. Los valores posibles son: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled y successOnRetry.
deviceSetupStatus	windowsAutopilotDeploymentState	Estado de implementación de la fase de configuración del dispositivo de la página de estado de inscripción. Los valores posibles son: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled y successOnRetry.
accountSetupStatus	windowsAutopilotDeploymentState	Estado de implementación de la fase de configuración de la cuenta de la página de estado de inscripción. Los valores posibles son: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled y successOnRetry.
osVersion	Cadena	Versión del sistema operativo del dispositivo.
deploymentDuration	Duración	Duración de la implementación de Autopilot, incluida la inscripción.
deploymentTotalDuration	Duración	Duración total de la implementación desde la inscripción a la pantalla escritorio.
devicePreparationDuration	Duración	Tiempo dedicado a la inscripción de dispositivos.
deviceSetupDuration	Duración	Tiempo invertido en el dispositivo ESP.
accountSetupDuration	Duración	Tiempo invertido en esp de usuario.
deploymentStartDateTime	DateTimeOffset	Hora de inicio de la implementación.
deploymentEndDateTime	DateTimeOffset	Hora de finalización de la implementación.
targetedAppCount	Int32	Recuento de aplicaciones destinadas.
targetedPolicyCount	Int32	Recuento de directivas dirigidas.
enrollmentFailureDetails	Cadena	Detalles del error de inscripción.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto deviceManagementAutopilotEvent actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/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"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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"
}