Inscribirse en la administración de actualizaciones mediante Windows Autopatch

Al inscribir un dispositivo en la administración de actualizaciones mediante Windows Autopatch, puedes usar Windows Autopatch para administrar el contenido entregado desde Windows Update a ese dispositivo. Puede inscribir un dispositivo en la administración de actualizaciones por categoría de actualización.

En la actualidad, Windows Autopatch admite la inscripción de dispositivos para actualizaciones de características de Windows 10/11 y actualizaciones de controladores. En este momento, no se requiere ninguna inscripción de dispositivos en la administración de actualizaciones de calidad de Windows 10/11 con el fin de implementar actualizaciones de calidad rápidas o de acceso frecuente.

Inscripción del dispositivo en la administración de actualizaciones

Al inscribir un dispositivo en la administración de una categoría de actualización determinada, Windows Autopatch se convierte en la autoridad para las actualizaciones de esa categoría procedentes de Windows Update. Como resultado, los dispositivos no reciben actualizaciones de esa categoría de Windows Update hasta que implemente una actualización al asignarla a una implementación. Los dispositivos se registran automáticamente al inscribirse en la administración mediante Windows Autopatch (es decir, se crea automáticamente un objeto azureADDevice si aún no existe). Para la inscripción de controladores, consulte Inscripción de dispositivos en la administración de controladores.

En el ejemplo siguiente se muestra cómo inscribir un dispositivo en la administración de actualizaciones de características.

Solicitud

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

Respuesta

HTTP/1.1 202 Accepted

Comprobación del estado de inscripción de un dispositivo

Para comprobar el estado de inscripción de un dispositivo, obtenga el dispositivo y examine las propiedades de inscripción y errores en el objeto azureADDevice . Un dispositivo que se inscribe correctamente en la administración de actualizaciones tiene un objeto updateManagementEnrollment en la colección enrollments y no tiene ningún objeto updatableAssetError en la colección errors. Un dispositivo que intentó inscribirse pero encontró un error ha rellenado colecciones para las inscripciones y los errores. Un dispositivo sin solicitudes de inscripción tiene colecciones vacías para las inscripciones y los errores.

En el ejemplo siguiente se muestra un dispositivo que se inscribe correctamente en la administración de actualizaciones de características.

Solicitud

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

Respuesta

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

Anular la inscripción de la administración o anular el registro

Al anular la inscripción de un dispositivo de la administración para una categoría de actualización determinada, el dispositivo ya no se considera administrado y puede empezar a recibir otras actualizaciones de Windows Update en función de su configuración de directiva. El dispositivo no inscrito se quita de todas las audiencias e implementaciones que contienen contenido para la categoría de actualización especificada. El dispositivo permanece registrado y sigue inscrito y recibiendo contenido para otras categorías de actualización, si procede.

Solicitud

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

Respuesta

HTTP/1.1 202 Accepted

Puede anular el registro completo de un dispositivo mediante la eliminación del objeto de dispositivo. Cuando se anula el registro de un dispositivo, se anula automáticamente la inscripción de la administración para todas las categorías de actualización y se quita de todas las implementacionesAudience y updatableAssetGroup.

Solicitud

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

Respuesta

HTTP/1.1 202 Accepted