Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas
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
POST /deviceManagement/virtualEndpoint/provisioningPolicies
O modelo usado para nomear PCs de nuvem provisionados usando essa política. O modelo pode conter tokens de texto e substituição personalizados, incluindo %USERNAME:x% e %RAND:x%, que representam o nome do usuário e um número gerado aleatoriamente, respectivamente. Por exemplo, CPC-%USERNAME:4%-%RAND:5% significa que o nome do PC cloud começa com CPC-, seguido por um nome de usuário de quatro caracteres, um - caractere e, em seguida, cinco caracteres aleatórios. O comprimento total do texto gerado pelo modelo não pode exceder 15 caracteres. Oferece suporte para $filter, $select e $orderby.
description
Cadeia de caracteres
A descrição da política de provisionamento. Oferece suporte para $filter, $select e $orderBy.
displayName
Cadeia de caracteres
O nome de exibição da política de provisionamento.
Especifica uma lista ordenada por prioridade sobre como os PCs de nuvem se juntam Microsoft Entra ID.
enableSingleSignOn
Booliano
True se o PC de Nuvem provisionado puder ser acessado pelo logon único. False indica que o PC de Nuvem provisionado não dá suporte a esse recurso. O valor padrão é false. Windows 365 usuários podem usar o logon único para autenticar para Microsoft Entra ID com opções sem senha (por exemplo, chaves FIDO) para acessar seu COMPUTADOR 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 de 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:
O tipo de imagem do sistema operacional (personalizada ou galeria) que você deseja provisionar em PCs de nuvem. Os valores possíveis são: gallery, custom, unknownFutureValue.
As configurações específicas para microsoftManagedDesktop que permitem que os clientes da Área de Trabalho Gerenciada da Microsoft obtenham experiência gerenciada por dispositivos para Cloud PC. Para permitir que o microsoftManagedDesktop forneça mais valor, um administrador precisa especificar determinadas configurações nele. Oferece suporte para $filter, $select e $orderBy.
Especifica o tipo de licença usada ao provisionar computadores na nuvem usando essa política. Por padrão, o tipo de licença será dedicated se o provisionamentoType não for especificado quando você criar o cloudPcProvisioningPolicy. Você não pode alterar essa propriedade depois que o cloudPcProvisioningPolicy foi criado. Os valores possíveis são: dedicated, shared, unknownFutureValue.
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.
Resposta
Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto cloudPcProvisioningPolicy no corpo da resposta.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new CloudPcProvisioningPolicy
{
OdataType = "#microsoft.graph.cloudPcProvisioningPolicy",
Description = "Description value",
DisplayName = "Display Name value",
DomainJoinConfigurations = new List<CloudPcDomainJoinConfiguration>
{
new CloudPcDomainJoinConfiguration
{
OnPremisesConnectionId = "16ee6c71-fc10-438b-88ac-daa1ccafffff",
DomainJoinType = CloudPcDomainJoinType.HybridAzureADJoin,
},
new CloudPcDomainJoinConfiguration
{
OnPremisesConnectionId = "26e16c71-f210-438b-88ac-d481ccafffff",
DomainJoinType = CloudPcDomainJoinType.HybridAzureADJoin,
},
},
Id = "1d164206-bf41-4fd2-8424-a3192d39ffff",
EnableSingleSignOn = true,
ImageDisplayName = "Windows-10 19h1-evd",
ImageId = "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
ImageType = CloudPcProvisioningPolicyImageType.Gallery,
WindowsSetting = new CloudPcWindowsSetting
{
Locale = "en-US",
},
ProvisioningType = CloudPcProvisioningType.Dedicated,
};
// 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.PostAsync(requestBody);
// 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.setDescription("Description value");
cloudPcProvisioningPolicy.setDisplayName("Display Name value");
LinkedList<CloudPcDomainJoinConfiguration> domainJoinConfigurations = new LinkedList<CloudPcDomainJoinConfiguration>();
CloudPcDomainJoinConfiguration cloudPcDomainJoinConfiguration = new CloudPcDomainJoinConfiguration();
cloudPcDomainJoinConfiguration.setOnPremisesConnectionId("16ee6c71-fc10-438b-88ac-daa1ccafffff");
cloudPcDomainJoinConfiguration.setDomainJoinType(CloudPcDomainJoinType.HybridAzureADJoin);
domainJoinConfigurations.add(cloudPcDomainJoinConfiguration);
CloudPcDomainJoinConfiguration cloudPcDomainJoinConfiguration1 = new CloudPcDomainJoinConfiguration();
cloudPcDomainJoinConfiguration1.setOnPremisesConnectionId("26e16c71-f210-438b-88ac-d481ccafffff");
cloudPcDomainJoinConfiguration1.setDomainJoinType(CloudPcDomainJoinType.HybridAzureADJoin);
domainJoinConfigurations.add(cloudPcDomainJoinConfiguration1);
cloudPcProvisioningPolicy.setDomainJoinConfigurations(domainJoinConfigurations);
cloudPcProvisioningPolicy.setId("1d164206-bf41-4fd2-8424-a3192d39ffff");
cloudPcProvisioningPolicy.setEnableSingleSignOn(true);
cloudPcProvisioningPolicy.setImageDisplayName("Windows-10 19h1-evd");
cloudPcProvisioningPolicy.setImageId("MicrosoftWindowsDesktop_Windows-10_19h1-evd");
cloudPcProvisioningPolicy.setImageType(CloudPcProvisioningPolicyImageType.Gallery);
CloudPcWindowsSetting windowsSetting = new CloudPcWindowsSetting();
windowsSetting.setLocale("en-US");
cloudPcProvisioningPolicy.setWindowsSetting(windowsSetting);
cloudPcProvisioningPolicy.setProvisioningType(CloudPcProvisioningType.Dedicated);
CloudPcProvisioningPolicy result = graphClient.deviceManagement().virtualEndpoint().provisioningPolicies().post(cloudPcProvisioningPolicy);
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.