命名空间：microsoft.graph
重要提示：Microsoft 支持 Intune/beta API，但它们可能会进行更频繁的更改。 Microsoft 建议尽可能使用 v1.0 版本。 使用版本选择器检查 API 在版本 v1.0 中的可用性。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
Intune 将使客户能够在已注册的 Windows 10 Azure Active Directory 联接设备上运行其 Powershell 运行状况脚本 (修正 + 检测) 。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 列出 deviceHealthScripts | deviceHealthScript 集合 | 列出 deviceHealthScript 对象的属性和关系。 |
| 获取 deviceHealthScript | deviceHealthScript | 读取 deviceHealthScript 对象的属性和关系。 |
| 创建 deviceHealthScript | deviceHealthScript | 创建新的 deviceHealthScript 对象。 |
| 删除 deviceHealthScript | 无 | 删除 deviceHealthScript。 |
| 更新 deviceHealthScript | deviceHealthScript | 更新 deviceHealthScript 对象的属性。 |
| 分配操作 | 无 | |
| updateGlobalScript 操作 | String | 更新专有设备运行状况脚本 |
| getGlobalScriptHighestAvailableVersion 操作 | String | 更新专有设备运行状况脚本 |
| enableGlobalScripts 操作 | 无 | |
| areGlobalScriptsAvailable 函数 | globalDeviceHealthScriptState | |
| getRemediationSummary 函数 | deviceHealthScriptRemediationSummary | |
| getRemediationHistory 函数 | deviceHealthScriptRemediationHistory | 用于获取设备运行状况脚本修正次数的函数 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 设备运行状况脚本的唯一标识符 |
| 发布者 | String | 设备运行状况脚本发布者的名称 |
| version | String | 设备运行状况脚本的版本 |
| displayName | String | 设备运行状况脚本的名称 |
| description | String | 设备运行状况脚本的说明 |
| detectionScriptContent | Binary | 检测 powershell 脚本的全部内容 |
| remediationScriptContent | Binary | 修正 powershell 脚本的全部内容 |
| createdDateTime | DateTimeOffset | 创建设备运行状况脚本的时间戳。 此属性是只读的。 |
| lastModifiedDateTime | DateTimeOffset | 修改设备运行状况脚本的时间戳。 此属性是只读的。 |
| runAsAccount | runAsAccountType | 指示执行上下文的类型。 可取值为：system、user。 |
| enforceSignatureCheck | 布尔值 | 指示是否需要检查脚本签名 |
| runAs32Bit | 布尔值 | 指示 PowerShell 脚本 () 是否应作为 32 位运行 |
| roleScopeTagIds | 字符串集合 | 设备运行状况脚本的作用域标记 ID 列表 |
| isGlobalScript | 布尔值 | 确定这是否为 Microsoft 专有脚本。 专有脚本是只读的 |
| highestAvailableVersion | String | Microsoft 专有脚本的最高可用版本 |
| deviceHealthScriptType | deviceHealthScriptType | 脚本策略的 DeviceHealthScriptType。 可取值为：deviceHealthScript、managedInstallerScript。 |
| detectionScriptParameters | deviceHealthScriptParameter 集合 | ComplexType DetectionScriptParameters 对象的列表。 |
| remediationScriptParameters | deviceHealthScriptParameter 集合 | ComplexType RemediationScriptParameters 对象的列表。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| assignments | deviceHealthScriptAssignment 集合 | 设备运行状况脚本的组分配列表 |
| runSummary | deviceHealthScriptRunSummary | 设备运行状况脚本的高级运行摘要。 |
| deviceRunStates | deviceHealthScriptDeviceState 集合 | 所有设备上设备运行状况脚本的运行状态列表 |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.deviceHealthScript",
"id": "String (identifier)",
"publisher": "String",
"version": "String",
"displayName": "String",
"description": "String",
"detectionScriptContent": "binary",
"remediationScriptContent": "binary",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"runAsAccount": "String",
"enforceSignatureCheck": true,
"runAs32Bit": true,
"roleScopeTagIds": [
"String"
],
"isGlobalScript": true,
"highestAvailableVersion": "String",
"deviceHealthScriptType": "String",
"detectionScriptParameters": [
{
"@odata.type": "microsoft.graph.deviceHealthScriptStringParameter",
"name": "String",
"description": "String",
"isRequired": true,
"applyDefaultValueWhenNotAssigned": true,
"defaultValue": "String"
}
],
"remediationScriptParameters": [
{
"@odata.type": "microsoft.graph.deviceHealthScriptStringParameter",
"name": "String",
"description": "String",
"isRequired": true,
"applyDefaultValueWhenNotAssigned": true,
"defaultValue": "String"
}
]
}