使用英语阅读

通过


通过 Windows 自动修补注册更新管理

通过 Windows 自动修补在更新管理中注册设备时,可以使用 Windows 自动修补来管理从Windows 更新传递到该设备的内容。 可以按更新类别在更新管理中注册设备。

目前,Windows Autopatch 支持设备注册 Windows 10/11 功能更新和驱动程序更新。 目前,无需在管理 Windows 10/11 质量更新时进行设备注册即可部署热补丁或加速质量更新。

在更新管理中注册设备

在管理中为特定更新类别注册设备时,Windows 自动修补将成为来自Windows 更新的该类别更新的授权机构。 因此,在你通过将更新分配给部署来部署更新之前,设备不会从 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

可以通过删除设备对象来完全注销设备。 注销设备后,会自动从管理中取消注册所有更新类别,并从每个 deploymentAudienceupdateableAssetGroup 中删除。

请求

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

响应

HTTP/1.1 202 Accepted