Partilhar via


Create 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.

Create um novo 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

POST /deviceManagement/virtualEndpoint/provisioningPolicies

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 lista as propriedades necessárias ao criar o cloudPcProvisioningPolicy.

Propriedade Tipo Descrição
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.
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-ose 19h2-ent-cpc-os19h2-ent-cpc-m365 .
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 e custom.
provisioningType cloudPcProvisioningType 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, sharedByUser, sharedByEntraGroup. Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores deste enumerável em evolução: sharedByUser, sharedByEntraGroup. O shared membro está preterido e deixará de retornar em 30 de abril de 2027; daqui para frente, use o sharedByUser membro.
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 os PCs de nuvem se juntam Microsoft Entra ID. A propriedade domainJoinConfiguration foi preterida e deixará de retornar dados em 31 de maio de 2024. Daqui para frente, use a propriedade domainJoinConfigurations .
onPremisesConnectionId (preterido) Cadeia de caracteres A ID da cloudPcOnPremisesConnection. Para garantir que os PCs de nuvem tenham conectividade de rede e que ingressem no domínio, escolha uma conexão com uma rede virtual que o serviço de CLOUD PC a validou. A propriedade onPremisesConnectionId foi preterida e deixará de retornar dados em 31 de maio de 2024. Daqui para frente, use a propriedade domainJoinConfigurations .
windowsSettings (preterido) cloudPcWindowsSettings Configurações específicas do Windows a serem configuradas durante a criação de PCs de Nuvem para essa política de provisionamento. Oferece suporte para $select. A propriedade windowsSettings está preterida e deixará de retornar dados em 31 de janeiro de 2024. Daqui para frente, use a propriedade windowsSetting .

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto cloudPcProvisioningPolicy no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
    "description": "Description value",
    "displayName": "Display Name value",
    "domainJoinConfiguration": {
        "domainJoinType": "hybridAzureADJoin",
        "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff"
    },
    "domainJoinConfigurations": [
      {
        "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff",
        "type": "hybridAzureADJoin"
      },
      {
        "onPremisesConnectionId": "26e16c71-f210-438b-88ac-d481ccafffff",
        "type": "hybridAzureADJoin"
      }
    ],
    "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
    "enableSingleSignOn": true,
    "imageDisplayName": "Windows-10 19h1-evd",
    "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
    "imageType":"gallery",
    "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
    "windowsSettings": {
        "language": "en-US"
    },
    "windowsSetting": {
        "locale": "en-US"
    },
    "provisioningType": "dedicated"
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "description": "Description value",
  "displayName": "Display Name value",
  "domainJoinConfiguration": {
      "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
      "type": "hybridAzureADJoin"
  },
  "domainJoinConfigurations": [
    {
      "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff",
      "type": "hybridAzureADJoin"
    },
    {
      "onPremisesConnectionId": "26e16c71-f210-438b-88ac-d481ccafffff",
      "type": "hybridAzureADJoin"
    }
  ],
  "microsoftManagedDesktop": {
      "managedType": "notManaged",
      "profile": null
  },
  "autopatch": {
      "autopatchGroupId": null
  },
  "autopilotConfiguration": null,
  "enableSingleSignOn": true,
  "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
  "imageDisplayName": "Windows-10 19h1-evd",
  "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
  "imageType":"gallery",
  "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
  "windowsSettings": {
    "language": "en-US"
  },
  "windowsSetting": {
      "locale": "en-US"
  },
  "managedBy": "windows365",
  "provisioningType": "dedicated"
}