Inscripción en la administración de actualizaciones por el servicio de implementación de Windows Update para empresas

Al inscribir un dispositivo en la administración de actualizaciones mediante el servicio de implementación de Windows Update for Business, puede usar el servicio de implementación 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, el servicio de implementación admite la inscripción en la administración de actualizaciones de características y actualizaciones de controladores de Windows 10/11. En este momento, el servicio de implementación no requiere la inscripción en la administración de actualizaciones de calidad de Windows 10/11 para implementar actualizaciones de calidad aceleradas.

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, el servicio de implementación 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 mediante el servicio de implementación mediante su asignación a una implementación. Los dispositivos se registran automáticamente con el servicio cuando el servicio se inscribe en la administración (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 el servicio intentó inscribir pero en el que se encontró un error ha rellenado colecciones para las inscripciones y los errores. Un dispositivo para el que el servicio no ha recibido ninguna solicitud de inscripción tiene colecciones vacías para las inscripciones y los errores.

En el ejemplo siguiente se muestra un dispositivo que está inscrito correctamente en la administración de actualizaciones de características por parte del servicio.

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 por parte del servicio o anular el registro del servicio

Al anular la inscripción de un dispositivo de la administración por el servicio para una categoría de actualización determinada, el servicio de implementación ya no administra el dispositivo 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 en el servicio 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

Para anular el registro completo de un dispositivo del servicio, elimine el objeto de dispositivo. Cuando se anula el registro de un dispositivo, el servicio lo anula automáticamente de la administración para todas las categorías de actualización y se quita de cada deploymentAudience y updatableAssetGroup.

Solicitud

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

Respuesta

HTTP/1.1 202 Accepted