Mettre à jour deviceManagementAutopilotEvent
Espace de noms: microsoft.graph
Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Mettez à jour les propriétés d’un objet deviceManagementAutopilotEvent .
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
| Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
|---|---|
| Déléguée (compte professionnel ou scolaire) | DeviceManagementManagedDevices.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | DeviceManagementManagedDevices.ReadWrite.All |
Requête HTTP
PATCH /deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}
En-têtes de demande
| En-tête | Valeur |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
| Accepter | application/json |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON pour l’objet deviceManagementAutopilotEvent .
Le tableau suivant indique les propriétés requises lorsque vous créez l’événement deviceManagementAutopilotEvent.
| Propriété | Type | Description |
|---|---|---|
| id | String | UUID pour l’objet |
| deviceId | Chaîne | ID d’appareil associé à l’objet |
| eventDateTime | DateTimeOffset | Heure où l’événement s’est produit. |
| deviceRegisteredDateTime | DateTimeOffset | Date d’inscription de l’appareil. |
| enrollmentStartDateTime | DateTimeOffset | Date de début de l’inscription de l’appareil. |
| enrollmentType | windowsAutopilotEnrollmentType | Type d’inscription. Les valeurs possibles sont les suivantes : unknown, azureADJoinedWithAutopilotProfile, offlineDomainJoined, azureADJoinedUsingDeviceAuthWithAutopilotProfile, azureADJoinedUsingDeviceAuthWithoutAutopilotProfile, azureADJoinedWithOfflineAutopilotProfile, azureADJoinedWithWhiteGlove, offlineDomainJoinedWithWhiteGlove, offlineDomainJoinedWithOfflineAutopilotProfile. |
| deviceSerialNumber | Chaîne | Numéro de série de l’appareil. |
| managedDeviceName | Chaîne | Nom de l’appareil géré. |
| userPrincipalName | String | Nom d’utilisateur principal utilisé pour inscrire l’appareil. |
| windowsAutopilotDeploymentProfileDisplayName | Chaîne | Nom du profil Autopilot. |
| enrollmentState | enrollmentState | État d’inscription tel que Inscrit, Échec. Les valeurs possibles sont unknown, enrolled, pendingReset, failed, notContacted, blocked. |
| windows10EnrollmentCompletionPageConfigurationDisplayName | Chaîne | Nom du profil de la page d’état d’inscription |
| windows10EnrollmentCompletionPageConfigurationId | Chaîne | ID de profil de la page d’état d’inscription |
| deploymentState | windowsAutopilotDeploymentState | État de déploiement tel que Success, Failure, InProgress, SuccessWithTimeout. Les valeurs possibles sont les suivantes : unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled et successOnRetry. |
| deviceSetupStatus | windowsAutopilotDeploymentState | État du déploiement pour la phase de configuration de l’appareil de la page d’état d’inscription. Les valeurs possibles sont les suivantes : unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled et successOnRetry. |
| accountSetupStatus | windowsAutopilotDeploymentState | État du déploiement pour la phase de configuration du compte de la page d’état d’inscription. Les valeurs possibles sont les suivantes : unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled et successOnRetry. |
| osVersion | Chaîne | Version du système d’exploitation de l’appareil. |
| deploymentDuration | Durée | Durée du déploiement Autopilot, y compris l’inscription. |
| deploymentTotalDuration | Durée | Durée totale du déploiement de l’inscription à l’écran Bureau. |
| devicePreparationDuration | Durée | Temps passé dans l’inscription de l’appareil. |
| deviceSetupDuration | Durée | Temps passé dans l’ESP de l’appareil. |
| accountSetupDuration | Durée | Temps passé dans l’ESP utilisateur. |
| deploymentStartDateTime | DateTimeOffset | Heure de début du déploiement. |
| deploymentEndDateTime | DateTimeOffset | Heure de fin du déploiement. |
| targetedAppCount | Int32 | Nombre d’applications ciblées. |
| targetedPolicyCount | Int32 | Nombre de stratégies ciblées. |
| enrollmentFailureDetails | Chaîne | Détails de l’échec d’inscription. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet deviceManagementAutopilotEvent mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
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"
}
Réponse
Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.
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"
}