更新 deviceHealthScriptRunSummary

命名空间:microsoft.graph

重要提示: Microsoft Graph /beta 版本下的 API 可能会更改;不支持生产使用。

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

更新 deviceHealthScriptRunSummary 对象 的属性。

先决条件

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

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

HTTP 请求

PATCH /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/runSummary

请求标头

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

请求正文

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

下表显示创建 deviceHealthScriptRunSummary 时所需的属性

属性 类型 说明
id String 设备运行状况脚本运行摘要实体的键。 此属性是只读的。
noIssueDetectedDeviceCount Int32 检测脚本未发现问题且设备正常运行的设备数量
issueDetectedDeviceCount Int32 检测脚本发现问题的设备数量
detectionScriptErrorDeviceCount Int32 检测脚本执行遇到错误且未完成的设备数量
detectionScriptPendingDeviceCount Int32 尚未运行最新版本的设备运行状况脚本的设备数量
detectionScriptNotApplicableDeviceCount Int32 检测脚本不适用的设备数量
issueRemediatedDeviceCount Int32 修正脚本能够解决检测到的问题的设备数量
remediationSkippedDeviceCount Int32 已跳过修正的设备数
issueReoccurredDeviceCount Int32 修复脚本成功执行但未能解决检测到的问题的设备数量
remediationScriptErrorDeviceCount Int32 修正脚本执行遇到错误且未完成的设备数量
lastScriptRunDateTime DateTimeOffset 脚本跨所有设备的上次运行时间
issueRemediatedCumulativeDeviceCount Int32 过去 30 天内修正的设备数

响应

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

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/runSummary
Content-type: application/json
Content-length: 543

{
  "@odata.type": "#microsoft.graph.deviceHealthScriptRunSummary",
  "noIssueDetectedDeviceCount": 10,
  "issueDetectedDeviceCount": 8,
  "detectionScriptErrorDeviceCount": 15,
  "detectionScriptPendingDeviceCount": 1,
  "detectionScriptNotApplicableDeviceCount": 7,
  "issueRemediatedDeviceCount": 10,
  "remediationSkippedDeviceCount": 13,
  "issueReoccurredDeviceCount": 10,
  "remediationScriptErrorDeviceCount": 1,
  "lastScriptRunDateTime": "2017-01-01T00:01:17.4310553-08:00",
  "issueRemediatedCumulativeDeviceCount": 4
}

响应

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

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

{
  "@odata.type": "#microsoft.graph.deviceHealthScriptRunSummary",
  "id": "8221b043-b043-8221-43b0-218243b02182",
  "noIssueDetectedDeviceCount": 10,
  "issueDetectedDeviceCount": 8,
  "detectionScriptErrorDeviceCount": 15,
  "detectionScriptPendingDeviceCount": 1,
  "detectionScriptNotApplicableDeviceCount": 7,
  "issueRemediatedDeviceCount": 10,
  "remediationSkippedDeviceCount": 13,
  "issueReoccurredDeviceCount": 10,
  "remediationScriptErrorDeviceCount": 1,
  "lastScriptRunDateTime": "2017-01-01T00:01:17.4310553-08:00",
  "issueRemediatedCumulativeDeviceCount": 4
}