更新 cloudPcProvisioningPolicy

命名空间：microsoft.graph

更新 cloudPcProvisioningPolicy 对象的属性。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） CloudPC.ReadWrite.All 不可用。
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 CloudPC.ReadWrite.All 不可用。

HTTP 请求

PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。

请求正文

在请求正文中，提供 cloudPcProvisioningPolicy 对象的 JSON 表示形式。

下表显示了可以为 cloudPcProvisioningPolicy 更新的属性。

属性 类型 说明
autopatch cloudPcProvisioningPolicyAutopatch 指示使用此预配策略的云电脑的 Windows 自动修补设置。 当租户在 Autopatch 中注册并且 microsoftManagedDesktop 属性的 managedType 设置为 starterManaged时，设置将生效。
cloudPcNamingTemplate String 用于命名使用此策略预配的云电脑的模板。 模板可以包含自定义文本和替换令牌，包括 %USERNAME:x% 和 %RAND:x%，分别表示用户名和随机生成的数字。 例如， CPC-%USERNAME:4%-%RAND:5% 表示云电脑的名称以 CPC-开头，后跟一个四个字符的用户名、一个字符 - ，然后是五个随机字符。 模板生成的文本的总长度不能超过 15 个字符。 支持 $filter、$select 和 $orderby。
description String 预配策略说明。
displayName String 预配策略的显示名称。
domainJoinConfigurations cloudPcDomainJoinConfiguration 集合 指定按云电脑加入Microsoft Entra ID的优先级排序的列表。
enableSingleSignOn 布尔值 True 如果可以通过单一登录访问预配的云电脑，则为 。 False 指示预配的云电脑不支持此功能。 默认值为 false。 Windows 365用户可以使用单一登录通过无密码选项 (Microsoft Entra ID进行身份验证，例如 FIDO 密钥) 访问其云电脑。 可选。
imageDisplayName String 要预配的 OS 映像的显示名称。
imageId String 要在云电脑上预配的 OS 映像的 ID。 库类型图像的格式为：{publisher_offer_sku}。 每个参数支持的值如下所示：
  • 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-m36520h1-ent-cpc-os、19h2-ent-cpc-m365、 和 19h2-ent-cpc-os。
imageType cloudPcProvisioningPolicyImageType 要在云电脑上预配的 OS 映像类型 (自定义或库) 。 可能的值包括 gallery、custom、unknownFutureValue。
microsoftManagedDesktop microsoftManagedDesktop microsoftManagedDesktop 的特定设置，使Microsoft托管桌面客户能够获取云电脑的设备托管体验。 若要使 microsoftManagedDesktop 提供更多价值，管理员需要在其中指定某些设置。 支持 $filter、$select 和 $orderBy。
windowsSetting cloudPcWindowsSetting 指示在为此预配策略创建云电脑期间要配置的特定 Windows 设置。 支持 $select。

响应

如果成功，此方法返回 204 No Content 响应代码。

示例

请求

以下示例显示了一个请求。

PATCH https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "displayName": "HR provisioning policy",
  "description": "Provisioning policy for India HR employees",
  "microsoftManagedDesktop": {
    "managedType": "starterManaged",
    "profile": null
  },
  "autopatch": {
    "autopatchGroupId": "91197a0b-3a74-408d-ba88-bce3fdc4e5eb"
  }
}

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content
  • Last updated on