通过 Microsoft Graph API 使用 Windows 365 云电脑

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

Windows 365 是一项基于云的服务，可自动为最终用户创建新型 Windows 虚拟机（云电脑）。 每个云电脑都作为专用 Windows 设备分配给单个用户。 Windows 365 可提供 Microsoft 365 的工作效率、安全性和协作优势。

Microsoft 图形 API允许以编程方式访问组织的云电脑信息和管理操作。 API 执行的操作与 Microsoft Endpoint Manager 提供的操作相同。

重要

使用适用于云电脑的 Microsoft 图形 API需要组织的活动Windows 365许可证。 目前，Microsoft 图形 API可用于Windows 365 企业版和Windows 365 商业版。

使用适用于云电脑的 Microsoft 图形 API

借助 Microsoft Graph，可以在组织中预配和管理云电脑。 如果与 Intune API 结合使用，还可以管理云电脑和物理终结点。

使用 Microsoft Graph 权限

Microsoft Graph 通过权限控制对资源的访问。 开发人员必须指定访问Windows 365资源所需的权限。 通常，可以在Microsoft Entra 管理中心中指定权限。 有关详细信息，请参阅 Microsoft Graph 权限参考 并导航到 云电脑权限 部分。

常见用例

用例	REST 资源	另请参阅
列出、获取、创建、更新、删除或分配预配策略。	cloudPcProvisioningPolicy	预配概述
管理云电脑，包括重新预配、结束云电脑宽限期、批量重新预配和重设云电脑大小。	cloudPC	云电脑生命周期
列出、获取、创建、删除、获取源映像和重新加载云电脑 OS 映像。	cloudPCDeviceImage	设备映像概述
列出和获取库图像。	cloudPcGalleryImage	库图像概述
列出、获取、创建、更新删除、更新 AD 域密码，并运行 Azure 网络连接的运行状况检查。	cloudPcOnPremisesConnection	本地网络连接概述
列出云电脑的审核事件、获取特定审核事件以及获取审核活动类型。	cloudPcAuditEvent	获取云电脑审核日志
列出、获取、创建、更新、删除或分配用户设置。	cloudPcUserSetting	用户设置概述
通过预配云电脑、上传云电脑映像和检查 Azure 网络连接，设置规则以在 Microsoft Endpoint Manager 管理中心上发出问题警报。	alertRecord、 alertRule	警报监视 API

后续步骤

• 查看 Microsoft Graph 上的Windows 365 云电脑概述。
• 使用 Microsoft Graph 资源管理器试用Windows 365云电脑 API。