大网数据广告活动
Microsoft Graph 接口

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

· 52CE 我爱测

在更新管理中注册设备,以便可以使用 Windows 更新 for Business 部署服务来管理从Windows 更新发送到该设备的内容。

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

目前,部署服务支持注册管理Windows 10功能更新。 目前,部署服务不需要注册Windows 10质量更新的管理,以部署加速的质量更新。

在更新管理中注册设备

在特定更新类别的管理中注册设备时,部署服务将成为来自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 和 updatableAssetGroup 中删除该设备。

请求

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

响应

HTTP/1.1 202 Accepted

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 aarononeal)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。