Atualizar cloudPcProvisioningPolicy

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualizar as propriedades de um objeto cloudPcProvisioningPolicy .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global	Governo dos EUA L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	❌	❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão	Permissões menos privilegiadas	Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante)	CloudPC.ReadWrite.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	CloudPC.ReadWrite.All	Indisponível.

Solicitação HTTP

PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto cloudPcProvisioningPolicy .

A tabela a seguir mostra as propriedades que podem ser atualizadas para o cloudPcProvisioningPolicy.

Propriedade	Tipo	Descrição
correção automática	cloudPcProvisioningPolicyAutopatch	Indica as configurações do Windows Autopatch para PCs na nuvem usando essa política de provisionamento. As configurações entram em vigor quando o locatário se registra no Autopatch e o managedType da propriedade microsoftManagedDesktop é definido como `starterManaged`. Ao atualizar uma política de provisionamento com o Autopatch, você deve usar um token delegado e o usuário conectado deve ter a função de Administrador do Intune.
autopilotConfiguration	cloudPcAutopilotConfiguration	As configurações específicas do Windows Autopilot que permitem que os clientes do Windows 365 o experimentem no Cloud PC. A atualização do autopilotConfiguration requer as permissões listadas na seção Permissões para essa API. Em cenários delegados, o usuário conectado também deve ter a permissão RBAC do `Microsoft.Intune/DeviceConfigurations/Assign` Intune.
description	Cadeia de caracteres	A descrição da política de provisionamento.
displayName	Cadeia de caracteres	O nome de exibição da política de provisionamento.
domainJoinConfigurations	Coleção cloudPcDomainJoinConfiguration	Especifica uma lista ordenada por prioridade sobre como os PCs na nuvem ingressam no Microsoft Entra ID.
enableSingleSignOn	Booliano	`True` se o PC na nuvem provisionado puder ser acessado por logon único. `False` indica que o PC na nuvem provisionado não dá suporte a esse recurso. O valor padrão é `false`. Os usuários do Windows 365 podem usar o logon único para se autenticar no Microsoft Entra ID com opções sem senha (por exemplo, chaves FIDO) para acessar seu PC na nuvem. Opcional.
imageDisplayName	Cadeia de caracteres	O nome de exibição da imagem do sistema operacional que você está provisionando.
imageId	Cadeia de caracteres	A ID da imagem do sistema operacional que você deseja provisionar em PCs na nuvem. O formato de uma imagem de tipo de galeria é: {publisher_offer_sku}. Os valores com suporte para cada um dos parâmetros são os seguintes: editora: Microsoftwindowsdesktop. Oferta: 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 e 19H2-ent-CPC-OS.
Tipo de imagem	cloudPcProvisioningPolicyImageType	O tipo de imagem do sistema operacional (personalizado ou galeria) que você deseja provisionar em computadores na nuvem. Os valores possíveis são: `gallery`, `custom`.
MicrosoftManagedDesktop	MicrosoftManagedDesktop	As configurações específicas para microsoftManagedDesktop que permite que os clientes da Área de Trabalho Gerenciada da Microsoft obtenham uma experiência gerenciada de dispositivo para o Cloud PC. Para permitir que microsoftManagedDesktop forneça mais valor, um administrador precisa especificar determinadas configurações nele.
snapshotResetMode	cloudPcSnapshotResetMode	Indica se snapshot redefinição está disponível para essa política de provisionamento. Os valores possíveis são: `notApplicable`, `enabled`, `disabled`, `unknownFutureValue`. O valor padrão é `notApplicable`.
userSettingsPersistenceConfiguration	cloudPcUserSettingsPersistenceConfiguration	Indica configurações específicas que permitem a persistência de configurações de aplicativo de usuário entre sessões do Cloud PC. O valor padrão é `null`. Esse recurso só está disponível para políticas de provisionamento de PC na nuvem do tipo `sharedByEntraGroup`. Oferece suporte para `$select`.
windowsSetting	cloudPcWindowsSettings	Indica uma configuração específica do Windows a ser configurada durante a criação de PCs na nuvem para essa política de provisionamento. Oferece suporte para `$select`.
domainJoinConfiguration (preterido)	cloudPcDomainJoinConfiguration	Especifica como PCs na nuvem ingressam no Microsoft Entra ID. A propriedade domainJoinConfiguration foi preterida e deixará de retornar dados em 31 de maio de 2024. No futuro, use a propriedade domainJoinConfigurations .
onPremisesConnectionId (preterido)	Cadeia de caracteres	A ID do cloudPcOnPremisesConnection. Para garantir que os PCs na nuvem tenham conectividade de rede e que ingressem no domínio, escolha uma conexão com uma rede virtual validada pelo serviço PC na nuvem. A propriedade onPremisesConnectionId foi preterida e deixará de retornar dados em 31 de maio de 2024. No futuro, use a propriedade domainJoinConfigurations .
windowsSettings (preterido)	cloudPcWindowsSettings	Configurações específicas do Windows a serem configuradas durante a criação de PCs na nuvem para essa política de provisionamento. Oferece suporte para `$select`. A propriedade windowsSettings foi preterida e deixará de retornar dados em 31 de janeiro de 2024. No futuro, use a propriedade windowsSetting .

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/beta/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",
  "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
  "imageId": "Image ID value",
  "imageDisplayName": "Image Display Name value",
  "imageType": "custom",
  "windowsSettings": {
    "language": "en-US"
  },
  "windowsSetting": {
    "locale": "en-US"
  },
  "microsoftManagedDesktop": {
    "managedType": "starterManaged",
    "profile": null
  },
  "autopatch": {
    "autopatchGroupId": "91197a0b-3a74-408d-ba88-bce3fdc4e5eb"
  },
  "autopilotConfiguration": {
    "devicePreparationProfileId": "59e5d3d2-ec68-4bfe-9693-27975b318990",
    "applicationTimeoutInMinutes": 30,
    "onFailureDeviceAccessDenied": false
  },
  "userSettingsPersistenceConfiguration": {
    "userSettingsPersistenceEnabled": false,
    "userSettingsPersistenceStorageSizeCategory": "fourGB"
  }
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new CloudPcProvisioningPolicy
{
	OdataType = "#microsoft.graph.cloudPcProvisioningPolicy",
	DisplayName = "HR provisioning policy",
	Description = "Provisioning policy for India HR employees",
	ImageId = "Image ID value",
	ImageDisplayName = "Image Display Name value",
	ImageType = CloudPcProvisioningPolicyImageType.Custom,
	WindowsSettings = new CloudPcWindowsSettings
	{
		Language = "en-US",
	},
	WindowsSetting = new CloudPcWindowsSetting
	{
		Locale = "en-US",
	},
	MicrosoftManagedDesktop = new MicrosoftManagedDesktop
	{
		ManagedType = MicrosoftManagedDesktopType.StarterManaged,
		Profile = null,
	},
	Autopatch = new CloudPcProvisioningPolicyAutopatch
	{
		AutopatchGroupId = "91197a0b-3a74-408d-ba88-bce3fdc4e5eb",
	},
	AutopilotConfiguration = new CloudPcAutopilotConfiguration
	{
		DevicePreparationProfileId = "59e5d3d2-ec68-4bfe-9693-27975b318990",
		ApplicationTimeoutInMinutes = 30,
		OnFailureDeviceAccessDenied = false,
	},
	UserSettingsPersistenceConfiguration = new CloudPcUserSettingsPersistenceConfiguration
	{
		UserSettingsPersistenceEnabled = false,
		UserSettingsPersistenceStorageSizeCategory = CloudPcUserSettingsPersistenceStorageSizeCategory.FourGB,
	},
	AdditionalData = new Dictionary<string, object>
	{
		{
			"onPremisesConnectionId" , "4e47d0f6-6f77-44f0-8893-c0fe1701ffff"
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.VirtualEndpoint.ProvisioningPolicies["{cloudPcProvisioningPolicy-id}"].PatchAsync(requestBody);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewCloudPcProvisioningPolicy()
displayName := "HR provisioning policy"
requestBody.SetDisplayName(&displayName) 
description := "Provisioning policy for India HR employees"
requestBody.SetDescription(&description) 
imageId := "Image ID value"
requestBody.SetImageId(&imageId) 
imageDisplayName := "Image Display Name value"
requestBody.SetImageDisplayName(&imageDisplayName) 
imageType := graphmodels.CUSTOM_CLOUDPCPROVISIONINGPOLICYIMAGETYPE 
requestBody.SetImageType(&imageType) 
windowsSettings := graphmodels.NewCloudPcWindowsSettings()
language := "en-US"
windowsSettings.SetLanguage(&language) 
requestBody.SetWindowsSettings(windowsSettings)
windowsSetting := graphmodels.NewCloudPcWindowsSetting()
locale := "en-US"
windowsSetting.SetLocale(&locale) 
requestBody.SetWindowsSetting(windowsSetting)
microsoftManagedDesktop := graphmodels.NewMicrosoftManagedDesktop()
managedType := graphmodels.STARTERMANAGED_MICROSOFTMANAGEDDESKTOPTYPE 
microsoftManagedDesktop.SetManagedType(&managedType) 
profile := null
microsoftManagedDesktop.SetProfile(&profile) 
requestBody.SetMicrosoftManagedDesktop(microsoftManagedDesktop)
autopatch := graphmodels.NewCloudPcProvisioningPolicyAutopatch()
autopatchGroupId := "91197a0b-3a74-408d-ba88-bce3fdc4e5eb"
autopatch.SetAutopatchGroupId(&autopatchGroupId) 
requestBody.SetAutopatch(autopatch)
autopilotConfiguration := graphmodels.NewCloudPcAutopilotConfiguration()
devicePreparationProfileId := "59e5d3d2-ec68-4bfe-9693-27975b318990"
autopilotConfiguration.SetDevicePreparationProfileId(&devicePreparationProfileId) 
applicationTimeoutInMinutes := int32(30)
autopilotConfiguration.SetApplicationTimeoutInMinutes(&applicationTimeoutInMinutes) 
onFailureDeviceAccessDenied := false
autopilotConfiguration.SetOnFailureDeviceAccessDenied(&onFailureDeviceAccessDenied) 
requestBody.SetAutopilotConfiguration(autopilotConfiguration)
userSettingsPersistenceConfiguration := graphmodels.NewCloudPcUserSettingsPersistenceConfiguration()
userSettingsPersistenceEnabled := false
userSettingsPersistenceConfiguration.SetUserSettingsPersistenceEnabled(&userSettingsPersistenceEnabled) 
userSettingsPersistenceStorageSizeCategory := graphmodels.FOURGB_CLOUDPCUSERSETTINGSPERSISTENCESTORAGESIZECATEGORY 
userSettingsPersistenceConfiguration.SetUserSettingsPersistenceStorageSizeCategory(&userSettingsPersistenceStorageSizeCategory) 
requestBody.SetUserSettingsPersistenceConfiguration(userSettingsPersistenceConfiguration)
additionalData := map[string]interface{}{
	"onPremisesConnectionId" : "4e47d0f6-6f77-44f0-8893-c0fe1701ffff", 
}
requestBody.SetAdditionalData(additionalData)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
provisioningPolicies, err := graphClient.DeviceManagement().VirtualEndpoint().ProvisioningPolicies().ByCloudPcProvisioningPolicyId("cloudPcProvisioningPolicy-id").Patch(context.Background(), requestBody, nil)

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

CloudPcProvisioningPolicy cloudPcProvisioningPolicy = new CloudPcProvisioningPolicy();
cloudPcProvisioningPolicy.setOdataType("#microsoft.graph.cloudPcProvisioningPolicy");
cloudPcProvisioningPolicy.setDisplayName("HR provisioning policy");
cloudPcProvisioningPolicy.setDescription("Provisioning policy for India HR employees");
cloudPcProvisioningPolicy.setImageId("Image ID value");
cloudPcProvisioningPolicy.setImageDisplayName("Image Display Name value");
cloudPcProvisioningPolicy.setImageType(CloudPcProvisioningPolicyImageType.Custom);
CloudPcWindowsSettings windowsSettings = new CloudPcWindowsSettings();
windowsSettings.setLanguage("en-US");
cloudPcProvisioningPolicy.setWindowsSettings(windowsSettings);
CloudPcWindowsSetting windowsSetting = new CloudPcWindowsSetting();
windowsSetting.setLocale("en-US");
cloudPcProvisioningPolicy.setWindowsSetting(windowsSetting);
MicrosoftManagedDesktop microsoftManagedDesktop = new MicrosoftManagedDesktop();
microsoftManagedDesktop.setManagedType(MicrosoftManagedDesktopType.StarterManaged);
microsoftManagedDesktop.setProfile(null);
cloudPcProvisioningPolicy.setMicrosoftManagedDesktop(microsoftManagedDesktop);
CloudPcProvisioningPolicyAutopatch autopatch = new CloudPcProvisioningPolicyAutopatch();
autopatch.setAutopatchGroupId("91197a0b-3a74-408d-ba88-bce3fdc4e5eb");
cloudPcProvisioningPolicy.setAutopatch(autopatch);
CloudPcAutopilotConfiguration autopilotConfiguration = new CloudPcAutopilotConfiguration();
autopilotConfiguration.setDevicePreparationProfileId("59e5d3d2-ec68-4bfe-9693-27975b318990");
autopilotConfiguration.setApplicationTimeoutInMinutes(30);
autopilotConfiguration.setOnFailureDeviceAccessDenied(false);
cloudPcProvisioningPolicy.setAutopilotConfiguration(autopilotConfiguration);
CloudPcUserSettingsPersistenceConfiguration userSettingsPersistenceConfiguration = new CloudPcUserSettingsPersistenceConfiguration();
userSettingsPersistenceConfiguration.setUserSettingsPersistenceEnabled(false);
userSettingsPersistenceConfiguration.setUserSettingsPersistenceStorageSizeCategory(CloudPcUserSettingsPersistenceStorageSizeCategory.FourGB);
cloudPcProvisioningPolicy.setUserSettingsPersistenceConfiguration(userSettingsPersistenceConfiguration);
HashMap<String, Object> additionalData = new HashMap<String, Object>();
additionalData.put("onPremisesConnectionId", "4e47d0f6-6f77-44f0-8893-c0fe1701ffff");
cloudPcProvisioningPolicy.setAdditionalData(additionalData);
CloudPcProvisioningPolicy result = graphClient.deviceManagement().virtualEndpoint().provisioningPolicies().byCloudPcProvisioningPolicyId("{cloudPcProvisioningPolicy-id}").patch(cloudPcProvisioningPolicy);

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const cloudPcProvisioningPolicy = {
  '@odata.type': '#microsoft.graph.cloudPcProvisioningPolicy',
  displayName: 'HR provisioning policy',
  description: 'Provisioning policy for India HR employees',
  onPremisesConnectionId: '4e47d0f6-6f77-44f0-8893-c0fe1701ffff',
  imageId: 'Image ID value',
  imageDisplayName: 'Image Display Name value',
  imageType: 'custom',
  windowsSettings: {
    language: 'en-US'
  },
  windowsSetting: {
    locale: 'en-US'
  },
  microsoftManagedDesktop: {
    managedType: 'starterManaged',
    profile: null
  },
  autopatch: {
    autopatchGroupId: '91197a0b-3a74-408d-ba88-bce3fdc4e5eb'
  },
  autopilotConfiguration: {
    devicePreparationProfileId: '59e5d3d2-ec68-4bfe-9693-27975b318990',
    applicationTimeoutInMinutes: 30,
    onFailureDeviceAccessDenied: false
  },
  userSettingsPersistenceConfiguration: {
    userSettingsPersistenceEnabled: false,
    userSettingsPersistenceStorageSizeCategory: 'fourGB'
  }
};

await client.api('/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff')
	.version('beta')
	.update(cloudPcProvisioningPolicy);

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\CloudPcProvisioningPolicy;
use Microsoft\Graph\Beta\Generated\Models\CloudPcProvisioningPolicyImageType;
use Microsoft\Graph\Beta\Generated\Models\CloudPcWindowsSettings;
use Microsoft\Graph\Beta\Generated\Models\CloudPcWindowsSetting;
use Microsoft\Graph\Beta\Generated\Models\MicrosoftManagedDesktop;
use Microsoft\Graph\Beta\Generated\Models\MicrosoftManagedDesktopType;
use Microsoft\Graph\Beta\Generated\Models\CloudPcProvisioningPolicyAutopatch;
use Microsoft\Graph\Beta\Generated\Models\CloudPcAutopilotConfiguration;
use Microsoft\Graph\Beta\Generated\Models\CloudPcUserSettingsPersistenceConfiguration;
use Microsoft\Graph\Beta\Generated\Models\CloudPcUserSettingsPersistenceStorageSizeCategory;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new CloudPcProvisioningPolicy();
$requestBody->setOdataType('#microsoft.graph.cloudPcProvisioningPolicy');
$requestBody->setDisplayName('HR provisioning policy');
$requestBody->setDescription('Provisioning policy for India HR employees');
$requestBody->setImageId('Image ID value');
$requestBody->setImageDisplayName('Image Display Name value');
$requestBody->setImageType(new CloudPcProvisioningPolicyImageType('custom'));
$windowsSettings = new CloudPcWindowsSettings();
$windowsSettings->setLanguage('en-US');
$requestBody->setWindowsSettings($windowsSettings);
$windowsSetting = new CloudPcWindowsSetting();
$windowsSetting->setLocale('en-US');
$requestBody->setWindowsSetting($windowsSetting);
$microsoftManagedDesktop = new MicrosoftManagedDesktop();
$microsoftManagedDesktop->setManagedType(new MicrosoftManagedDesktopType('starterManaged'));
$microsoftManagedDesktop->setProfile(null);
$requestBody->setMicrosoftManagedDesktop($microsoftManagedDesktop);
$autopatch = new CloudPcProvisioningPolicyAutopatch();
$autopatch->setAutopatchGroupId('91197a0b-3a74-408d-ba88-bce3fdc4e5eb');
$requestBody->setAutopatch($autopatch);
$autopilotConfiguration = new CloudPcAutopilotConfiguration();
$autopilotConfiguration->setDevicePreparationProfileId('59e5d3d2-ec68-4bfe-9693-27975b318990');
$autopilotConfiguration->setApplicationTimeoutInMinutes(30);
$autopilotConfiguration->setOnFailureDeviceAccessDenied(false);
$requestBody->setAutopilotConfiguration($autopilotConfiguration);
$userSettingsPersistenceConfiguration = new CloudPcUserSettingsPersistenceConfiguration();
$userSettingsPersistenceConfiguration->setUserSettingsPersistenceEnabled(false);
$userSettingsPersistenceConfiguration->setUserSettingsPersistenceStorageSizeCategory(new CloudPcUserSettingsPersistenceStorageSizeCategory('fourGB'));
$requestBody->setUserSettingsPersistenceConfiguration($userSettingsPersistenceConfiguration);
$additionalData = [
	'onPremisesConnectionId' => '4e47d0f6-6f77-44f0-8893-c0fe1701ffff',
];
$requestBody->setAdditionalData($additionalData);

$result = $graphServiceClient->deviceManagement()->virtualEndpoint()->provisioningPolicies()->byCloudPcProvisioningPolicyId('cloudPcProvisioningPolicy-id')->patch($requestBody)->wait();

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


Import-Module Microsoft.Graph.Beta.DeviceManagement.Administration

$params = @{
	"@odata.type" = "#microsoft.graph.cloudPcProvisioningPolicy"
	displayName = "HR provisioning policy"
	description = "Provisioning policy for India HR employees"
	onPremisesConnectionId = "4e47d0f6-6f77-44f0-8893-c0fe1701ffff"
	imageId = "Image ID value"
	imageDisplayName = "Image Display Name value"
	imageType = "custom"
	windowsSettings = @{
		language = "en-US"
	}
	windowsSetting = @{
		locale = "en-US"
	}
	microsoftManagedDesktop = @{
		managedType = "starterManaged"
		profile = $null
	}
	autopatch = @{
		autopatchGroupId = "91197a0b-3a74-408d-ba88-bce3fdc4e5eb"
	}
	autopilotConfiguration = @{
		devicePreparationProfileId = "59e5d3d2-ec68-4bfe-9693-27975b318990"
		applicationTimeoutInMinutes = 30
		onFailureDeviceAccessDenied = $false
	}
	userSettingsPersistenceConfiguration = @{
		userSettingsPersistenceEnabled = $false
		userSettingsPersistenceStorageSizeCategory = "fourGB"
	}
}

Update-MgBetaDeviceManagementVirtualEndpointProvisioningPolicy -CloudPcProvisioningPolicyId $cloudPcProvisioningPolicyId -BodyParameter $params

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.cloud_pc_provisioning_policy import CloudPcProvisioningPolicy
from msgraph_beta.generated.models.cloud_pc_provisioning_policy_image_type import CloudPcProvisioningPolicyImageType
from msgraph_beta.generated.models.cloud_pc_windows_settings import CloudPcWindowsSettings
from msgraph_beta.generated.models.cloud_pc_windows_setting import CloudPcWindowsSetting
from msgraph_beta.generated.models.microsoft_managed_desktop import MicrosoftManagedDesktop
from msgraph_beta.generated.models.microsoft_managed_desktop_type import MicrosoftManagedDesktopType
from msgraph_beta.generated.models.cloud_pc_provisioning_policy_autopatch import CloudPcProvisioningPolicyAutopatch
from msgraph_beta.generated.models.cloud_pc_autopilot_configuration import CloudPcAutopilotConfiguration
from msgraph_beta.generated.models.cloud_pc_user_settings_persistence_configuration import CloudPcUserSettingsPersistenceConfiguration
from msgraph_beta.generated.models.cloud_pc_user_settings_persistence_storage_size_category import CloudPcUserSettingsPersistenceStorageSizeCategory
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CloudPcProvisioningPolicy(
	odata_type = "#microsoft.graph.cloudPcProvisioningPolicy",
	display_name = "HR provisioning policy",
	description = "Provisioning policy for India HR employees",
	image_id = "Image ID value",
	image_display_name = "Image Display Name value",
	image_type = CloudPcProvisioningPolicyImageType.Custom,
	windows_settings = CloudPcWindowsSettings(
		language = "en-US",
	),
	windows_setting = CloudPcWindowsSetting(
		locale = "en-US",
	),
	microsoft_managed_desktop = MicrosoftManagedDesktop(
		managed_type = MicrosoftManagedDesktopType.StarterManaged,
		profile = None,
	),
	autopatch = CloudPcProvisioningPolicyAutopatch(
		autopatch_group_id = "91197a0b-3a74-408d-ba88-bce3fdc4e5eb",
	),
	autopilot_configuration = CloudPcAutopilotConfiguration(
		device_preparation_profile_id = "59e5d3d2-ec68-4bfe-9693-27975b318990",
		application_timeout_in_minutes = 30,
		on_failure_device_access_denied = False,
	),
	user_settings_persistence_configuration = CloudPcUserSettingsPersistenceConfiguration(
		user_settings_persistence_enabled = False,
		user_settings_persistence_storage_size_category = CloudPcUserSettingsPersistenceStorageSizeCategory.FourGB,
	),
	additional_data = {
			"on_premises_connection_id" : "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
	}
)

result = await graph_client.device_management.virtual_endpoint.provisioning_policies.by_cloud_pc_provisioning_policy_id('cloudPcProvisioningPolicy-id').patch(request_body)

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Comentários

Esta página foi útil?

Última atualização em 2026-08-18

Atualizar cloudPcProvisioningPolicy

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplos

Solicitação

Resposta

Comentários

Recursos adicionais