Compartilhar via


Atualizar cloudPcProvisioningPolicy

Namespace: microsoft.graph

Atualize as propriedades de um objeto cloudPcProvisioningPolicy .

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

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

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

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
cloudPcNamingTemplate Cadeia de caracteres 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.
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 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:
  • publisher: 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-m365e 19h2-ent-cpc-os.
Imagetype cloudPcProvisioningPolicyImageType 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.
microsoftManagedDesktop microsoftManagedDesktop 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.
windowsSetting cloudPcWindowsSetting 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 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"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content