tipo de recurso cloudPcProvisioningPolicy

Artigo
04/02/2024

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.

Representa uma política de provisionamento do Cloud PC.

Métodos

Método	Tipo de retorno	Descrição
Provisionamento de listaPolíticas	coleção cloudPcProvisioningPolicy	Listar propriedades e relações dos objetos cloudPcProvisioningPolicy .
Obter cloudPcProvisioningPolicy	cloudPcProvisioningPolicy	Leia as propriedades e as relações de um objeto cloudPcProvisioningPolicy .
Criar cloudPcProvisioningPolicy	cloudPcProvisioningPolicy	Crie um novo objeto cloudPcProvisioningPolicy .
Atualizar cloudPcProvisioningPolicy	cloudPcProvisioningPolicy	Atualize as propriedades de um objeto cloudPcProvisioningPolicy .
Excluir cloudPcProvisioningPolicy	Nenhum	Exclua um objeto cloudPcProvisioningPolicy .
Atribuir cloudPcProvisioningPolicy	Nenhum	Atribua um cloudPcProvisioningPolicy a grupos de usuários.
Aplicar cloudPcProvisioningPolicy	Nenhum	Aplique a configuração atual da política de provisionamento a todos os dispositivos cloud pc em uma política especificada. Atualmente, você só pode alterar a região.
applyConfig	Nenhum	Atualize a configuração da política de provisionamento para um conjunto de dispositivos cloud pc por suas IDs.

Propriedades

Propriedade	Tipo	Descrição
alternateResourceUrl	Cadeia de caracteres	A URL do recurso alternativo que se vincula a essa política de provisionamento. Somente leitura.
cloudPcGroupDisplayName	Cadeia de caracteres	O nome de exibição do grupo de PC na nuvem no qual os PCs de Nuvem residem. Somente leitura.
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. Oferece suporte para `$filter`, `$select` e `$orderBy`.
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 (Azure AD). Oferece suporte para `$select`.
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.
gracePeriodInHours	Int32	O número de horas de espera antes que o reprovisionamento/desprovisionamento aconteça. Somente leitura.
id	Cadeia de caracteres	O identificador exclusivo associado à política de provisionamento. Essa ID é preenchida automaticamente durante a criação de uma nova política de provisionamento. Somente leitura. Oferece suporte para `$filter`, `$select` e `$orderBy`.
imageDisplayName	Cadeia de caracteres	O nome de exibição da imagem do sistema operacional usada para provisionamento. Por exemplo, `Windows 11 Preview + Microsoft 365 Apps 23H2 23H2`. Oferece suporte para `$filter`, `$select` e `$orderBy`.
imageId	Cadeia de caracteres	O identificador exclusivo que representa uma imagem do sistema operacional que é usada para provisionar novos PCs na nuvem. O formato de uma imagem de tipo de galeria é: {publisherName_offerName_skuName}. Os valores com suporte para cada um dos parâmetros são: Editor: `Microsoftwindowsdesktop` Oferecer: `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` Oferece suporte para `$filter`, `$select` e `$orderBy`.
Imagetype	cloudPcProvisioningPolicyImageType	O tipo de imagem do sistema operacional (personalizada ou galeria) usada para provisionamento em PCs de nuvem. Os valores possíveis são: `gallery` e `custom`. O valor padrão é `gallery`. Dá suporte a $filter, $select e $orderBy.
localAdminEnabled	Booliano	Quando `true`, o administrador local está habilitado para PCs de Nuvem; `false` indica que o administrador local não está habilitado para PCs de Nuvem. O valor padrão é `false`. Oferece suporte para `$filter`, `$select` e `$orderBy`.
Managedby	cloudPcManagementService	Indica o serviço que gerencia a política de provisionamento. Os valores possíveis são: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`. O valor padrão é `windows365`. Observe que você deve usar o cabeçalho de `Prefer: include-unknown-enum-members` solicitação para obter o seguinte valor nessa enumeração evolutiva: `rpaBox`. Oferece suporte para `$filter`, `$select` e `$orderBy`.
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`.
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`.
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 validada pelo serviço de PC na nuvem. 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 .

valores cloudPcProvisioningType

Member	Descrição
Dedicado	Indica que uma licença dedicada é usada para provisionar PCs na nuvem. Valor padrão.
compartilhado	Indica que uma licença compartilhada é usada para provisionar PCs na nuvem.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.

Relações

Relação	Tipo	Descrição
assignments	coleção cloudPcProvisioningPolicyAssignment	Uma coleção definida de atribuições de política de provisionamento. Representa o conjunto de grupos e grupos de segurança do Microsoft 365 em Microsoft Entra ID que têm a política de provisionamento atribuída. Retornado apenas em `$expand`. Para obter um exemplo sobre como obter a relação de atribuições, consulte Obter cloudPcProvisioningPolicy.

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "alternateResourceUrl": "String",
  "cloudPcGroupDisplayName": "String",
  "cloudPcNamingTemplate": "String",
  "description": "String",
  "displayName": "String",
  "domainJoinConfiguration": {
    "@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"
  },
  "domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
  "enableSingleSignOn": "Boolean",
  "gracePeriodInHours": "Int32",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "imageId": "String",
  "imageType": "String",
  "localAdminEnabled": "Boolean",
  "managedBy": "String",
  "microsoftManagedDesktop": {
    "@odata.type": "microsoft.graph.microsoftManagedDesktop"
  },
  "onPremisesConnectionId": "String",
  "provisioningType": "String",
  "windowsSetting": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSetting"
  },
  "windowsSettings": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSettings"
  }
}