创建 cloudPcProvisioningPolicy

项目
03/09/2023

命名空间：microsoft.graph

重要

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

权限

调用此 API 需要以下权限之一。若要了解详细信息，包括如何选择权限的信息，请参阅权限。

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

HTTP 请求

POST /deviceManagement/virtualEndpoint/provisioningPolicies

请求标头

名称	说明
Authorization	持有者 {token}。必填。
Content-Type	application/json. 必需。

请求正文

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

下表显示了创建 cloudPcProvisioningPolicy 时所需的属性。

属性	类型	说明
说明	String	预配策略说明。
displayName	String	预配策略的显示名称。
domainJoinConfiguration	cloudPcDomainJoinConfiguration	指定云电脑如何加入 Azure Active Directory。
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-m365、20h1-ent-cpc-os、19h2-ent-cpc-m365 和 19h2-ent-cpc-os。
imageType	cloudPcProvisioningPolicyImageType	要在云电脑上预配的 OS 映像类型 (自定义或库) 。可取值为：`gallery`、`custom`。
onPremisesConnectionId	String	cloudPcOnPremisesConnection 的 ID。若要确保云电脑具有网络连接并加入域，请选择与云电脑服务验证的虚拟网络的连接。
provisioningType	cloudPcProvisioningType	指定使用此策略预配云电脑时使用的许可证类型。默认情况下，如果在创建 cloudPcProvisioningPolicy 时未指定 provisioningType，则许可证类型`dedicated`为。创建 cloudPcProvisioningPolicy 后，无法更改此属性。可取值为：`dedicated`、`shared`、`unknownFutureValue`。
windowsSettings	cloudPcWindowsSettings	为此预配策略创建云电脑时要配置的特定 Windows 设置。

响应

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

示例

请求

请求示例如下所示。

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

{
    "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
    "description": "Description value",
    "displayName": "Display Name value",
    "domainJoinConfiguration": {
        "domainJoinType": "hybridAzureADJoin",
        "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff"
    },
    "enableSingleSignOn": true,
    "imageDisplayName": "Windows-10 19h1-evd",
    "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
    "imageType":"gallery",
    "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
    "windowsSettings": {
        "language": "en-US"
    },
    "provisioningType": "dedicated"
}


var graphClient = new GraphServiceClient(requestAdapter);

var requestBody = new CloudPcProvisioningPolicy
{
	OdataType = "#microsoft.graph.cloudPcProvisioningPolicy",
	Description = "Description value",
	DisplayName = "Display Name value",
	DomainJoinConfiguration = new CloudPcDomainJoinConfiguration
	{
		OnPremisesConnectionId = "16ee6c71-fc10-438b-88ac-daa1ccafffff",
		AdditionalData = new Dictionary<string, object>
		{
			{
				"domainJoinType" , "hybridAzureADJoin"
			},
		},
	},
	EnableSingleSignOn = true,
	ImageDisplayName = "Windows-10 19h1-evd",
	ImageId = "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
	ImageType = CloudPcProvisioningPolicyImageType.Gallery,
	OnPremisesConnectionId = "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
	WindowsSettings = new CloudPcWindowsSettings
	{
		Language = "en-US",
	},
	ProvisioningType = CloudPcProvisioningType.Dedicated,
};
var result = await graphClient.DeviceManagement.VirtualEndpoint.ProvisioningPolicies.PostAsync(requestBody);

重要

默认情况下，Microsoft Graph SDK 使用 v1.0 版本的 API，不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


const options = {
	authProvider,
};

const client = Client.init(options);

const cloudPcProvisioningPolicy = {
    '@odata.type': '#microsoft.graph.cloudPcProvisioningPolicy',
    description: 'Description value',
    displayName: 'Display Name value',
    domainJoinConfiguration: {
        domainJoinType: 'hybridAzureADJoin',
        onPremisesConnectionId: '16ee6c71-fc10-438b-88ac-daa1ccafffff'
    },
    enableSingleSignOn: true,
    imageDisplayName: 'Windows-10 19h1-evd',
    imageId: 'MicrosoftWindowsDesktop_Windows-10_19h1-evd',
    imageType: 'gallery',
    onPremisesConnectionId: '4e47d0f6-6f77-44f0-8893-c0fe1701ffff',
    windowsSettings: {
        language: 'en-US'
    },
    provisioningType: 'dedicated'
};

await client.api('/deviceManagement/virtualEndpoint/provisioningPolicies')
	.version('beta')
	.post(cloudPcProvisioningPolicy);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewCloudPcProvisioningPolicy()
description := "Description value"
requestBody.SetDescription(&description) 
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 
domainJoinConfiguration := graphmodels.NewCloudPcDomainJoinConfiguration()
onPremisesConnectionId := "16ee6c71-fc10-438b-88ac-daa1ccafffff"
domainJoinConfiguration.SetOnPremisesConnectionId(&onPremisesConnectionId) 
additionalData := map[string]interface{}{
	"domainJoinType" : "hybridAzureADJoin", 
}
domainJoinConfiguration.SetAdditionalData(additionalData)
requestBody.SetDomainJoinConfiguration(domainJoinConfiguration)
enableSingleSignOn := true
requestBody.SetEnableSingleSignOn(&enableSingleSignOn) 
imageDisplayName := "Windows-10 19h1-evd"
requestBody.SetImageDisplayName(&imageDisplayName) 
imageId := "MicrosoftWindowsDesktop_Windows-10_19h1-evd"
requestBody.SetImageId(&imageId) 
imageType := graphmodels.GALLERY_CLOUDPCPROVISIONINGPOLICYIMAGETYPE 
requestBody.SetImageType(&imageType) 
onPremisesConnectionId := "4e47d0f6-6f77-44f0-8893-c0fe1701ffff"
requestBody.SetOnPremisesConnectionId(&onPremisesConnectionId) 
windowsSettings := graphmodels.NewCloudPcWindowsSettings()
language := "en-US"
windowsSettings.SetLanguage(&language) 
requestBody.SetWindowsSettings(windowsSettings)
provisioningType := graphmodels.DEDICATED_CLOUDPCPROVISIONINGTYPE 
requestBody.SetProvisioningType(&provisioningType) 

result, err := graphClient.DeviceManagement().VirtualEndpoint().ProvisioningPolicies().Post(context.Background(), requestBody, nil)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


Import-Module Microsoft.Graph.DeviceManagement.Administration

$params = @{
	"@odata.type" = "#microsoft.graph.cloudPcProvisioningPolicy"
	Description = "Description value"
	DisplayName = "Display Name value"
	DomainJoinConfiguration = @{
		DomainJoinType = "hybridAzureADJoin"
		OnPremisesConnectionId = "16ee6c71-fc10-438b-88ac-daa1ccafffff"
	}
	EnableSingleSignOn = $true
	ImageDisplayName = "Windows-10 19h1-evd"
	ImageId = "MicrosoftWindowsDesktop_Windows-10_19h1-evd"
	ImageType = "gallery"
	OnPremisesConnectionId = "4e47d0f6-6f77-44f0-8893-c0fe1701ffff"
	WindowsSettings = @{
		Language = "en-US"
	}
	ProvisioningType = "dedicated"
}

New-MgDeviceManagementVirtualEndpointProvisioningPolicy -BodyParameter $params

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);

$requestBody = new CloudPcProvisioningPolicy();
$requestBody->set@odatatype('#microsoft.graph.cloudPcProvisioningPolicy');

$requestBody->setDescription('Description value');

$requestBody->setDisplayName('Display Name value');

$domainJoinConfiguration = new CloudPcDomainJoinConfiguration();
$domainJoinConfiguration->setOnPremisesConnectionId('16ee6c71-fc10-438b-88ac-daa1ccafffff');

$additionalData = [
'domainJoinType' => 'hybridAzureADJoin', 
];
$domainJoinConfiguration->setAdditionalData($additionalData);



$requestBody->setDomainJoinConfiguration($domainJoinConfiguration);
$requestBody->setEnableSingleSignOn(true);

$requestBody->setImageDisplayName('Windows-10 19h1-evd');

$requestBody->setImageId('MicrosoftWindowsDesktop_Windows-10_19h1-evd');

$requestBody->setImageType(new CloudPcProvisioningPolicyImageType('gallery'));

$requestBody->setOnPremisesConnectionId('4e47d0f6-6f77-44f0-8893-c0fe1701ffff');

$windowsSettings = new CloudPcWindowsSettings();
$windowsSettings->setLanguage('en-US');


$requestBody->setWindowsSettings($windowsSettings);
$requestBody->setProvisioningType(new CloudPcProvisioningType('dedicated'));



$requestResult = $graphServiceClient->deviceManagement()->virtualEndpoint()->provisioningPolicies()->post($requestBody);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

下面展示了示例响应。

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

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

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "description": "Description value",
  "displayName": "Display Name value",
  "domainJoinConfiguration": {
      "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
      "type": "hybridAzureADJoin"
  },
  "enableSingleSignOn": true,
  "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
  "imageDisplayName": "Windows-10 19h1-evd",
  "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
  "imageType":"gallery",
  "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
  "windowsSettings": {
    "language": "en-US"
  },
  "managedBy": "windows365",
  "provisioningType": "dedicated"
}

创建 cloudPcProvisioningPolicy

权限

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

其他资源

其他资源