通过 Windows 更新 for Business 部署服务注册更新管理

  • 项目

通过 Windows 更新 for Business 部署服务在更新管理中注册设备时，可以使用部署服务来管理从Windows 更新传递到该设备的内容。 可以按更新类别在更新管理中注册设备。

目前，部署服务支持注册 Windows 10/11 功能更新和驱动程序更新的管理。 目前，部署服务不需要注册 Windows 10/11 质量更新的管理即可部署加速质量更新。

在更新管理中注册设备

在管理中为特定更新类别注册设备时，部署服务将成为来自Windows 更新的该类别更新的授权机构。 因此，设备不会从 Windows 更新 接收该类别的更新，直到你通过使用部署服务将其分配给部署来部署更新。 通过服务注册管理时，设备会自动注册到服务 (即，如果 azureADDevice 对象尚不存在) ，则会自动创建它。 有关驱动程序注册，请参阅 在驱动程序管理中注册设备。

以下示例演示如何在功能更新管理中注册设备。

请求

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

响应

HTTP/1.1 202 Accepted

检查设备的注册状态

可以通过获取设备并查看 azureADDevice 对象上的注册和错误属性来检查设备的注册状态。 在更新管理中成功注册的设备在注册集合中具有 updateManagementEnrollment 对象，并且错误集合中没有任何 可更新的AssetError 对象。 服务尝试注册但遇到错误的设备已为注册和错误填充集合。 服务未收到任何注册请求的设备包含针对注册和错误的空集合。

以下示例显示了一个设备，该设备已成功注册到服务的功能更新管理中。

请求

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

响应

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

取消注册服务管理，或从服务注销

如果为给定更新类别的服务从管理中取消注册设备，则设备不再由部署服务管理，并且可能会根据其策略配置开始从Windows 更新接收其他更新。 将从包含给定更新类别内容的所有访问群体和部署中删除未注册的设备。 设备仍向服务注册，并且仍在注册并接收其他更新类别的内容 (（如果适用) ）。

请求

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

响应

HTTP/1.1 202 Accepted

可以通过删除设备对象，从服务中完全注销设备。 注销设备后，服务会自动取消注册所有更新类别的管理，并从每个 deploymentAudience 和 updateableAssetGroup 中删除该设备。

请求

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

响应

HTTP/1.1 202 Accepted