创建 cloudPcProvisioningPolicy

  • 项目

命名空间：microsoft.graph

创建新的 cloudPcProvisioningPolicy 对象。

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

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

权限

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

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

HTTP 请求

POST /deviceManagement/virtualEndpoint/provisioningPolicies

请求标头

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

请求正文

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

下表列出了创建 cloudPcProvisioningPolicy 时所需的属性。

属性 类型 说明
cloudPcNamingTemplate String 用于命名使用此策略预配的云电脑的模板。 模板可以包含自定义文本和替换令牌，包括 %USERNAME:x% 和 %RAND:x%，分别表示用户名和随机生成的数字。 例如， CPC-%USERNAME:4%-%RAND:5% 表示云电脑的名称以 CPC-开头，后跟一个四个字符的用户名、一个字符 - ，然后是五个随机字符。 模板生成的文本的总长度不能超过 15 个字符。 支持 $filter、$select 和 $orderby。
说明 String 预配策略说明。 支持 $filter、$select 和 $orderBy。
displayName String 预配策略的显示名称。
domainJoinConfigurations cloudPcDomainJoinConfiguration 集合 指定按云电脑加入Microsoft Entra ID的优先级排序的列表。
enableSingleSignOn 布尔值 True 如果可以通过单一登录访问预配的云电脑，则为 。 False 指示预配的云电脑不支持此功能。 默认值为 false。 Windows 365用户可以使用单一登录通过无密码选项 (Microsoft Entra ID进行身份验证，例如 FIDO 密钥) 访问其云电脑。 可选。
imageDisplayName String 要预配的 OS 映像的显示名称。
imageId String 要在云电脑上预配的操作系统映像的 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。
provisioningType cloudPcProvisioningType 指定使用此策略预配云电脑时使用的许可证类型。 默认情况下，如果在创建 cloudPcProvisioningPolicy 时未指定 provisioningType，则许可证类型dedicated为 。 创建 cloudPcProvisioningPolicy 后，无法更改此属性。 可取值为：dedicated、shared、unknownFutureValue。
windowsSetting cloudPcWindowsSetting 指示在为此预配策略创建云电脑期间要配置的特定 Windows 设置。 支持 $select。

响应

如果成功，此方法在 201 Created 响应正文中返回响应代码和 cloudPcProvisioningPolicy 对象。

示例

请求

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

POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
    "description": "Description value",
    "displayName": "Display Name value",
    "domainJoinConfigurations": [
      {
        "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff",
        "domainJoinType": "hybridAzureADJoin"
      },
      {
        "onPremisesConnectionId": "26e16c71-f210-438b-88ac-d481ccafffff",
        "domainJoinType": "hybridAzureADJoin"
      }
    ],
    "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
    "enableSingleSignOn": true,
    "imageDisplayName": "Windows-10 19h1-evd",
    "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
    "imageType":"gallery",
    "windowsSetting": {
        "locale": "en-US"
    },
    "provisioningType": "dedicated"
}

响应

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

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "description": "Description value",
  "displayName": "Display Name value",
  "domainJoinConfigurations": [
    {
      "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff",
      "domainJoinType": "hybridAzureADJoin"
    },
    {
      "onPremisesConnectionId": "26e16c71-f210-438b-88ac-d481ccafffff",
      "domainJoinType": "hybridAzureADJoin"
    }
  ],
  "enableSingleSignOn": true,
  "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
  "imageDisplayName": "Windows-10 19h1-evd",
  "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
  "imageType":"gallery",
  "windowsSetting": {
      "locale": "en-US"
  },
  "provisioningType": "dedicated"
}