通过 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,规范化链接,移除外部媒体和导航标记。
