命名空间：microsoft.graph
表示云托管的虚拟桌面。 此云电脑还注册到 Intune 并通过 Microsoft Endpoint Manager 门户进行管理，因此云电脑也有相应的 Intune 托管设备 ID。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | cloudPC 集合 | 列出租户中的 cloudPC 设备。 |
| Get | cloudPC | 读取特定 cloudPC 对象的属性和关系。 |
| 结束宽限期 | None | 结束特定 cloudPC 对象的宽限期。 |
| 重新启动 | None | 重新启动特定的 cloudPC 对象。 |
| Rename | None | 重命名特定的 cloudPC 对象。 |
| Resize | None | 将现有 云电脑 升级或降级为具有新虚拟 CPU (vCPU) 和存储大小的配置。 |
| 还原 | None | 将特定 cloudPC 对象从快照还原到以前的状态。 |
| 疑难解答 | None | 对特定 cloudPC 对象进行故障排除。 |
| 用户列表 | cloudPC 集合 | 列出归属于已登录用户的 cloudPC 设备。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| aadDeviceId | String | 云电脑的Microsoft Entra设备 ID，也称为 Azure Active Directory (Azure AD) 设备 ID，由 GUID 格式的 32 个字符组成。 在联接到 MICROSOFT ENTRA ID 的 VM 上生成。 只读。 |
| displayName | String | 云电脑的显示名称。 最大长度为 64 个字符。 只读。 可以使用 cloudPC： 重命名 API 来修改云电脑名称。 |
| gracePeriodEndDateTime | DateTimeOffset | 宽限期结束并重新预配或取消预配的日期和时间。 仅当状态为 inGracePeriod时才需要 。 时间戳以 ISO 8601 格式和协调世界时 (UTC) 显示。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| id | String | 面向客户的云电脑实体的唯一标识符，由 GUID 格式的 32 个字符组成。 只读。 继承自 entity。 |
| imageDisplayName | String | 用于云电脑的作系统映像的名称。 最大长度为 50 个字符。 此属性仅允许字母 (A-Z、a-z) 、数字 (0-9) 以及特殊字符 (-，_) 。 属性值不能以下划线开头或结尾。 只读。 |
| lastModifiedDateTime | DateTimeOffset | 云电脑的上次修改日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| managedDeviceId | String | 云电脑的 Intune 注册设备 ID，由 GUID 格式的 32 个字符组成。 Windows 365 商业版云电脑的 managedDeviceId 属性始终为 null，因为Windows 365不会自动注册Windows 365 商业版云电脑。 只读。 |
| managedDeviceName | String | 云电脑的 Intune 注册设备名称。 Windows 365 商业版云电脑的 managedDeviceName 属性始终为 null，因为Windows 365 商业版云电脑不会通过Windows 365自动注册 Intune。 只读。 |
| onPremisesConnectionName | String | 在预配云电脑期间应用的本地连接。 只读。 |
| provisioningPolicyId | String | 云电脑的预配策略 ID，由 GUID 格式的 32 个字符组成。 策略定义用户要创建的云电脑的类型。 只读。 |
| provisioningPolicyName | String | 在预配云电脑期间应用的预配策略。 最大长度为 120 个字符。 只读。 |
| provisioningType | cloudPcProvisioningType | 使用此策略预配云电脑时要使用的许可证类型。 可取值为：dedicated、shared、unknownFutureValue。 默认值为 dedicated。 |
| servicePlanId | String | 云电脑的服务计划 ID，由 GUID 格式的 32 个字符组成。 有关服务计划的详细信息，请参阅 许可的产品名称和服务计划标识符。 只读。 |
| servicePlanName | String | 面向客户的云电脑实体的服务计划名称。 只读。 |
| userPrincipalName | String | 分配给云电脑的用户的用户主体名称 (UPN) 。 最大长度为 113 个字符。 有关用户名策略的详细信息，请参阅Microsoft Entra ID 中的密码策略和帐户限制。 只读。 |
cloudPcProvisioningType 值
| 成员 | 说明 |
|---|---|
| 耿耿 | 指示专用许可证用于预配云电脑。 默认值。 |
| shared | 指示共享许可证用于预配云电脑。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.cloudPC",
"aadDeviceId": "String",
"displayName": "String",
"gracePeriodEndDateTime": "String (timestamp)",
"id": "String (identifier)",
"imageDisplayName": "String",
"lastModifiedDateTime": "String (timestamp)",
"managedDeviceId": "String",
"managedDeviceName": "String",
"onPremisesConnectionName": "String",
"provisioningPolicyId": "String",
"provisioningPolicyName": "String",
"provisioningType": "String",
"servicePlanId": "String",
"servicePlanName": "String",
"userPrincipalName": "String"
}