Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 de PC na nuvem.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | Coleção cloudPcProvisioningPolicy | Listar propriedades e relações dos objetos cloudPcProvisioningPolicy . |
| Get | cloudPcProvisioningPolicy | Leia as propriedades e relações de um objeto cloudPcProvisioningPolicy . |
| Create | cloudPcProvisioningPolicy | Crie um novo objeto cloudPcProvisioningPolicy . |
| Atualizar | cloudPcProvisioningPolicy | Atualizar as propriedades de um objeto cloudPcProvisioningPolicy . |
| Delete | Nenhum | Exclua um objeto cloudPcProvisioningPolicy . |
| Assign | Nenhum | Atribua um cloudPcProvisioningPolicy a grupos de usuários. |
| Apply | Nenhum | Aplique a configuração de política de provisionamento atual a todos os dispositivos do PC na nuvem sob uma política especificada. |
| Aplicar configuração | Nenhum | Atualize a configuração da política de provisionamento para um conjunto de dispositivos PC na nuvem por suas IDs. |
| repetir | Nenhum | Repita a operação de provisionamento para PCs na nuvem que usaram a política compartilhada de linha de frente atual e não aplicaram a política de provisionamento. |
| Agendar tarefa de aplicação de política | Nenhum | Agendar uma tarefa de aplicação de política para uma política de provisionamento. |
| Recuperar resultado da ação de aplicação de política | cloudPcPolicyApplyActionResult | Recuperar o resultado de uma política Aplicar ação para uma política de provisionamento. |
| Recuperar agendamento de aplicação de política | cloudPcPolicyScheduledApplyActionDetail | Recuperar o agendamento de uma política Aplicar ação para uma política de provisionamento. |
| Recuperar resultado do status de atualização de política | cloudPcPolicyPendingApplyStatusResult | Recupere o status de aplicação pendente de uma política de provisionamento para determinar se existem alterações não aplicadas para computadores na nuvem. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| alternateResourceUrl | Cadeia de caracteres | A URL do recurso alternativo vinculado a essa política de provisionamento. Somente leitura. |
| correção automática | cloudPcProvisioningPolicyAutopatch | Indica as configurações do Windows Autopatch para PCs na nuvem usando essa política de provisionamento. As configurações entram em vigor quando o locatário se registra no Autopatch e o managedType da propriedade microsoftManagedDesktop é definido como starterManaged. Ao criar ou atualizar uma política de provisionamento com o Autopatch, você deve usar um token delegado e o usuário conectado deve ter a função de Administrador do Intune. Oferece suporte para $select. |
| autopilotConfiguration | cloudPcAutopilotConfiguration | As configurações específicas do Windows Autopilot que permitem que os clientes do Windows 365 o experimentem no Cloud PC. Ao criar ou atualizar uma política de provisionamento com autopilotConfiguration, use as permissões necessárias do Microsoft Graph listadas nas páginas de API de criação e atualização correspondentes. Em cenários delegados, o usuário conectado também deve ter a permissão RBAC do Microsoft.Intune/DeviceConfigurations/Assign Intune. Oferece suporte para $select. |
| cloudPcGroupDisplayName | Cadeia de caracteres | O nome de exibição do grupo de PCs na nuvem no qual os PCs na nuvem residem. Somente leitura. |
| cloudPcNamingTemplate | Cadeia de caracteres | O modelo usado para nomear PCs na nuvem provisionados usando essa política. O modelo pode conter texto personalizado e tokens de substituição, 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 na nuvem 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. |
| createdBy | Cadeia de caracteres | A ID exclusiva do usuário que criou essa política. Por exemplo, 5ccb8d35-dd04-473e-a287-69bb4473208b. Somente leitura. Oferece suporte para $select. |
| createdDateTime | DateTimeOffset | O carimbo de data/hora em que esta política de provisionamento foi criada. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura. Oferece suporte para $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 na nuvem ingressam no Microsoft Entra ID (Azure AD). Oferece suporte para $select. |
| enableSingleSignOn | Booliano |
True se o logon único puder acessar o PC na nuvem provisionado.
False indica que o PC na nuvem provisionado não dá suporte a esse recurso. O valor padrão é false. Os usuários do Windows 365 podem usar o logon único para se autenticar no Microsoft Entra ID com opções sem senha (por exemplo, chaves FIDO) para acessar seu PC 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 usada para provisionar novos computadores 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:
$filter, $select e $orderBy. |
| Tipo de imagem | cloudPcProvisioningPolicyImageType | O tipo de imagem do sistema operacional (personalizado ou galeria) usada para provisionamento em PCs na nuvem. Os valores possíveis são: gallery, custom. O valor padrão é gallery. Suporta $filter, $select e $orderBy. |
| lastModifiedBy | Cadeia de caracteres | A ID exclusiva do usuário que atualizou esta política pela última vez. Por exemplo, 5ccb8d35-dd04-473e-a287-69bb4473208b. Somente leitura. Oferece suporte para $select. |
| lastModifiedDateTime | DateTimeOffset | O carimbo de data/hora em que essa política de provisionamento foi modificada pela última vez. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura. Oferece suporte para $select e $orderBy. |
| localAdminEnabled | Booliano | Quando true, o administrador local está habilitado para PCs na nuvem; false indica que o administrador local não está habilitado para PCs na 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, microsoft365Opal, microsoft365BizChat. O valor padrão é windows365. Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes membros nesta enumeração evolutiva: rpaBox. Oferece suporte para $filter, $select e $orderBy. |
| MicrosoftManagedDesktop | MicrosoftManagedDesktop | As configurações específicas para microsoftManagedDesktop que permite que os clientes da Área de Trabalho Gerenciada da Microsoft obtenham uma experiência gerenciada de dispositivo para o Cloud PC. Para permitir que 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ças a serem usadas ao provisionar PCs na nuvem usando essa política. Os valores possíveis são dedicated, shared, unknownFutureValue, sharedByUser, sharedByEntraGroup, reserve. Use o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: sharedByUser, sharedByEntraGroup, reserve. O shared membro foi preterido e deixará de retornar em 30 de abril de 2027. No futuro, use o sharedByUser membro. Por exemplo, um dedicated plano de serviço pode ser atribuído a apenas um usuário e provisionar apenas um PC na nuvem. Os shared planos and sharedByUser exigem que os clientes adquiram um plano de serviço compartilhado. Cada licença compartilhada adquirida pode habilitar até três PCs na nuvem, com apenas um usuário conectado por vez. O sharedByEntraGroup plano também requer a compra de um plano de serviço compartilhado. Cada licença compartilhada nesse plano pode habilitar um PC na nuvem, que é compartilhado para o grupo de acordo com as atribuições dessa política. Por padrão, o tipo de licença é dedicated se o provisioningType não for especificado quando você criar o cloudPcProvisioningPolicy. Você não poderá alterar essa propriedade após a criação do cloudPcProvisioningPolicy . |
| scopeIds | String collection | A lista de IDs de marca de escopo para este recurso. Somente leitura. |
| snapshotResetMode | cloudPcSnapshotResetMode | Indica se snapshot redefinição está disponível para essa política de provisionamento. Os valores possíveis são: notApplicable, enabled, disabled, unknownFutureValue. O valor padrão é notApplicable. |
| userExperienceType | cloudPcUserExperienceType | Especifica o tipo de objeto de nuvem que o usuário final pode acessar. Os valores possíveis são: cloudPc, cloudApp, unknownFutureValue.
cloudPc indica que o usuário final pode acessar toda a área de trabalho.
cloudApp Indica que o usuário final só pode acessar aplicativos publicados sob essa política de provisionamento. O tipo não pode ser alterado depois que a política de provisionamento é criada. Se não for especificado durante a criação, o valor padrão será cloudPc. Quando cloudApp é selecionado, o provisioningType deve ser sharedByEntraGroup. Suporta $filter, $select, $orderBy. |
| userSettingsPersistenceConfiguration | cloudPcUserSettingsPersistenceConfiguration | Indica configurações específicas que permitem a persistência de configurações de aplicativo de usuário entre sessões do Cloud PC. O valor padrão é null. Esse recurso só está disponível para políticas de provisionamento de PC na nuvem do tipo sharedByEntraGroup. Oferece suporte para $select. |
| 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 PCs na nuvem ingressam no Microsoft Entra ID. A propriedade domainJoinConfiguration foi preterida e deixará de retornar dados em 31 de maio de 2024. No futuro, use a propriedade domainJoinConfigurations . |
| onPremisesConnectionId (preterido) | Cadeia de caracteres | A ID do cloudPcOnPremisesConnection. Para garantir que os PCs na nuvem tenham conectividade de rede e que ingressem no domínio, escolha uma conexão com uma rede virtual que o serviço do PC na nuvem tenha validado. A propriedade onPremisesConnectionId foi preterida e deixará de retornar dados em 31 de maio de 2024. No futuro, use a propriedade domainJoinConfigurations . |
| windowsSettings (preterido) | cloudPcWindowsSettings | Configurações específicas do Windows a serem configuradas durante a criação de PCs na nuvem para essa política de provisionamento. Oferece suporte para $select. A propriedade windowsSettings foi preterida e deixará de retornar dados em 31 de janeiro de 2024. No futuro, use a propriedade windowsSetting . |
valores de cloudPcProvisioningType
A tabela a seguir lista os membros de uma enumeração evolutiva. Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes valores nesta enumeração evolutiva: sharedByUser, sharedByEntraGroup, reserve.
| Member | Descrição |
|---|---|
| dedicado | Indica que uma licença dedicada é usada para provisionar PCs na Nuvem. Valor padrão. |
| Compartilhado (preterido) | Indica que uma licença compartilhada é usada para provisionar PCs na Nuvem. O shared membro foi preterido e deixará de retornar em 30 de abril de 2027. De agora em diante, use o sharedByUser membro. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
| sharedByUser | Indica a política de provisionamento quando um PC na nuvem dedicado é provisionado para cada usuário no grupo de atribuição. Os usuários estão sempre conectados ao mesmo PC na nuvem. No entanto, a disponibilidade do PC na nuvem é limitada pelo número total de sessões ativas. |
| sharedByEntraGroup | Indica a política de provisionamento associada a PCs na nuvem compartilhados por um grupo do Microsoft Entra (Azure AD). Quando um PC na nuvem compartilhado é provisionado, ele fica disponível para qualquer usuário no grupo de atribuições do Microsoft Entra ID se conectar. Os usuários podem estar conectados a um PC na nuvem diferente em cada conexão e a disponibilidade é limitada pelo número de PCs na nuvem provisionados. |
| Reservar agora | Indica que a política deve usar licenças dedicadas, por usuário e com limite de tempo quando os PCs na nuvem são provisionados. Esses PCs na nuvem que usam a política de reserva podem ser verificados e verificados pelo usuário várias vezes, e a licença com limite de tempo é consumida somente depois que o PC na nuvem é verificado. Atualmente, cada usuário pode obter 10 horas de tempo de uso de cada instância do plano de serviço de reserva. |
valores de cloudPcSnapshotResetMode
| Member | Descrição |
|---|---|
| notApplicable | Indica que snapshot redefinição não é aplicável à política de provisionamento. |
| habilitadas | Indica que snapshot redefinição está habilitada para a política de provisionamento. |
| desabilitadas | Indica que snapshot redefinição está desabilitada para a política de provisionamento. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
valores de cloudPcUserExperienceType
| Member | Descrição |
|---|---|
| cloudPc | Indica que os usuários finais podem acessar toda a área de trabalho. |
| cloudApp | Indica que os usuários finais só podem acessar Aplicativos de Nuvem publicados sob essa política de provisionamento. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. 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 no Microsoft Entra ID que têm política de provisionamento atribuída. Retornado apenas em $expand. Para obter um exemplo sobre como obter a relação de atribuições, consulte Get cloudPcProvisioningPolicy. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
"alternateResourceUrl": "String",
"autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
"autopilotConfiguration": {"@odata.type": "microsoft.graph.cloudPcAutopilotConfiguration"},
"cloudPcGroupDisplayName": "String",
"cloudPcNamingTemplate": "String",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"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",
"lastModifiedBy": "String",
"lastModifiedDateTime": "String (timestamp)",
"localAdminEnabled": "Boolean",
"managedBy": "String",
"microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
"onPremisesConnectionId": "String",
"provisioningType": "String",
"scopeIds": ["String"],
"snapshotResetMode": "String",
"userExperienceType": "String",
"userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
"windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
"windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}