cloudPC 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph 中版本下的 /beta API 可能会更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 在 v1.0 中是否可用，请使用 版本 选择器。
表示云托管的虚拟桌面。 此云电脑还注册到 Intune，并通过 Microsoft Endpoint Manager 门户进行管理，因此云电脑还具有相应的Intune托管设备 ID。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 列出 cloudPC | cloudPC 集合 | 列出 cloudPC 对象的属性和关系。 |
| 获取 cloudPC | cloudPC | 读取 cloudPC 对象的属性和关系。 |
| 更改用户帐户类型 | 无 | 更改特定云电脑上用户的帐户类型。 |
| 结束宽限期 | 无 | 结束 cloudPC 对象的宽限期。 |
| 获取远程操作结果 | cloudPcRemoteActionResult | 检查 云电脑设备的云电脑指定的远程操作结果 。 |
| 重新 启动 | 无 | 重新启动特定的 cloudPC 对象。 |
| Rename | 无 | 重命名特定的 cloudPC 对象。 使用此 API 更新云电脑实体的 displayName 。 |
| 重新预配 | 无 | 重新预配 cloudPC 对象。 |
| 重新预配远程操作 | 无 | 使用Intune托管设备 ID 重新预配云电脑。 |
| 批量重新预配远程操作 | 无 | 使用Intune托管设备 ID 批量重新预配一组云电脑设备。 |
| 调整远程操作大小 | 无 | 通过Intune托管设备 ID，使用新的 vCPU 和存储大小将现有云电脑升级或降级到另一个配置。 |
| 疑难解答 | 无 | 对特定 cloudPC 对象进行故障排除。 使用此 API 检查云电脑和会话主机的运行状况。 |
| 还原 | 无 | 将 cloudPC 对象从快照还原到以前的状态。 |
| 还原远程操作 | 无 | 使用Intune托管设备 ID 将云电脑设备还原到以前的状态。 |
| 批量还原远程操作 | cloudPcBulkRemoteActionResult | 使用单个请求还原多个云电脑设备，其中包括Intune托管设备的 ID 以及还原点日期和时间。 |
| 设置评审状态 | 无 | 设置特定云电脑设备的评审状态。 |
| 获取评审状态 | cloudPcReviewStatus | 获取特定云电脑设备的评审状态。 |
| 批量设置评审状态 | cloudPcBulkRemoteActionResult | 使用包含Intune托管设备的 ID 的单个请求设置多个云电脑设备的评审状态。 |
| 用户列表 | cloudPC 集合 | 列出归属于已登录用户的 cloudPC 设备。 |
| 获取用户的启动信息 | cloudPCLaunchInfo | 获取已登录用户的 cloudPCLaunchInfo 。 |
| 获取连接历史记录 | cloudPcConnectivityEvent 集合 | 获取云电脑连接历史记录。 |
| 获取班次工作访问状态 | ShiftWorkCloudPcAccessState | 获取班次工作云电脑的访问状态。 可能的值为：{unassigned、noLicensesAvailable、activationFailed、active、activationing、waitlisted、unknownFutureValue、hibernated}。 请注意，必须使用 Prefer: include-unknown-enum-members 请求标头在此 shiftWorkCloudPcAccessState 中获取以下值： {hibernated}。 |
| 获取支持的远程操作 | cloudPcRemoteActionCapability 集合 | 获取特定云电脑设备支持的云电脑远程操作列表，包括操作名称和功能。 |
| 重试合作伙伴代理安装 | 无 | 对于未能在 cloudPC 上安装的合作伙伴代理，请重试安装。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| aadDeviceId | String | Azure Active Directory (Azure AD) 云电脑的设备 ID。 |
| connectivityResult | cloudPcConnectivityResult | 连接运行状况检查云电脑的结果，包括更新的时间戳以及云电脑是否可以连接。 |
| diskEncryptionState | cloudPcDiskEncryptionState | 应用于云电脑的磁盘加密。 可能的值是：notAvailable、notEncrypted、encryptedUsingPlatformManagedKey、encryptedUsingCustomerManagedKey 和 unknownFutureValue。 |
| displayName | String | 云电脑的显示名称。 |
| gracePeriodEndDateTime | DateTimeOffset | 宽限期结束并重新预配/取消预配的日期和时间。 仅当状态为 inGracePeriod时才需要 。 时间戳以 ISO 8601 格式和协调世界时 (UTC) 显示。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| id | String | 云电脑的唯一标识符。 只读。 |
| imageDisplayName | String | 云电脑上的 OS 映像的名称。 |
| lastLoginResult | cloudPcLoginResult | 云电脑的上次登录结果。 例如，{ "time": "2014-01-01T00:00:00Z"}。 |
| lastModifiedDateTime | DateTimeOffset | 云电脑的上次修改日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| lastRemoteActionResult | cloudPcRemoteActionResult | 企业云电脑的最后一个远程操作结果。 支持的远程操作包括：Reboot、、RenameReprovision、Restore、 和 Troubleshoot。 |
| managedDeviceId | String | 云电脑Intune设备 ID。 |
| managedDeviceName | String | 云电脑Intune设备名称。 |
| onPremisesConnectionName | String | 在预配云电脑期间应用的 Azure 网络连接。 |
| osVersion | cloudPcOperatingSystem | 操作系统的版本 (操作系统) 在云电脑上进行预配。 可能的值为： windows10、 windows11和 unknownFutureValue。 |
| partnerAgentInstallResults | cloudPcPartnerAgentInstallResult 集合 | 每个合作伙伴代理在云电脑上的安装状态的结果。 |
| provisioningPolicyId | String | 云电脑的预配策略 ID。 |
| provisioningPolicyName | String | 在预配云电脑期间应用的预配策略。 |
| provisioningType | cloudPcProvisioningType | 使用此策略预配云电脑时要使用的许可证类型。 可取值为：dedicated、shared、unknownFutureValue。 默认值为 dedicated。 |
| servicePlanId | String | 云电脑的服务计划 ID。 |
| servicePlanName | String | 云电脑的服务计划名称。 |
| servicePlanType | cloudPcServicePlanType | 云电脑的服务计划类型。 |
| status | cloudPcStatus | 云电脑的状态。 可取值为：notProvisioned、provisioning、provisioned、upgrading、inGracePeriod、deprovisioning、failed、restoring。 |
| statusDetails | cloudPcStatusDetails | 云电脑状态的详细信息。 |
| userAccountType | cloudPcUserAccountType | 预配的云电脑上用户的帐户类型。 可能的值为： standardUser、 administrator和 unknownFutureValue。 |
| userPrincipalName | String | 分配给云电脑的用户的用户主体名称 (UPN) 。 |
cloudPcDiskEncryptionState 值
| 成员 | 说明 |
|---|---|
| notAvailable | 云电脑未预配，或处于加密不可用的状态。 |
| notEncrypted | 应加密云电脑，但加密尚未完成 (保留，不应) 发生。 |
| encryptedUsingPlatformManagedKey | 云电脑使用平台托管密钥进行加密。 如果未启用客户管理的密钥，则此值为默认值。 |
| encryptedUsingCustomerManagedKey | 云电脑使用客户管理的密钥进行加密。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
cloudPcStatus 值
| 成员 | 说明 |
|---|---|
| notProvisioned | 尚未预配云电脑。 |
| 供应 | 云电脑预配正在进行中。 |
| 已设置 | 云电脑已预配，可供最终用户访问。 |
| inGracePeriod | 云电脑处于取消预配前的一周宽限期。 |
| 取消预配 | 云电脑正在取消预配。 |
| 失败 | 云电脑上的操作失败。 |
| provisionedWithWarnings | 云电脑已预配，最终用户可以访问，但存在一些警告。 用户可以继续使用此云电脑。 |
| 调整 | 云电脑正在调整大小。 |
| pendingProvision | 预配在云电脑上挂起。 在这种情况下，宽限期内的云电脑数大于可用许可证总数。 |
| 恢复 | 云电脑正在还原。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
shiftWorkCloudPcAccessState 值
下表列出了 可演变枚举的成员。 必须使用 Prefer: include-unknown-enum-members 请求标头来获取此可演变枚举中的以下值： hibernated。
| 成员 | 说明 |
|---|---|
| 未分配 | 如果云电脑未使用任何共享使用许可证，则设置为取消分配。 默认值为 unassigned。 |
| noLicensesAvailable | 指示所有共享使用许可证都在使用中。 |
| activationFailed | 指示在用户请求轮班工作云电脑后，班次工作云电脑激活失败。 |
| 积极 | 指示班次工作云电脑处于活动状态，并分配了共享使用许可证，并且用户可以连接到云电脑。 |
| 激活 | 指示请求连接云电脑和服务的用户正在启动。 |
| waitlisted (已弃用) | 指示在用户请求连接此云电脑并主动使用所有共享使用许可证后，排班工作云电脑处于等待列表状态。 此值已弃用，将于 2023 年 5 月 17 日停止返回。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
| 冬眠 | 指示班次工作云电脑在关闭和解除分配之前处于休眠状态。 处于休眠状态的排班工作云电脑仍可供用户访问。 |
关系
无。
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.cloudPC",
"aadDeviceId": "String",
"connectivityResult": "String",
"diskEncryptionState": "String",
"displayName": "String",
"gracePeriodEndDateTime": "String (timestamp)",
"id": "String (identifier)",
"imageDisplayName": "String",
"lastLoginResult": "String",
"lastModifiedDateTime": "String (timestamp)",
"lastRemoteActionResult": "String",
"managedDeviceId": "String",
"managedDeviceName": "String",
"onPremisesConnectionName": "String",
"osVersion": "String",
"partnerAgentInstallResults": "String",
"provisioningPolicyId": "String",
"provisioningPolicyName": "String",
"provisioningType": "String",
"servicePlanId": "String",
"servicePlanName": "String",
"servicePlanType": "String",
"status": "String",
"userAccountType": "String",
"userPrincipalName": "String"
}