Compartilhar via


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.

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 As definições específicas do Windows Autopatch que permitem aos clientes experimentá-lo no Cloud PC. As definições têm efeito quando o inquilino é inscrito no Windows Autopatch e o managedType da propriedade microsoftManagedDesktop é definido como starterManaged.
AutopilotConfiguration cloudPcAutopilotConfiguration As definições específicas do Windows Autopilot que permitem aos clientes Windows 365 experimentá-lo no Cloud PC.
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, 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.
imageType cloudPcProvisioningPolicyImageType O tipo de imagem do SO (personalizada ou galeria) que pretende aprovisionar em PCs cloud. Os valores possíveis são: gallery e custom.
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.
windowsSetting cloudPcWindowsSettings 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.
domainJoinConfiguration (preterido) cloudPcDomainJoinConfiguration Especifica a forma como os PCs cloud se associam Microsoft Entra ID. A propriedade domainJoinConfiguration foi preterida e deixará de devolver dados a 31 de maio de 2024. No futuro, utilize a propriedade domainJoinConfigurations .
onPremisesConnectionId (preterido) Cadeia de caracteres O ID da cloudPcOnPremisesConnection. Para garantir que os PCs na Cloud têm conectividade de rede e associação a um domínio, escolha uma ligação com uma rede virtual validada pelo serviço cloud PC. A propriedade onPremisesConnectionId foi preterida e deixará de devolver dados a 31 de maio de 2024. No futuro, utilize a propriedade domainJoinConfigurations .
windowsSettings (preterido) cloudPcWindowsSettings Definições específicas do Windows a configurar durante a criação de PCs na Cloud para esta política de aprovisionamento. Oferece suporte para $select. A propriedade windowsSettings foi preterida e deixará de devolver dados a 31 de janeiro de 2024. No futuro, utilize 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
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content