更新 softwareUpdateStatusSummary

命名空间：microsoft.graph

注意： 适用于 Intune 的 Microsoft Graph API 需要适用于租户的 活动 Intune 许可证。

更新 softwareUpdateStatusSummary 对象的属性。

先决条件

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	DeviceManagementConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

PATCH /deviceManagement/softwareUpdateStatusSummary

请求标头

标头	值
Authorization	Bearer <token>。必需。
接受	application/json

请求正文

在请求正文中，提供 softwareUpdateStatusSummary 对象的 JSON 表示形式。

下表显示了创建 softwareUpdateStatusSummary 时所需的属性。

属性	类型	说明
id	字符串	实体的键。
displayName	String	策略的名称。
compliantDeviceCount	Int32	兼容设备的数量。
nonCompliantDeviceCount	Int32	不兼容设备的数量。
remediatedDeviceCount	Int32	已修复设备的数量。
errorDeviceCount	Int32	出现错误的设备数量。
unknownDeviceCount	Int32	未知设备的数量。
conflictDeviceCount	Int32	冲突设备的数量。
notApplicableDeviceCount	Int32	不适用设备的数量。
compliantUserCount	Int32	兼容用户的数量。
nonCompliantUserCount	Int32	不兼容用户的数量。
remediatedUserCount	Int32	已修复用户的数量。
errorUserCount	Int32	出现错误的用户数量。
unknownUserCount	Int32	未知用户的数量。
conflictUserCount	Int32	冲突用户的数量。
notApplicableUserCount	Int32	不适用用户的数量。

响应

如果成功，此方法会在响应正文中返回 200 OK 响应代码和更新的 softwareUpdateStatusSummary 对象。

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/v1.0/deviceManagement/softwareUpdateStatusSummary
Content-type: application/json
Content-length: 518

{
  "@odata.type": "#microsoft.graph.softwareUpdateStatusSummary",
  "displayName": "Display Name value",
  "compliantDeviceCount": 4,
  "nonCompliantDeviceCount": 7,
  "remediatedDeviceCount": 5,
  "errorDeviceCount": 0,
  "unknownDeviceCount": 2,
  "conflictDeviceCount": 3,
  "notApplicableDeviceCount": 8,
  "compliantUserCount": 2,
  "nonCompliantUserCount": 5,
  "remediatedUserCount": 3,
  "errorUserCount": 14,
  "unknownUserCount": 0,
  "conflictUserCount": 1,
  "notApplicableUserCount": 6
}

响应

下面是一个响应示例。注意：为了简单起见，可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 567

{
  "@odata.type": "#microsoft.graph.softwareUpdateStatusSummary",
  "id": "4f71421f-421f-4f71-1f42-714f1f42714f",
  "displayName": "Display Name value",
  "compliantDeviceCount": 4,
  "nonCompliantDeviceCount": 7,
  "remediatedDeviceCount": 5,
  "errorDeviceCount": 0,
  "unknownDeviceCount": 2,
  "conflictDeviceCount": 3,
  "notApplicableDeviceCount": 8,
  "compliantUserCount": 2,
  "nonCompliantUserCount": 5,
  "remediatedUserCount": 3,
  "errorUserCount": 14,
  "unknownUserCount": 0,
  "conflictUserCount": 1,
  "notApplicableUserCount": 6
}