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作;生产力 |
Windows 365 连接器提供在 Microsoft Intune 环境中管理 Windows 365 云电脑和预配策略的作。 通过此连接器,可以通过 Power Automate 流自动执行云电脑生命周期作、预配策略管理和管理任务。
服务、类和区域
| 服务 | 类 | Regions |
|---|---|---|
| Copilot Studio | 高级 | 所有 Power Automate 区域 |
| 逻辑应用程序 | 高级 | 所有逻辑应用区域 |
| Power Apps | 高级 | 所有 Power Apps 区域 |
| Power Automate | 高级 | 所有 Power Automate 区域 |
联系人
| 联系人 | |
|---|---|
| Name | Windows 365 |
| URL | https://learn.microsoft.com/en-us/connectors/windows365 |
W365powerplatform@microsoft.com |
先决条件
若要使用此连接器,需要:
- 组织的 Windows 365 许可证
- Microsoft Intune 订阅
- Microsoft Intune 基于角色的访问控制(RBAC)中有足够的权限来管理 Windows 365 资源
- 具有适当权限的 Azure AD 帐户
所需的权限
用户必须具有以下 Intune RBAC 角色之一:
- 全局管理员
- Intune 服务管理员
- Windows365 管理员(适用于特定于云电脑的作)
- 具有 Windows 365 权限的
Webhook.Create自定义角色(需要和Webhook.Delete触发作)
重要说明:此连接器需要 Windows 365 许可证和适当的Microsoft Intune RBAC 权限。 所有作都使用Microsoft图形 API,并受图形 API 限制的限制。
已知问题和限制
Windows 365 连接器目前以公共预览版提供。
Microsoft 希望在正式发布连接器之前确保此连接器稳定。 在此之前,连接器一直为预览版。 预览版将按“原样”、“不保证没有瑕疵”且“可用”提供。 它们被排除在服务级别协议 (SLA) 之外,但以预览方式提供,以便您可以提前访问并提供反馈。 详细了解预览功能以及如何启用这些功能。 客户支持可能未涵盖预览版。 可能会在没有通知的情况下随时中断,并且可能不会在正式发布时发布。
我们鼓励您试用预览连接器并提供反馈。 这将帮助我们稳定和改进连接器。 您可以使用产品论坛来共享问题和反馈。 Microsoft 支持可能不适用于预览功能,包括连接器,但我们会尽力提供支持。 若要了解详细信息,请访问 预览版中的连接器常见问题解答。
一般限制
- 功能和限制与基础 图形 API 一致。
- 当需要在 Graph beta 终结点上调用某些内容时,请使用 HTTP 请求作。
行动
列出云电脑
作 ID: ListCloudPCs
此作允许列出云电脑。
参数
| Name | 必选 | 类型 | Description |
|---|---|---|---|
| $select | 否 | 字符串 | $select允许你选择从 Graph 返回的属性。 |
| $过滤器 | 否 | 字符串 | $filter允许从 Graph 获取集合的一部分。 |
返回
| Name | 类型 | Description |
|---|---|---|
| aadDeviceId | String | 云电脑的Microsoft Entra设备 ID,也称为 Azure Active Directory (Azure AD) 设备 ID,由 GUID 格式的 32 个字符组成。 在联接到Microsoft Entra ID的 VM 上生成。 只读。 |
| diskEncryptionState | String | 显示磁盘加密状态。 |
| displayName | 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 商业版云电脑不会由 Windows 365 自动注册 Intune。 只读。 |
| 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 返回的属性。 |
| $过滤器 | 否 | String | $filter允许从 Graph 获取集合的一部分。 |
| $expand | 否 | String | $expand允许从 Graph 返回相关资源。 |
返回
使用具有赋值值的$expand查看以下返回的值:
| Name | 类型 | Description |
|---|---|---|
| cloudPCNamingTemplate | String | 用于命名使用此策略预配的云电脑的模板。 该模板可以包含自定义文本和替换令牌,包括分别表示用户名和随机生成的数字的 %USERNAME:x% 和 %RAND:x%。 例如,CPC-%USERNAME:4%-%RAND:5% 表示云电脑的名称以 CPC 开头,后跟四个字符用户名、一个字符,然后是五个随机字符。 模板生成的文本的总长度不能超过 15 个字符。 |
| 描述 | String | 预配策略说明。 |
| displayName | 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 |
| 图像类型 | cloudPcProvisioningPolicyImageType | 作系统映像的类型 (用于在云电脑上进行预配的自定义或库) 。 可能的值包括:库、自定义。 默认值为库。 |
获取预配策略
作 ID: GetAProvisioningPolicyV1
此作允许获取特定预配策略的详细信息。
参数
| Name | 必选 | 类型 | Description |
|---|---|---|---|
| 预配策略 ID | 是的 | String | 预配策略的 ID。 必须包含。 |
| $select | 否 | String | $select允许你选择从 Graph 返回的属性。 |
| $过滤器 | 否 | String | $filter允许从 Graph 获取集合的一部分。 |
返回
此操作输出是动态内容。
创建预配策略
作 ID: CreateAProvisioningPolicyV1
此作允许你创建预配策略。
参数
| Name | 必选 | 类型 | Description |
|---|---|---|---|
| Name | 是的 | String | 在预配云电脑期间应用的预配策略。 最大长度为 120 个字符 |
| Description | 是的 | String | 预配策略说明。 |
| 域加入配置 | 是的 | ||
| 图像 ID | 是的 | String | 这是用于预配云电脑的映像 ID。 |
| 图像显示名称 | 是的 | String | 用于云电脑的作系统映像的名称。 最大长度为 50 个字符。 此属性仅允许字母 (A-Z、a-z) 、数字 (0-9) 以及特殊字符 (-,_) 。 属性值不能以下划线开头或结尾。 |
| Image 类型 | 是的 | String | 自定义或库。 |
| 预配类型 | 是的 | String | 共享或专用。 |
| Windows 设置/区域设置 | 是的 | String | 提供要使用的语言/区域设置。 Windows 365 提供 30 多个此类语言/区域对。 |
还可以在“高级”参数下添加 Graph 中的其他字段。
返回
此操作输出是动态内容。
将预配策略分配给组
作 ID: AssignAProvisioningPolicyToAGroupV1
此作允许将组分配到预配策略。
参数
| Name | 必选 | 类型 | Description |
|---|---|---|---|
| 预配策略 ID | 是的 | String | 这是要向其分配组的预配策略 ID。 |
| 分配 - 目标组 ID | 是的 | String | 来自 Entra ID 的用户组。 |
| 分配 - 目标 ServicePlan ID | 否 | String | 服务计划的唯一标识符,指示要为用户预配的云电脑的大小。 |
返回
此操作输出是动态内容。
更新预配策略
作 ID: UpdateAProvisioningPolicyV1
此作允许更新预配策略。
参数
| Name | 必选 | 类型 | Description |
|---|---|---|---|
| 预配策略 ID | 是的 | String | 这是要更新的预配策略的预配策略 ID。 |
| Description | 否 | String | 这是预配策略说明将更新到的内容。 |
还可以在“高级”参数下添加 Graph 中的其他字段。
返回
此操作输出是动态内容。
获取预配策略
作 ID: GetAProvisoningPolicyV1
此作允许获取预配策略的详细信息。
参数
| 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图形 HTTP 请求
作 ID: HttpRequest
此作允许你直接调用 Graph 并自定义呼叫。
参数
| Name | 必选 | 类型 | Description |
|---|---|---|---|
| URI | 是的 | String | 这样,可以指定要调用的 URI,例如: https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents |
| 方法 | 是的 | String | 这样就可以定义调用方法。 |
还可以在“高级”参数下添加其他字段(标头、正文等)。
返回
此操作输出是动态内容。
Triggers
所有方案都是一个触发器的一部分,可在触发器正文本身中选择。
| 触发器名称 | 说明 |
|---|---|
| 触发云电脑上的远程作时 | 允许在触发远程作时触发流。 |
| 云电脑上的远程作完成后 | 允许在云电脑上的远程作完成时触发流。 |
| 更新预配策略时 | 允许在更新预配策略时触发流。 |
| 创建新的预配策略时 | 允许在创建预配策略时启动流。 |
| 创建云电脑时 | 此触发器允许在创建云电脑时启动流。 |
预配策略或云电脑更新时
- 作 ID: Webhook
- 描述: 当预配策略或云电脑更新时,将触发此触发器。
参数
| Name | 必选 | 类型 | Description |
|---|---|---|---|
| Scenario | 是的 | 下拉列表 | 可以在支持的方案之间进行选择: |
| - 创建云电脑时 | |||
| - 创建新的预配策略时 | |||
| - 更新预配策略时 | |||
| - 云电脑上的远程作完成后 | |||
| - 触发云电脑上的远程作时 |
返回
此操作输出是动态内容。
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 列出云电脑 |
列出 CloudPCs |
| 创建预配策略 |
创建预配策略。 |
| 删除预配策略 |
删除预配策略。 |
| 发送Microsoft图形 HTTP 请求(预览版) |
构造Microsoft图形 REST API 请求 |
| 启动远程作 |
在云电脑上启动远程作。 |
| 将预配策略分配给组 |
将预配策略分配给组。 |
| 更新预配策略 |
更新预配策略。 |
| 获取云电脑 |
获取云电脑 |
| 获取预配策略 |
获取特定的预配策略。 |
| 获取预配策略 |
获取预配策略的列表。 |
列出云电脑
列出 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 |
创建预配策略
创建预配策略。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
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
|
id | True | string |
id |
发送Microsoft图形 HTTP 请求(预览版)
构造Microsoft图形 REST API 请求
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
完整或相对 URI。 示例: |
|
方法
|
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
|
cloudPcId | True | string |
云电脑的唯一标识符。 |
|
远程操作
|
remoteAction | True | string |
在云电脑上执行的远程作。 |
|
云电脑快照 ID
|
cloudPcSnapshotId | string |
还原所需的 |
|
|
显示名称
|
displayName | string |
重命名所必需的 |
将预配策略分配给组
将预配策略分配给组。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
预配策略 ID
|
id | True | string |
id |
|
预配策略 ID
|
id | string |
这是要向其分配组的预配策略 ID |
|
|
群组标识符
|
groupId | True | string |
groupId |
|
servicePlanId
|
servicePlanId | string |
目标 ServicePlan ID |
更新预配策略
更新预配策略。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
预配策略 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
|
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
|
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 |
指定使用此策略预配云电脑时使用的许可证类型。 |
获取预配策略
获取预配策略的列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
选择
|
$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 |
指定使用此策略预配云电脑时使用的许可证类型。 |
触发器
| 预配策略或云电脑更新时 |
预配策略或云电脑更新时 |
预配策略或云电脑更新时
预配策略或云电脑更新时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
方案
|
scenario | True | string |
方案 |