Compartilhar via


Atualizar cloudPcProvisioningPolicy

Namespace: microsoft.graph

Atualize as propriedades de um objeto cloudPcProvisioningPolicy .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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 do pedido, forneça uma representação JSON do objeto cloudPcProvisioningPolicy .

A tabela seguinte mostra as propriedades que podem ser atualizadas para cloudPcProvisioningPolicy.

Propriedade Tipo Descrição
bloqueio automático cloudPcProvisioningPolicyAutopatch Indica as definições de Bloqueio Automático do Windows para PCs na Cloud com esta política de aprovisionamento. As definições produzem efeito quando o inquilino é inscrito no Autopatch e o managedType da propriedade microsoftManagedDesktop é definido como starterManaged.
cloudPcNamingTemplate Cadeia de caracteres O modelo utilizado para atribuir o nome PCs cloud aprovisionados com esta política. O modelo pode conter tokens de substituição e texto personalizados, incluindo %USERNAME:x% e %RAND:x%, que representam o nome do utilizador e um número gerado aleatoriamente, respetivamente. Por exemplo, CPC-%USERNAME:4%-%RAND:5% significa que o nome do CLOUD PC começa com CPC-, seguido de um nome de utilizador de quatro carateres, um - caráter e, em seguida, cinco carateres aleatórios. O comprimento total do texto gerado pelo modelo não pode exceder os 15 carateres. Oferece suporte para $filter, $select e $orderby.
description Cadeia de caracteres A descrição da política de aprovisionamento.
displayName Cadeia de caracteres O nome a apresentar da política de aprovisionamento.
domainJoinConfigurations cloudPcDomainJoinConfiguration collection Especifica uma lista ordenada por prioridade sobre a forma como os PCs na Cloud se associam Microsoft Entra ID.
enableSingleSignOn Booliano True se o CLOUD PC aprovisionado puder ser acedido através do início de sessão único. False indica que o CLOUD PC aprovisionado não suporta esta funcionalidade. O valor padrão é false. Windows 365 utilizadores podem utilizar o início de sessão único para se autenticarem no Microsoft Entra ID com opções sem palavra-passe (por exemplo, chaves FIDO) para aceder ao respetivo PC na Cloud. Opcional.
imageDisplayName Cadeia de caracteres O nome a apresentar da imagem do SO que está a aprovisionar.
imageId Cadeia de caracteres O ID da imagem do SO que pretende aprovisionar em PCs na Cloud. O formato de uma imagem de tipo de galeria é: {publisher_offer_sku}. Os valores suportados para cada um dos parâmetros são os seguintes:
  • publisher: Microsoftwindowsdesktop.
  • oferta: windows-ent-cpc.
  • sku: 21h1-ent-cpc-m365, , 20h2-ent-cpc-m36521h1-ent-cpc-os, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, e 19h2-ent-cpc-m36519h2-ent-cpc-os.
imageType cloudPcProvisioningPolicyImageType O tipo de imagem do SO (personalizada ou galeria) que pretende aprovisionar em PCs cloud. Os valores possíveis são: gallery, custom, unknownFutureValue.
microsoftManagedDesktop microsoftManagedDesktop As definições específicas do microsoftManagedDesktop que permitem que os clientes do Microsoft Managed Desktop obtenham experiência gerida pelo dispositivo para o CLOUD PC. Para permitir que o microsoftManagedDesktop forneça mais valor, um administrador tem de especificar determinadas definições no mesmo. Oferece suporte para $filter, $select e $orderBy.
windowsSetting cloudPcWindowsSetting Indica uma definição específica do Windows para configurar durante a criação de PCs na Cloud para esta política de aprovisionamento. Oferece suporte para $select.

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/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"
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content