更新 softwareUpdateStatusSummary

命名空间：microsoft.graph

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

更新 softwareUpdateStatusSummary 对象的属性。

权限

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

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

HTTP 请求

PATCH /deviceManagement/softwareUpdateStatusSummary

请求标头

标头	值
Authorization	持有者 {token}。 必填。 详细了解 身份验证和授权。
接受	application/json

请求正文

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

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

属性	类型	说明
id	String	实体的键。
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 对象。

示例

请求

下面是一个请求示例。

HTTP

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
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const softwareUpdateStatusSummary = {
  '@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
};

await client.api('/deviceManagement/softwareUpdateStatusSummary')
	.update(softwareUpdateStatusSummary);

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

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

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
}