cloudPcProvisioningPolicy 资源类型

命名空间:microsoft.graph

重要

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

表示云电脑预配策略。

方法

方法 返回类型 说明
List provisioningPolicies cloudPcProvisioningPolicy 集合 列出 cloudPcProvisioningPolicy 对象的属性和关系。
获取 cloudPcProvisioningPolicy cloudPcProvisioningPolicy 读取 cloudPcProvisioningPolicy 对象的属性和关系。
创建 cloudPcProvisioningPolicy cloudPcProvisioningPolicy 创建新的 cloudPcProvisioningPolicy 对象。
更新 cloudPcProvisioningPolicy cloudPcProvisioningPolicy 更新 cloudPcProvisioningPolicy 对象的属性。
删除 cloudPcProvisioningPolicy None 删除 cloudPcProvisioningPolicy 对象。
分配 cloudPcProvisioningPolicy None cloudPcProvisioningPolicy 分配给用户组。

属性

属性 类型 说明
alternateResourceUrl String 链接到此预配策略的备用资源的 URL。 此为只读属性。
cloudPcGroupDisplayName String 云电脑所在的云电脑组的显示名称。 此为只读属性。
cloudPcNamingTemplate String 用于命名使用此策略预配的云电脑的模板。 模板可以包含自定义文本和替换令牌,包括 %USERNAME:x%%RAND:x%,分别表示用户名和随机生成的数字。 例如, CPC-%USERNAME:4%-%RAND:5% 表示云电脑的名称以 CPC-开头,后跟一个四个字符的用户名、一个字符 - ,然后是五个随机字符。 模板生成的文本的总长度不能超过 15 个字符。 支持 $filter$select$orderby
说明 字符串 预配策略说明。 支持 $filter$select$orderBy
displayName 字符串 预配策略的显示名称。
domainJoinConfigurations cloudPcDomainJoinConfiguration 集合 指定按优先级排序的列表,说明云电脑加入Microsoft Entra ID (Azure AD) 的方式。 支持 $select
enableSingleSignOn 布尔值 True 如果可以通过单一登录访问预配的云电脑,则为 。 False 指示预配的云电脑不支持此功能。 默认值为 false。 Windows 365用户可以使用单一登录通过无密码选项 (Microsoft Entra ID进行身份验证,例如 FIDO 密钥) 访问其云电脑。 可选。
gracePeriodInHours Int32 在重新预配/取消预配之前等待的小时数。 只读。
id 字符串 与预配策略关联的唯一标识符。 创建新预配策略期间会自动填充此 ID。 此为只读属性。 支持 $filter$select$orderBy
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-m36521h1-ent-cpc-os、、20h2-ent-cpc-os20h2-ent-cpc-m36520h1-ent-cpc-m36520h1-ent-cpc-os19h2-ent-cpc-m365、 和19h2-ent-cpc-os
支持 $filter$select$orderBy
imageType cloudPcProvisioningPolicyImageType 操作系统映像的类型 (用于在云电脑上进行预配的自定义或库) 。 可取值为:gallerycustom。 默认值为 gallery。 支持$filter、$select和$orderBy。
localAdminEnabled 布尔值 如果 true为 ,则为云电脑启用本地管理员; false 指示未为云电脑启用本地管理员。 默认值为 false。 支持 $filter$select$orderBy
managedBy cloudPcManagementService 指示管理预配策略的服务。 可能的值是:windows365devBoxunknownFutureValuerpaBox。 默认值为 windows365。 请注意,必须使用 Prefer: include-unknown-enum-members 请求标头获取此 可进化枚举 中的以下值: rpaBox。 支持 $filter$select$orderBy
microsoftManagedDesktop microsoftManagedDesktop MicrosoftManagedDesktop 的特定设置,使 Microsoft 托管桌面客户能够获取云电脑的设备托管体验。 若要使 microsoftManagedDesktop 提供更多价值,管理员需要在其中指定某些设置。 支持 $filter$select$orderBy
provisioningType cloudPcProvisioningType 指定使用此策略预配云电脑时使用的许可证类型。 默认情况下,如果在创建 cloudPcProvisioningPolicy 时未指定 provisioningType,则许可证类型dedicated为 。 创建 cloudPcProvisioningPolicy 后,无法更改此属性。 可取值为:dedicatedsharedunknownFutureValue
windowsSetting cloudPcWindowsSettings 指示在为此预配策略创建云电脑期间要配置的特定 Windows 设置。 支持 $select
domainJoinConfiguration (已弃用) cloudPcDomainJoinConfiguration 指定云电脑加入Microsoft Entra ID的方式。
onPremisesConnectionId (已弃用) String cloudPcOnPremisesConnection 的 ID。 若要确保云电脑具有网络连接并加入域,请选择与云电脑服务验证的虚拟网络的连接。
windowsSettings (已弃用) cloudPcWindowsSettings 为此预配策略创建云电脑期间要配置的特定 Windows 设置。 支持 $selectwindowsSettings 属性已弃用,将于 2024 年 1 月 31 日停止返回数据。 今后,请使用 windowsSetting 属性。

cloudPcProvisioningType 值

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

关系

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

JSON 表示形式

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

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