更新 userExperienceAnalyticsWorkFromAnywhereDevice
命名空间：microsoft.graph
重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
更新 userExperienceAnalyticsWorkFromAnywhereDevice 对象的属性。
权限
调用此 API 需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。
| 权限类型 | 权限（从最低特权到最高特权） |
|---|---|
| 委派（工作或学校帐户） | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | 不支持。 |
| 应用程序 | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
HTTP 请求
PATCH /deviceManagement/userExperienceAnalyticsWorkFromAnywhereMetrics/{userExperienceAnalyticsWorkFromAnywhereMetricId}/metricDevices/{userExperienceAnalyticsWorkFromAnywhereDeviceId}
请求标头
| 标头 | 值 |
|---|---|
| Authorization | Bearer <token>。必需。 |
| 接受 | application/json |
请求正文
在请求正文中，提供 userExperienceAnalyticsWorkFromAnywhereDevice 对象的 JSON 表示形式。
下表显示了创建 userExperienceAnalyticsWorkFromAnywhereDevice 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 用户体验分析从任何位置设备工作的唯一标识符。 |
| deviceId | String | 用户体验可从任何位置使用设备 ID。 |
| deviceName | String | 来自任意位置的设备名称的工作。 |
| serialNumber | String | 用户体验可从设备的序列号的任何位置运行。 |
| manufacturer | String | 用户体验适用于设备制造商的任意位置。 |
| model | String | 用户体验可从设备的模型的任何位置运行。 |
| 所有权 | String | 用户体验可从任何位置使用设备所有权。 |
| managedBy | String | 用户体验可从设备的任意位置管理代理运行。 |
| autoPilotRegistered | Boolean | 用户体验可从 intune 设备的 autopilotRegistered 的任何位置工作。 |
| autoPilotProfileAssigned | Boolean | 用户体验分析可从 intune 设备的 autopilotProfileAssigned 的任何位置工作。 |
| azureAdRegistered | Boolean | 用户体验可从设备的任意位置使用 azureAdRegistered。 |
| azureAdDeviceId | String | 用户体验可从任何位置使用 azure Ad 设备 ID。 |
| azureAdJoinType | String | 用户体验可从任何位置设备的 azure Ad joinType 工作。 |
| osDescription | String | 用户体验可从任何位置使用设备的 OS 说明。 |
| osVersion | String | 用户体验可从设备的 OS 版本的任何位置运行。 |
| tenantAttached | Boolean | 用户体验可从设备的 tenantAttached 的任何位置工作。 |
| compliancePolicySetToIntune | Boolean | 用户体验可从任何位置设备的 compliancePolicySetToIntune 工作。 |
| otherWorkloadsSetToIntune | Boolean | 用户体验可从任何位置设备的其他WorkloadsSetToIntune工作。 |
| isCloudManagedGatewayEnabled | Boolean | 用户体验可从任何位置使用设备的云管理网关进行Configuration Manager。 |
| upgradeEligibility | operatingSystemUpgradeEligibility | 用户体验可从设备的任意位置 Windows 升级资格状态运行。 可能的值是：upgraded、unknown、notCapable、capable。 |
| ramCheckFailed | Boolean | 用户体验分析是否从任何位置运行设备 RAM 硬件检查失败，无法将设备升级到最新版本的 Windows |
| storageCheckFailed | Boolean | 用户体验可从任何位置设备运行，设备是否检查无法升级到最新版本的 Windows。 |
| processorCoreCountCheckFailed | Boolean | 用户体验可从任何位置设备运行，检查设备升级到最新版本的 Windows 时，处理器硬件核心计数是否失败。 |
| processorSpeedCheckFailed | Boolean | 用户体验从任何位置的设备工作，处理器硬件速度检查失败，设备升级到最新版本的 Windows。 |
| tpmCheckFailed | Boolean | 用户体验可从任何位置的设备、受信任的平台模块 (TPM) 硬件检查无法将设备升级到 Windows 的最新版本。 |
| secureBootCheckFailed | Boolean | 用户体验可从任何位置的设备运行，安全启动硬件检查设备升级到最新版本的 Windows 时失败。 |
| processorFamilyCheckFailed | Boolean | 用户体验可从任何位置设备工作，处理器硬件系列检查设备升级到最新版本的 Windows 时失败。 |
| processor64BitCheckFailed | Boolean | 用户体验从任何位置的设备工作，是处理器硬件 64 位体系结构检查失败，设备升级到最新版本的 Windows。 |
| osCheckFailed | Boolean | 用户体验从任何位置的设备工作，操作系统检查失败，设备升级到最新版本的 Windows。 |
| workFromAnywhereScore | 双精度 | 用户体验在每个设备的总体分数的任意位置运行。 有效值 -1.79769313486232E+308 到 1.79769313486232E+308 |
| windowsScore | 双精度 | 用户体验适用于每个设备窗口分数的任意位置。 有效值 -1.79769313486232E+308 到 1.79769313486232E+308 |
| cloudManagementScore | 双精度 | 用户体验适用于每个设备云管理分数的任意位置。 有效值 -1.79769313486232E+308 到 1.79769313486232E+308 |
| cloudIdentityScore | 双精度 | 用户体验适用于每个设备云标识分数的任意位置。 有效值 -1.79769313486232E+308 到 1.79769313486232E+308 |
| cloudProvisioningScore | 双精度 | 用户体验适用于每个设备云预配分数的任意位置。 有效值 -1.79769313486232E+308 到 1.79769313486232E+308 |
| healthStatus | userExperienceAnalyticsHealthState | 用户体验适用于每个设备运行状况状态的任意位置。 可取值为：unknown、insufficientData、needsAttention、meetingGoals、unknownFutureValue。 |
响应
如果成功，此方法在 200 OK 响应正文中返回响应代码和更新的 userExperienceAnalyticsWorkFromAnywhereDevice 对象。
示例
请求
下面是一个请求示例。
PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsWorkFromAnywhereMetrics/{userExperienceAnalyticsWorkFromAnywhereMetricId}/metricDevices/{userExperienceAnalyticsWorkFromAnywhereDeviceId}
Content-type: application/json
Content-length: 1323
{
"@odata.type": "#microsoft.graph.userExperienceAnalyticsWorkFromAnywhereDevice",
"deviceId": "Device Id value",
"deviceName": "Device Name value",
"serialNumber": "Serial Number value",
"manufacturer": "Manufacturer value",
"model": "Model value",
"ownership": "Ownership value",
"managedBy": "Managed By value",
"autoPilotRegistered": true,
"autoPilotProfileAssigned": true,
"azureAdRegistered": true,
"azureAdDeviceId": "Azure Ad Device Id value",
"azureAdJoinType": "Azure Ad Join Type value",
"osDescription": "Os Description value",
"osVersion": "Os Version value",
"tenantAttached": true,
"compliancePolicySetToIntune": true,
"otherWorkloadsSetToIntune": true,
"isCloudManagedGatewayEnabled": true,
"upgradeEligibility": "unknown",
"ramCheckFailed": true,
"storageCheckFailed": true,
"processorCoreCountCheckFailed": true,
"processorSpeedCheckFailed": true,
"tpmCheckFailed": true,
"secureBootCheckFailed": true,
"processorFamilyCheckFailed": true,
"processor64BitCheckFailed": true,
"osCheckFailed": true,
"workFromAnywhereScore": 7.0,
"windowsScore": 4.0,
"cloudManagementScore": 6.666666666666667,
"cloudIdentityScore": 6.0,
"cloudProvisioningScore": 7.333333333333333,
"healthStatus": "insufficientData"
}
响应
下面是一个响应示例。 注意：为简洁起见，可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1372
{
"@odata.type": "#microsoft.graph.userExperienceAnalyticsWorkFromAnywhereDevice",
"id": "83d5adfc-adfc-83d5-fcad-d583fcadd583",
"deviceId": "Device Id value",
"deviceName": "Device Name value",
"serialNumber": "Serial Number value",
"manufacturer": "Manufacturer value",
"model": "Model value",
"ownership": "Ownership value",
"managedBy": "Managed By value",
"autoPilotRegistered": true,
"autoPilotProfileAssigned": true,
"azureAdRegistered": true,
"azureAdDeviceId": "Azure Ad Device Id value",
"azureAdJoinType": "Azure Ad Join Type value",
"osDescription": "Os Description value",
"osVersion": "Os Version value",
"tenantAttached": true,
"compliancePolicySetToIntune": true,
"otherWorkloadsSetToIntune": true,
"isCloudManagedGatewayEnabled": true,
"upgradeEligibility": "unknown",
"ramCheckFailed": true,
"storageCheckFailed": true,
"processorCoreCountCheckFailed": true,
"processorSpeedCheckFailed": true,
"tpmCheckFailed": true,
"secureBootCheckFailed": true,
"processorFamilyCheckFailed": true,
"processor64BitCheckFailed": true,
"osCheckFailed": true,
"workFromAnywhereScore": 7.0,
"windowsScore": 4.0,
"cloudManagementScore": 6.666666666666667,
"cloudIdentityScore": 6.0,
"cloudProvisioningScore": 7.333333333333333,
"healthStatus": "insufficientData"
}