cloudPcProvisioningPolicy 资源类型

命名空间:microsoft.graph

表示云电脑预配策略。

继承自 entity。

Methods

方法 返回类型 Description
List cloudPcProvisioningPolicy 集合 列出 cloudPcProvisioningPolicy 对象的属性和关系。
创建 cloudPcProvisioningPolicy 创建新的 cloudPcProvisioningPolicy 对象。
Get cloudPcProvisioningPolicy 读取 cloudPcProvisioningPolicy 对象的属性和关系。
更新 cloudPcProvisioningPolicy 更新 cloudPcProvisioningPolicy 对象的属性。
删除 无 删除 cloudPcProvisioningPolicy 对象。
Assign 无 将 cloudPcProvisioningPolicy 分配给用户组。

属性

属性 类型 说明
alternateResourceUrl String 链接到此预配策略的备用资源的 URL。 只读。
autopatch cloudPcProvisioningPolicyAutopatch 指示使用此预配策略的云电脑的 Windows 自动修补设置。 当租户在 Autopatch 中注册并且 microsoftManagedDesktop 属性的 managedType 设置为 starterManaged时,设置将生效。 支持 $select。
cloudPcGroupDisplayName String 云电脑所在的云电脑组的显示名称。 只读。
cloudPcNamingTemplate String 用于命名使用此策略预配的云电脑的模板。 模板可以包含自定义文本和替换令牌,包括 %USERNAME:x% 和 %RAND:x%,分别表示用户名和随机生成的数字。 例如, CPC-%USERNAME:4%-%RAND:5% 表示云电脑的名称以 CPC-开头,后跟一个四个字符的用户名、一个字符 - ,然后是五个随机字符。 模板生成的文本的总长度不能超过 15 个字符。 支持 $filter、$select 和 $orderby。
description String 预配策略说明。 支持 $filter、$select 和 $orderBy。
displayName String 预配策略的显示名称。
domainJoinConfigurations cloudPcDomainJoinConfiguration 集合 指定按优先级排序的列表,说明云电脑加入Microsoft Entra ID (Azure AD) 的方式。 支持 $select。
enableSingleSignOn 布尔值 True 如果可以通过单一登录访问预配的云电脑,则为 。 False 指示预配的云电脑不支持此功能。 默认值为 false。 Windows 365用户可以使用单一登录通过无密码选项 (Microsoft Entra ID进行身份验证,例如 FIDO 密钥) 访问其云电脑。 可选。
gracePeriodInHours Int32 在重新预配/取消预配之前等待的小时数。 只读。
id String 与预配策略关联的唯一标识符。 创建新预配策略期间会自动填充此 ID。 支持 $filter、$select 和 $orderBy。 只读。 继承自 entity。
imageDisplayName String 用于预配的作系统映像的显示名称。 例如,Windows 11 Preview + Microsoft 365 Apps 23H2 23H2。 支持 $filter、$select 和 $orderBy。
imageId String 表示用于预配新云电脑的作系统映像的唯一标识符。 库类型图像的格式为:{publisherName_offerName_skuName}。 每个参数支持的值为:
  • 发行人: Microsoftwindowsdesktop
  • 提供: windows-ent-cpc
  • sku:21h1-ent-cpc-m365、21h1-ent-cpc-os、、20h2-ent-cpc-os20h2-ent-cpc-m365、20h1-ent-cpc-m36520h1-ent-cpc-os、19h2-ent-cpc-m365、 和19h2-ent-cpc-os
支持 $filter、$select 和 $orderBy。
imageType cloudPcProvisioningPolicyImageType 作系统映像的类型 (用于在云电脑上进行预配的自定义或库) 。 可能的值为: gallery、 custom。 默认值为 gallery。 支持$filter、$select和$orderBy。
localAdminEnabled 布尔值 如果 true为 ,则为云电脑启用本地管理员; false 指示未为云电脑启用本地管理员。 默认值为 false。 支持 $filter、$select 和 $orderBy。
microsoftManagedDesktop microsoftManagedDesktop microsoftManagedDesktop 的特定设置,使Microsoft托管桌面客户能够获取云电脑的设备托管体验。 若要使 microsoftManagedDesktop 提供更多价值,管理员需要在其中指定某些设置。 支持 $filter、$select 和 $orderBy。
provisioningType cloudPcProvisioningType 指定使用此策略预配云电脑时使用的许可证类型。 默认情况下,如果在创建 cloudPcProvisioningPolicy 时未指定 provisioningType,则许可证类型dedicated为 。 创建 cloudPcProvisioningPolicy 后,无法更改此属性。 可能的值包括 dedicated、shared、unknownFutureValue。
windowsSetting cloudPcWindowsSetting 指示在为此预配策略创建云电脑期间要配置的特定 Windows 设置。 支持 $select。

cloudPcProvisioningPolicyImageType 值

成员 说明
习惯 指示云电脑作系统映像的预配策略设置为 自定义映像。 IT 管理员需要创建、配置和上传自定义映像。
画廊 指示云电脑作系统映像的预配策略设置为 库映像。 库映像是由 Microsoft 提供的优化 Windows 映像。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

cloudPcProvisioningType 值

成员 说明
耿耿 指示专用许可证用于预配云电脑。 默认值。
shared 指示共享许可证用于预配云电脑。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

关系

关系 类型 说明
assignments cloudPcProvisioningPolicyAssignment 集合 预配策略分配的已定义集合。 表示Microsoft Entra ID中分配了预配策略的Microsoft 365 个组和安全组的集合。 仅在 $expand 上返回。 有关如何获取分配关系的示例,请参阅 获取 cloudPcProvisioningPolicy。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "alternateResourceUrl": "String",
  "autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
  "cloudPcGroupDisplayName": "String",
  "cloudPcNamingTemplate": "String",
  "description": "String",
  "displayName": "String",
  "domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
  "enableSingleSignOn": "Boolean",
  "gracePeriodInHours": "Int32",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "imageId": "String",
  "imageType": "String",
  "localAdminEnabled": "Boolean",
  "microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
  "provisioningType": "String",
  "windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"}
}