通过 Windows Update for Business 部署服务注册更新管理Enroll in update management by the Windows Update for Business deployment service

当你通过 Windows Update for Business 部署服务在更新管理中注册设备时,可以使用部署服务管理从 Windows Update 传递到该设备的内容。When you enroll device in update management by the Windows Update for Business deployment service, you can use the deployment service to manage content delivered from Windows Update to that device. 你可以按更新类别在更新管理中注册设备。You can enroll a device in update management by update category.

现在,部署服务支持注册管理Windows 10更新。Today, the deployment service supports enrollment in management of Windows 10 feature updates. 目前,部署服务不需要注册管理质量Windows 10以部署快速的质量更新。At this time, the deployment service does not require enrollment in management of Windows 10 quality updates in order to deploy expedited quality updates.

在更新管理中注册设备Enroll the device in update management

当你为某个更新类别注册管理中的设备时,部署服务将成为该类别的更新(来自 Windows 更新)的颁发机构。When you enroll a device in management for a certain update category, the deployment service becomes the authority for updates of that category coming from Windows Update. 因此,设备不会从 Windows Update 接收该类别的更新,直到你通过使用部署服务将其分配给部署 来部署更新As a result, devices do not receive updates of that category from Windows Update until you deploy an update using the deployment service by assigning it to a deployment. 设备在服务注册管理时会自动注册到服务 (即 azureADDevice 对象在设备上不存在时) 。Devices are automatically registered with the service when enrolled in management by the service (i.e. an azureADDevice object is automatically created if it does not already exist).

请求Request

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

响应Response

HTTP/1.1 202 Accepted

检查设备的注册状态Check the enrollment state of a device

可以通过获取设备并查看 azureADDevice 对象的 注册和错误 属性来检查设备的注册状态。 You can check the enrollment state of a device by getting the device and looking at the enrollments and errors properties on the azureADDevice object. 在更新管理中成功注册的设备在注册集合中具有 updateManagementEnrollment 对象,并且它在错误集合中没有任何 updatableAssetError 对象。A device that is successfully enrolled in update management has an updateManagementEnrollment object in the enrollments collection, and it does not have any updatableAssetError objects in the errors collection. 服务尝试注册但遇到错误的设备已填充注册和错误的集合。A device that the service tried to enroll but encountered an error has populated collections for both enrollments and errors. 服务尚未收到任何注册请求的设备具有注册和错误的空集合。A device for which the service has not received any enrollment requests has empty collections for both enrollments and errors.

以下示例显示已成功注册服务功能更新管理的设备。The following example shows a device that is successfully enrolled in management of feature updates by the service.

请求Request

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

响应Response

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

注销服务管理或注销服务Unenroll from management by the service or unregister from the service

当注销设备以从服务管理给定更新类别时,该设备将不再由部署服务管理,并且可能会开始根据 Windows Update 的策略配置接收其他更新。When you unenroll a device from management by the service for a given update category, the device is no longer managed by the deployment service and may start receiving other updates from Windows Update based on its policy configuration. 如果将设备分配给给定更新类别的任何部署,则它不会接收该内容。If the device is assigned to any deployments for the given update category, it does not receive that content. 设备仍注册到服务中,并且仍在注册并接收其他更新类别 ((如果适用) )。The device remains registered with the service and is still enrolled and receiving content for other update categories (if applicable).

请求Request

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

响应Response

HTTP/1.1 202 Accepted

可以通过删除设备对象从服务中完全注销设备。You can unregister a device from the service completely by deleting the device object. 当设备注销时,该服务将自动取消注册所有更新类别的管理,并删除所有部署访问群体 和 updatableAsset 组。When a device is unregistered, it is automatically unenrolled from management by the service for all update categories and removed from all deployment audiences and updatableAsset groups.

请求Request

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

响应Response

HTTP/1.1 202 Accepted