S’inscrire à La gestion des mises à jour par Windows Autopatch

Lorsque vous inscrivez un appareil dans la gestion des mises à jour par Windows Autopatch, vous pouvez utiliser Windows Autopatch pour gérer le contenu remis par Windows Update à cet appareil. Vous pouvez inscrire un appareil dans Update Management par catégorie de mise à jour.

Aujourd’hui, Windows Autopatch prend en charge l’inscription des appareils pour les mises à jour des fonctionnalités Windows 10/11 et les mises à jour des pilotes. À ce stade, aucune inscription d’appareil n’est requise dans la gestion des mises à jour qualité Windows 10/11 afin de déployer des mises à jour de qualité accélérées ou à chaud.

Inscrire l’appareil dans Update Management

Lorsque vous inscrivez un appareil dans la gestion pour une certaine catégorie de mise à jour, Windows Autopatch devient l’autorité pour les mises à jour de cette catégorie provenant de Windows Update. Par conséquent, les appareils ne reçoivent pas de mises à jour de cette catégorie de Windows Update tant que vous n’avez pas déployé une mise à jour en l’affectant à un déploiement. Les appareils sont automatiquement inscrits lorsqu’ils sont inscrits dans la gestion par Windows Autopatch (autrement dit, un objet azureADDevice est automatiquement créé s’il n’existe pas déjà). Pour l’inscription des pilotes, consultez Inscrire des appareils dans la gestion des pilotes.

L’exemple suivant montre comment inscrire un appareil dans la gestion des mises à jour des fonctionnalités.

Demande

POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/enrollAssets
Content-Type: application/json

{
  "updateCategory": "feature",
  "assets": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    },
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    },
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}

Réponse

HTTP/1.1 202 Accepted

Vérifier l’état d’inscription d’un appareil

Vous pouvez case activée l’état d’inscription d’un appareil en obtenant l’appareil et en examinant les propriétés des inscriptions et deserreurs sur l’objet azureADDevice. Un appareil qui est correctement inscrit dans Update Management a un objet updateManagementEnrollment dans la collection enrollments, et il n’a pas d’objets updatableAssetError dans la collection errors. Un appareil qui a tenté d’inscrire mais qui a rencontré une erreur a rempli des regroupements pour les inscriptions et les erreurs. Un appareil sans demande d’inscription a des regroupements vides pour les inscriptions et les erreurs.

L’exemple suivant montre un appareil qui est correctement inscrit dans la gestion des mises à jour des fonctionnalités.

Demande

GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/983f03cd-03cd-983f-cd03-3f98cd033f98

Réponse

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": {
    "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
    "id": "983f03cd-03cd-983f-cd03-3f98cd033f98",
    "errors": [],
    "enrollments": [
      {
        "@odata.type": "microsoft.graph.windowsUpdates.updateManagementEnrollment",
        "updateCategory": "feature"
      }
    ]
  }
}

Désinscrire de la gestion ou annuler l’inscription

Lorsque vous désinscrivez un appareil de la gestion pour une catégorie de mise à jour donnée, l’appareil n’est plus considéré comme géré et peut commencer à recevoir d’autres mises à jour de Windows Update en fonction de sa configuration de stratégie. L’appareil non inscrit est supprimé de tous les publics et déploiements qui contiennent du contenu pour la catégorie de mise à jour donnée. L’appareil reste inscrit et est toujours inscrit et reçoit du contenu pour d’autres catégories de mise à jour, le cas échéant.

Demande

POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/unenrollAssets
Content-Type: application/json

{
  "updateCategory": "feature",
  "assets": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}

Réponse

HTTP/1.1 202 Accepted

Vous pouvez annuler complètement l’inscription d’un appareil en supprimant l’objet d’appareil. Lorsqu’un appareil est désinscrit, il est automatiquement désinscrit de la gestion pour toutes les catégories de mises à jour et supprimé de chaque deploymentAudience et updatableAssetGroup.

Demande

DELETE https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/{azureADDeviceId}

Réponse

HTTP/1.1 202 Accepted