Windows 365（预览版）

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

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Microsoft
URL https://powerautomate.microsoft.com/en-us/support/
连接器元数据
发布者 Microsoft
网站 https://www.microsoft.com/en-us/windows-365
隐私策略 https://privacy.microsoft.com/en-us/privacystatement
类别 IT作;生产力
服务 类 区域
Copilot Studio 高级 所有 Power Automate 区域
逻辑应用程序 高级 所有 逻辑应用区域
Power Apps 高级 所有 Power Apps 区域
Power Automate 高级 所有 Power Automate 区域
联系人
Name Windows 365
URL https://learn.microsoft.com/en-us/connectors/windows365
Email W365powerplatform@microsoft.com

已知问题和限制

Windows 365连接器目前为公共预览版。

Microsoft 希望在正式发布连接器之前确保此连接器稳定。 在此之前，连接器一直为预览版。 预览版将按“原样”、“不保证没有瑕疵”且“可用”提供。 它们被排除在服务级别协议 (SLA) 之外，但以预览方式提供，以便您可以提前访问并提供反馈。 详细了解预览功能以及如何启用它们。 客户支持可能未涵盖预览版。 可能会在没有通知的情况下随时中断，并且可能不会在正式发布时发布。

我们鼓励您试用预览连接器并提供反馈。 这将帮助我们稳定和改进连接器。 您可以使用产品论坛来共享问题和反馈。 Microsoft 支持可能不适用于预览功能，包括连接器，但我们会尽力提供支持。

若要了解详细信息，请访问 预览版中的连接器常见问题解答。

一般限制

  1. 功能和限制与基础 图形 API一致。
  2. 当需要在 Graph beta 终结点上调用某些内容时，请使用 HTTP 请求作。

行动：

列出云电脑

作 ID： ListCloudPCs

此作允许列出云电脑。

参数

Name 必选 类型 Description
$select 否 字符串 $select允许你选择从 Graph 返回的属性。
$filter 否 字符串 $filter允许从 Graph 获取集合的一部分。

返回

Name 类型 Description
aadDeviceId String 云电脑的Microsoft Entra设备 ID（也称为Azure Active Directory（Azure AD）设备 ID，由 GUID 格式的 32 个字符组成。 在联接到Microsoft Entra ID的 VM 上生成。 只读。
diskEncryptionState String 显示磁盘加密状态。
显示名称 String 云电脑的显示名称。 最大长度为 64 个字符。 只读。
gracePeriodEndDateTime DateTimeOffset 宽限期结束并重新预配或取消预配的日期和时间。 仅当状态为 inGracePeriod 时才是必需的。 时间戳以 ISO 8601 格式和协调世界时 (UTC) 显示。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00：00：00Z。
id String 面向客户的云电脑实体的唯一标识符，由 GUID 格式的 32 个字符组成。 只读。
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 自动注册 Intune。 只读。
managedDeviceName String Intune云电脑的已注册设备名称。 Windows 365 商业版云电脑的 managedDeviceName 属性始终为 null，因为Windows 365不会自动Intune注册Windows 365 商业版云电脑。 只读。
onPremisesConnectionName String 在预配云电脑期间应用的本地连接。 只读。
provisioningPolicyId String 云电脑的预配策略 ID，由 GUID 格式的 32 个字符组成。 策略定义用户要创建的云电脑的类型。 只读。
provisioningPolicyName String 在预配云电脑期间应用的预配策略。 最大长度为 120 个字符。 只读。
provisioningType String 显示预配类型。
servicePlanId String 云电脑的服务计划 ID，由 GUID 格式的 32 个字符组成。 有关服务计划的详细信息，请参阅 许可的产品名称和服务计划标识符。 只读。
servicePlanName String 面向客户的云电脑实体的服务计划名称。 只读。
servicePlanType String 显示计划类型。
userPrincipalName String 分配给云电脑的用户的用户主体名称 (UPN) 。 最大长度为 113 个字符。 有关用户名策略的详细信息，请参阅 Microsoft Entra ID 中的密码策略和帐户限制。 只读。

获取预配策略

作 ID： GetProvisioningPoliciesV1

此作允许返回有关预配策略的信息。

参数

Name 必选 类型 Description
$select 否 String $select允许你选择从 Graph 返回的属性。
$filter 否 String $filter允许从 Graph 获取集合的一部分。
$expand 否 String $expand允许从 Graph 返回相关资源。

返回

使用具有赋值值的$expand查看以下返回的值：

Name 类型 Description
cloudPCNamingTemplate String 用于命名使用此策略预配的云电脑的模板。 该模板可以包含自定义文本和替换令牌，包括分别表示用户名和随机生成的数字的 %USERNAME：x% 和 %RAND：x%。 例如，CPC-%USERNAME：4%-%RAND：5% 表示云电脑的名称以 CPC 开头，后跟四个字符用户名、一个字符，然后是五个随机字符。 模板生成的文本的总长度不能超过 15 个字符。
description String 预配策略说明。
显示名称 String 预配策略的显示名称。
domainJoinConfiguration cloudPcDomainJoinConfiguration 集合 指定按优先级排序的列表，说明云电脑如何加入Microsoft Entra ID（Azure AD）。
enableSingleSignOn 布尔 如此 如果预配的云电脑可以通过单一登录访问。 False 表示预配的云电脑不支持此功能。 默认值为 false。 Windows 365用户可以使用单一登录进行身份验证，以使用无密码选项（例如 FIDO 密钥）Microsoft Entra ID访问其云电脑
id String 与预配策略关联的唯一标识符。 创建新预配策略期间会自动填充此 ID。 只读。
imageDisplayName String 用于预配的作系统映像的显示名称。 例如，Windows 11预览版 + Microsoft 365 应用版 23H2 23H2。
imageId String 表示用于预配新云电脑的作系统映像的唯一标识符。 库类型图像的格式为：{publisherName_offerName_skuName}。 每个参数的支持值为：
  • publisher：Microsoftwindowsdesktop
  • 产品/服务：windows-ent-cpc
  • sku： 21h1-ent-cpc-m365， 21h1-ent-cpc-os、20h2-ent-cpc-m365、20h2-ent-cpc-os、20h1-ent-cpc-m365、20h1-ent-cpc-os、19h2-ent-cpc-m365 和 19h2-ent-cpc-os
imageType cloudPcProvisioningPolicyImageType 作系统映像的类型 (用于在云电脑上进行预配的自定义或库) 。 可能的值包括：库、自定义。 默认值为库。

获取预配策略

作 ID： GetAProvisioningPolicyV1

此作允许获取特定预配策略的详细信息。

参数

Name 必选 类型 Description
预配策略 ID 是的 String 预配策略的 ID。 必须包含。
$select 否 String $select允许你选择从 Graph 返回的属性。
$filter 否 String $filter允许从 Graph 获取集合的一部分。

返回

此操作输出是动态内容。

创建预配策略

作 ID： CreateAProvisioningPolicyV1

此作允许你创建预配策略。

参数

Name 必选 类型 Description
Name 是的 String 在预配云电脑期间应用的预配策略。 最大长度为 120 个字符
说明 是的 String 预配策略说明。
域加入配置 是的
图像 ID 是的 String 这是用于预配云电脑的映像 ID。
图像显示名称 是的 String 用于云电脑的作系统映像的名称。 最大长度为 50 个字符。 此属性仅允许字母 (A-Z、a-z) 、数字 (0-9) 以及特殊字符 (-，_) 。 属性值不能以下划线开头或结尾。
图像类型 是的 String 自定义或库。
预配类型 是的 String 共享或专用。
Windows设置/区域设置 是的 String 提供要使用的语言/区域设置。 Windows 365提供 30 多个此类语言/区域对。

还可以在“高级”参数下添加 Graph 中的其他字段。

返回

此操作输出是动态内容。

将预配策略分配给组

作 ID： AssignAProvisioningPolicyToAGroupV1

此作允许将组分配到预配策略。

参数

Name 必选 类型 Description
预配策略 ID 是的 String 这是要向其分配组的预配策略 ID。
分配 - ID
分配 - 目标组 ID 是的 String 来自 Entra ID 的用户组。

返回

此操作输出是动态内容。

更新预配策略

作 ID： UpdateAProvisioningPolicyV1

此作允许更新预配策略。

参数

Name 必选 类型 Description
预配策略 ID 是的 String 这是要更新的预配策略的预配策略 ID。
说明 否 String 这是预配策略说明将更新到的内容。

还可以在“高级”参数下添加 Graph 中的其他字段。

返回

此操作输出是动态内容。

获取预配策略

作 ID： GetAProvisioningPolicyV1

此作允许获取预配策略的详细信息。

参数

Name 必选 类型 Description
预配策略 ID 是的 String 云电脑的预配策略 ID，由 GUID 格式的 32 个字符组成。 策略定义用户要创建的云电脑的类型。
$select 否 String $select允许你选择从 Graph 返回的属性。
$expand 否 String $expand允许从 Graph 返回相关资源。

还可以在“高级”参数下添加 Graph 中的其他字段。

返回

此操作输出是动态内容。

启动远程作

作 ID： RemoteActions

此作允许你在云电脑上启动远程作。

参数

Name 必选 类型 Description
云电脑 ID 是的 String 这样，可以使用远程作指定要面向的云电脑 ID。
远程操作 是的 String 这样，你可以选择要在云电脑上执行远程作的时间。
远程操作 - 快照 ID 否 String 如果选择还原云电脑，则还必须提供快照 ID。
远程操作 - 显示名称 否 String 如果选择重命名云电脑，则还必须提供显示名称。

返回

如果成功，则返回 204 无内容响应代码。

发送Microsoft Graph HTTP 请求

作 ID： HttpRequest

此作允许你直接调用 Graph 并自定义呼叫。

参数

Name 必选 类型 Description
URI 是的 String 这样，可以指定要调用的 URI，例如： https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents
方法 是的 String 这样就可以定义调用方法。

还可以在“高级”参数下添加其他字段（标头、正文等）。

返回

此操作输出是动态内容。

触发器：

所有方案都是一个触发器的一部分，可在触发器正文本身中选择。

触发云电脑上的远程作时 允许在触发远程作时触发流。
云电脑上的远程作完成后 允许在云电脑上的远程作完成时触发流。
更新预配策略时 允许在更新预配策略时触发流
创建新的预配策略时 允许在创建预配策略时启动流。
创建云电脑时 此触发器允许在创建云电脑时启动流。

预配策略或云电脑更新时

作 ID： Webhook

当预配策略或云电脑更新时，将触发此触发器。

参数

Name 必选 类型 Description
情景 是的 下拉列表 可以在支持的方案之间进行选择：
  1. 创建云电脑时
  2. 创建新的预配策略时
  3. 更新预配策略时
  4. 云电脑上的远程作完成后
  5. 触发云电脑上的远程作时

返回

此操作输出是动态内容。

9/15 文档更新：

  1. 将“已弃用”添加到“预配策略或云电脑更新时（已弃用）”触发器的标题
  2. 在其部分下面添加：“此触发器可以继续用于现有流，但将来不会有新的更新。 建议使用新触发器。
  3. 为新触发器添加新文档，如下所示：

创建新的预配策略时

操作 ID： WebhookProvisioningPolicyCreated

参数：

Name 必选 类型 Description
筛选预配策略名称 否 String 如果想要基于策略名称模式触发流，则可以设置筛选器。 例如，如果你的组织使用预配策略名称模板，并且你想要基于该模板触发流，则可以在此处指定模板。
筛选预配策略 ID 否 String 这样，你可以选择要触发此流的单个或多个特定策略 ID。
筛选器预配类型 否 String 这样，你可以选择要触发此流的单个或多种特定预配类型。 例如，你可能只想为Windows 365 企业版预配策略触发流。

返回

此操作输出是动态内容。

创建云电脑时

操作 ID： WebhookCloudPcProvisioned

此触发器允许你根据创建云电脑时触发流。

参数

Name 必选 类型 Description
筛选器预配类型 否 String 这允许你指定哪个Windows 365版本触发此流。 可以在“OR”关系中指定筛选器中的多个类型。

返回

此操作输出是动态内容。

更新预配策略时

操作 ID： WebhookProvisioningPolicyUpdated

此触发器允许根据预配策略更新时触发流。

参数

Name 必选 类型 Description
筛选预配策略名称 否 String 这样，你可以选择要在其中触发此流的单个或多个特定策略名称。
筛选预配策略 ID 否 String 这样，你可以选择要触发此流的单个或多个特定策略 ID。
筛选器预配类型 否 String 这样，你可以选择要触发此流的单个或多种特定预配类型。 例如，你可能只想为Windows 365 企业版预配策略触发流。

返回

Name 类型 Description
provisioningPolicyId String 已更新的预配策略 ID。 由 GUID 格式的 32 个字符组成。
provisioningPolicyName String 已更新的预配策略名称。

触发云电脑上的远程作时

操作 ID： WebhookCloudPcRemoteActionTriggered

此触发器允许你根据何时触发云电脑上的远程操作来触发流。

参数

Name 必选 类型 Description
筛选器预配类型 否 String 这样，你可以选择要触发此流的单个或多种特定预配类型。 例如，你可能只想为与Windows 365 企业版预配策略相关的云电脑触发远程操作流。

返回

Name 类型 Description
CloudPcId String 远程操作已完成的云电脑 ID。
provisioningType String 预配类型，其中显示了 Windows 365 Cloud PC 版本。
actionType String 远程操作的类型，例如重启。

云电脑上的远程作完成后

操作 ID： Webhook.CloudPC.ActionCompleted

此触发器允许你根据云电脑上的远程操作完成时触发流。

参数

Name 必选 类型 Description
筛选器预配类型 否 String 这样，你可以选择要触发此流的单个或多种特定预配类型。 例如，你可能只想为与Windows 365 企业版预配策略相关的云电脑触发远程操作流。

返回

Name 类型 Description
CloudPcId String 远程操作已完成的云电脑 ID。
provisioningType String 预配类型，其中显示了 Windows 365 Cloud PC 版本。
actionType String 远程操作的类型，例如重启。

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

列出云电脑

列出 CloudPCs
创建预配策略

创建预配策略。
删除预配策略

删除预配策略。
发送Microsoft Graph HTTP 请求（预览版）

构造Microsoft Graph REST API 请求
启动远程作

在云电脑上启动远程作。
将预配策略分配给组

将预配策略分配给组。
更新预配策略

更新预配策略。
获取云电脑

获取云电脑
获取预配策略

获取特定的预配策略。
获取预配策略

获取预配策略的列表。

列出云电脑

操作 ID:
ListCloudPCs

列出 CloudPCs

参数

名称 密钥 必需 类型 说明
选择
 $select string

选择要返回的属性。
过滤器
 $filter string

例如 provisioningPolicyName eq 'XXX' and userPrincipalName eq 'XXX'

返回

名称 路径 类型 说明
ID
 id string

面向客户的云电脑实体的唯一标识符，由 GUID 格式的 32 个字符组成。
Entra 设备 ID
 aadDeviceId string

云电脑的Microsoft Entra设备 ID（也称为Azure Active Directory（Azure AD）设备 ID，由 GUID 格式的 32 个字符组成。 在联接到Microsoft Entra ID的 VM 上生成。 只读。
显示名称
 displayName string

云电脑的显示名称。 最大长度为 64 个字符。 只读。
图像显示名称
 imageDisplayName string

用于云电脑的作系统映像的名称。 最大长度为 50 个字符。
预配策略 ID
 provisioningPolicyId string

云电脑的预配策略 ID，由 GUID 格式的 32 个字符组成。 策略定义用户要创建的云电脑的类型。
预配策略名称
 provisioningPolicyName string

在预配云电脑期间应用的预配策略。
本地连接名称
 onPremisesConnectionName string

在预配云电脑期间应用的Azure网络连接。
服务计划 ID
 servicePlanId string

云电脑的服务计划 ID，由 GUID 格式的 32 个字符组成。
服务计划名称
 servicePlanName string

客户交流云电脑实体的服务计划名称。
状态
 status string

状态
用户主体名称
 userPrincipalName string

分配给云电脑的用户的用户主体名称 (UPN) 。
上次修改日期/时间
 lastModifiedDateTime string

云电脑的上次修改日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。
托管设备 ID
 managedDeviceId string

Intune注册的云电脑设备 ID，由 GUID 格式的 32 个字符组成。
托管设备名称
 managedDeviceName string

Intune云电脑的已注册设备名称。
宽限期结束日期/时间
 gracePeriodEndDateTime string

宽限期结束并重新预配或取消预配的日期和时间。
磁盘加密状态
 diskEncryptionState string

磁盘加密状态
预配类型
 provisioningType string

使用此策略预配云电脑时要使用的许可证类型。
分配显示名称
 allotmentDisplayName string

分配显示名称
状态详细信息
 statusDetail string

状态详细信息
启用单一登录
 connectionSetting.enableSingleSignOn boolean

指定预配策略是否为云电脑启用了 SSO。
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

创建预配策略

操作 ID:
CreateAProvisioningPolicyV1

创建预配策略。

参数

名称 密钥 必需 类型 说明
Name
 displayName True string

displayName
Description
 description True string

描述
domainJoinType
 domainJoinType string
类型
 type string
regionName
 regionName string
onPremisesConnectionId
 onPremisesConnectionId string
regionGroup
 regionGroup string
其他字段
 otherFields object

其他字段
启用单一登录
 enableSingleSignOn boolean

enableSingleSignOn
图像 ID
 imageId True string

imageId
图像显示名称
 imageDisplayName True string

imageDisplayName
Image 类型
 imageType True string

图像类型
预配类型
 provisioningType True string

provisioningType
区域设置
 locale True string

区域设置
托管类型
 managedType string

managedType
个人资料
 profile string

个人资料

返回

名称 路径 类型 说明
id
 id string

id
显示名称
 displayName string

预配策略显示名称。
Description
 description string

预配策略说明。
图像 ID
 imageId string

要在云电脑上预配的作系统映像的 ID。
图像显示名称
 imageDisplayName string

要预配的 OS 映像的显示名称。
Image 类型
 imageType string

要在云电脑上预配的 OS 映像类型 (自定义或库) 。
启用单一登录
 enableSingleSignOn boolean

指定预配策略是否为云电脑启用了 SSO。
云电脑命名模板
 cloudPcNamingTemplate string

用于命名使用此策略预配的云电脑的模板。
预配类型
 provisioningType string

指定使用此策略预配云电脑时使用的许可证类型。
managedBy
 managedBy string

managedBy
scopeIds
 scopeIds array of

scopeIds
自动修补设置
 autopatch string

指示使用此预配策略的云电脑Windows自动修补设置。
autopilotConfiguration
 autopilotConfiguration string

autopilotConfiguration
domainJoinConfigurations
 domainJoinConfigurations array of object

domainJoinConfigurations
domainJoinType
 domainJoinConfigurations.domainJoinType string

domainJoinType
类型
 domainJoinConfigurations.type string

类型
regionName
 domainJoinConfigurations.regionName string

regionName
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
regionGroup
 domainJoinConfigurations.regionGroup string

regionGroup
managedType
 microsoftManagedDesktop.managedType string

managedType
类型
 microsoftManagedDesktop.type string

类型
个人资料
 microsoftManagedDesktop.profile string

个人资料
区域设置
 windowsSetting.locale string

区域设置
语言
 windowsSettings.language string

语言

删除预配策略

操作 ID:
DeleteAProvisioningPolicyV1

删除预配策略。

参数

名称 密钥 必需 类型 说明
预配策略 ID
 id True string

id

发送Microsoft Graph HTTP 请求（预览版）

操作 ID:
HttpRequest

构造Microsoft Graph REST API 请求

参数

名称 密钥 必需 类型 说明
URI
 Uri True string

完整或相对 URI。 示例： https://graph.microsoft.com/{version}/{resource}
方法
 Method True string

HTTP 方法（默认值为 GET）
Body
 Body binary

请求正文内容
Content-Type
 ContentType string

正文的内容类型标头（默认值为 application/json）
CustomHeader1
 CustomHeader1 string

自定义标头 1。 以格式指定：header-name： header-value
CustomHeader2
 CustomHeader2 string

自定义标头 2。 以格式指定：header-name： header-value
CustomHeader3
 CustomHeader3 string

自定义标头 3。 以格式指定：header-name： header-value
CustomHeader4
 CustomHeader4 string

自定义标头 4。 以格式指定：header-name： header-value
CustomHeader5
 CustomHeader5 string

自定义标头 5。 以格式指定：header-name： header-value

返回

response
ObjectWithoutType

启动远程作

操作 ID:
RemoteActions

在云电脑上启动远程作。

参数

名称 密钥 必需 类型 说明
云电脑 ID
 cloudPcId True string

云电脑的唯一标识符。
远程操作
 remoteAction True string

在云电脑上执行的远程作。
云电脑快照 ID
 cloudPcSnapshotId string

还原所需的
显示名称
 displayName string

重命名所必需的

将预配策略分配给组

操作 ID:
AssignAProvisioningPolicyToAGroupV1

将预配策略分配给组。

参数

名称 密钥 必需 类型 说明
预配策略 ID
 id True string

id
预配策略 ID
 id string

这是要向其分配组的预配策略 ID
群组标识符
 groupId True string

groupId
servicePlanId
 servicePlanId string

目标 ServicePlan ID

更新预配策略

操作 ID:
UpdateAProvisioningPolicyV1

更新预配策略。

参数

名称 密钥 必需 类型 说明
预配策略 ID
 id True string

id
群组标识符
 autopatchGroupId string

autopatchGroupId
设备准备配置文件 ID
 devicePreparationProfileId string

devicePreparationProfileId
应用程序超时（以分钟为单位）
 applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
失败时设备访问被拒绝
 onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Description
 description string

描述
显示名称
 displayName string

displayName
域加入类型
 domainJoinType string

domainJoinType
本地连接 ID
 onPremisesConnectionId string

onPremisesConnectionId
区域组
 regionGroup string

regionGroup
区域名称
 regionName string

regionName
类型
 type string

类型
启用单一登录
 enableSingleSignOn boolean

enableSingleSignOn
图像显示名称
 imageDisplayName string

imageDisplayName
图像 ID
 imageId string

imageId
Image 类型
 imageType string

图像类型
托管类型
 managedType string

managedType
个人资料
 profile string

个人资料
区域设置
 locale string

区域设置
其他字段
 otherFields object

其他字段

获取云电脑

操作 ID:
GetACloudPCObject

获取云电脑

参数

名称 密钥 必需 类型 说明
云电脑 ID
 cloudPcId True string

云电脑的唯一标识符。
选择
 $select string

选择要返回的属性。

返回

名称 路径 类型 说明
ID
 id string

面向客户的云电脑实体的唯一标识符，由 GUID 格式的 32 个字符组成。
Entra 设备 ID
 aadDeviceId string

云电脑的Microsoft Entra设备 ID（也称为Azure Active Directory（Azure AD）设备 ID，由 GUID 格式的 32 个字符组成。 在联接到Microsoft Entra ID的 VM 上生成。 只读。
显示名称
 displayName string

云电脑的显示名称。 最大长度为 64 个字符。 只读。
图像显示名称
 imageDisplayName string

用于云电脑的作系统映像的名称。 最大长度为 50 个字符。
预配策略 ID
 provisioningPolicyId string

云电脑的预配策略 ID，由 GUID 格式的 32 个字符组成。 策略定义用户要创建的云电脑的类型。
预配策略名称
 provisioningPolicyName string

在预配云电脑期间应用的预配策略。
本地连接名称
 onPremisesConnectionName string

在预配云电脑期间应用的Azure网络连接。
服务计划 ID
 servicePlanId string

云电脑的服务计划 ID，由 GUID 格式的 32 个字符组成。
服务计划名称
 servicePlanName string

客户交流云电脑实体的服务计划名称。
状态
 status string

状态
用户主体名称
 userPrincipalName string

分配给云电脑的用户的用户主体名称 (UPN) 。
上次修改日期/时间
 lastModifiedDateTime string

云电脑的上次修改日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。
托管设备 ID
 managedDeviceId string

Intune注册的云电脑设备 ID，由 GUID 格式的 32 个字符组成。
托管设备名称
 managedDeviceName string

Intune云电脑的已注册设备名称。
宽限期结束日期/时间
 gracePeriodEndDateTime string

宽限期结束并重新预配或取消预配的日期和时间。
磁盘加密状态
 diskEncryptionState string

磁盘加密状态
预配类型
 provisioningType string

使用此策略预配云电脑时要使用的许可证类型。
分配显示名称
 allotmentDisplayName string

分配显示名称
状态详细信息
 statusDetail string

状态详细信息
启用单一登录
 connectionSetting.enableSingleSignOn boolean

启用单一登录
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

获取预配策略

操作 ID:
GetAProvisioningPolicyV1

获取特定的预配策略。

参数

名称 密钥 必需 类型 说明
预配策略 ID
 id True string

id
选择
 $select string

如果未指定，则返回默认属性;第一个选项返回所有属性。
展开
 $expand string

内联展开相关实体。

返回

名称 路径 类型 说明
assignments
 assignments array of object
items
 assignments object
Description
 description string

预配策略说明。
显示名称
 displayName string

预配策略显示名称。
域加入配置
 domainJoinConfigurations array of object

指定按优先级排序的列表，说明云电脑如何加入Microsoft Entra ID。
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
类型
 domainJoinConfigurations.type string

类型
managedType
 microsoftManagedDesktop.managedType string

managedType
个人资料
 microsoftManagedDesktop.profile string

个人资料
autopatchGroupId
 autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
启用单一登录
 enableSingleSignOn boolean

指定预配策略是否为云电脑启用了 SSO。
Id
 id string

id
图像显示名称
 imageDisplayName string

要预配的 OS 映像的显示名称。
图像 ID
 imageId string

要在云电脑上预配的作系统映像的 ID。
Image 类型
 imageType string

要在云电脑上预配的 OS 映像类型 (自定义或库) 。
区域设置
 windowsSetting.locale string

区域设置
managedBy
 managedBy string

managedBy
预配类型
 provisioningType string

指定使用此策略预配云电脑时使用的许可证类型。

获取预配策略

操作 ID:
GetProvisioningPoliciesV1

获取预配策略的列表。

参数

名称 密钥 必需 类型 说明
选择
 $select string

如果未指定，则返回默认属性;第一个选项返回所有属性。
过滤器
 $filter string

按属性值筛选项。
展开
 $expand string

内联展开相关实体。

返回

名称 路径 类型 说明
value
 value array of object

value
assignments
 value.assignments array of object
items
 value.assignments object
Description
 value.description string

预配策略说明。
显示名称
 value.displayName string

预配策略显示名称。
域加入配置
 value.domainJoinConfigurations array of object

指定按优先级排序的列表，说明云电脑如何加入Microsoft Entra ID。
onPremisesConnectionId
 value.domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
类型
 value.domainJoinConfigurations.type string

类型
managedType
 value.microsoftManagedDesktop.managedType string

managedType
个人资料
 value.microsoftManagedDesktop.profile string

个人资料
autopatchGroupId
 value.autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 value.autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 value.autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 value.autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
启用单一登录
 value.enableSingleSignOn boolean

指定预配策略是否为云电脑启用了 SSO。
Id
 value.id string

id
图像显示名称
 value.imageDisplayName string

要预配的 OS 映像的显示名称。
图像 ID
 value.imageId string

要在云电脑上预配的作系统映像的 ID。
Image 类型
 value.imageType string

要在云电脑上预配的 OS 映像类型 (自定义或库) 。
区域设置
 value.windowsSetting.locale string

区域设置
managedBy
 value.managedBy string

managedBy
预配类型
 value.provisioningType string

指定使用此策略预配云电脑时使用的许可证类型。

触发器

云电脑上的远程作完成后

允许在云电脑上的远程作完成时触发流。
创建云电脑时

此触发器允许在创建云电脑时启动流。
创建新的预配策略时

允许在创建预配策略时启动流。
更新预配策略或云电脑时（已弃用） [已弃用]

更新预配策略或云电脑时（已弃用）
更新预配策略时

允许在更新预配策略时触发流
触发云电脑上的远程作时

允许在云电脑上的远程作完成时触发流。

云电脑上的远程作完成后

操作 ID:
WebhookCloudPcRemoteActionCompleted

允许在云电脑上的远程作完成时触发流。

参数

名称 密钥 必需 类型 说明
预配类型
 provisioningTypeNames array of string

选择一个或多个预配类型。

返回

名称 路径 类型 说明
array of object
tenantId
 data.tenantId string

tenantId
分类
 data.category string

分类
操作
 data.action string

操作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

创建云电脑时

操作 ID:
WebhookCloudPcProvisioned

此触发器允许在创建云电脑时启动流。

参数

名称 密钥 必需 类型 说明
预配类型
 provisioningTypeNames array of string

选择一个或多个预配类型。

返回

名称 路径 类型 说明
array of object
tenantId
 data.tenantId string

tenantId
分类
 data.category string

分类
操作
 data.action string

操作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

创建新的预配策略时

操作 ID:
WebhookProvisioningPolicyCreated

允许在创建预配策略时启动流。

参数

名称 密钥 必需 类型 说明
预配策略名称
 provisioningPolicyNames array of string

选择要监视更新的预配策略。
预配策略 ID
 provisioningPolicyIds array of string

输入一个或多个预配策略 ID。
预配类型
 provisioningTypeNames array of string

选择一个或多个预配类型。

返回

名称 路径 类型 说明
array of object
tenantId
 data.tenantId string

tenantId
分类
 data.category string

分类
操作
 data.action string

操作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

更新预配策略或云电脑时（已弃用） [已弃用]

操作 ID:
Webhook

更新预配策略或云电脑时（已弃用）

参数

名称 密钥 必需 类型 说明
方案
 scenario True string

方案

更新预配策略时

操作 ID:
WebhookProvisioningPolicyUpdated

允许在更新预配策略时触发流

参数

名称 密钥 必需 类型 说明
预配策略名称
 provisioningPolicyNames array of string

选择要监视更新的预配策略。
预配策略 ID
 provisioningPolicyIds array of string

输入一个或多个预配策略 ID。
预配类型
 provisioningTypeNames array of string

选择一个或多个预配类型。

返回

名称 路径 类型 说明
array of object
tenantId
 data.tenantId string

tenantId
分类
 data.category string

分类
操作
 data.action string

操作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

触发云电脑上的远程作时

操作 ID:
WebhookCloudPcRemoteActionTriggered

允许在云电脑上的远程作完成时触发流。

参数

名称 密钥 必需 类型 说明
预配类型
 provisioningTypeNames array of string

选择一个或多个预配类型。

返回

名称 路径 类型 说明
array of object
tenantId
 data.tenantId string

tenantId
分类
 data.category string

分类
操作
 data.action string

操作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

定义

ObjectWithoutType