tipo de recurso cloudPC

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 área de trabalho virtual gerenciada por nuvem. Esse PC na Nuvem também está registrado em Intune e gerenciado por meio do portal do Microsoft Endpoint Manager, portanto, o PC de Nuvem também tem uma ID de dispositivo gerenciada Intune correspondente.

Métodos

Método	Tipo de retorno	Descrição
Listar cloudPCs	coleção cloudPC	Listar propriedades e relações dos objetos de PC na nuvem.
Obter cloudPC	cloudPC	Leia as propriedades e as relações de um objeto cloud pc.
Obter PCs de nuvem provisionados	coleção cloudPC	Obtenha todos os PCs de Nuvem provisionados de um plano de serviço específico para usuários em um grupo de usuários Microsoft Entra.
Alterar o tipo de conta de usuário	Nenhum	Altere o tipo de conta do usuário em um pc de nuvem específico.
Fim do período de carência	Nenhum	Termine o período de carência de um objeto cloud pc.
Obter resultados de ação remota	cloudPcRemoteActionResult	Verifique os resultados da ação remota especificada pelo PC na nuvem para um dispositivo cloud pc.
Ligar	Nenhum	Power em um objeto específico do Windows Frontline Cloud PC. Essa ação dá suporte a cenários de administrador do MEM.
Desligar	Nenhum	Desligue um objeto específico do Windows Frontline Cloud PC. Essa ação dá suporte a cenários de administrador do MEM.
Reiniciar	Nenhum	Reinicialize um objeto cloud pc específico.
Rename	Nenhum	Renomeie um objeto cloud pc específico. Use essa API para atualizar o displayName para a entidade do CLOUD PC.
Reprovisionar	Nenhum	Reprovisionar um objeto cloud pc.
Ação remota de reprovisionamento em massa	Nenhum	Reprovisionar em massa um conjunto de dispositivos cloud pc com Intune IDs de dispositivo gerenciadas.
Redimensionar a ação remota	Nenhum	Atualize ou faça downgrade de um PC de Nuvem existente para outra configuração com nova vCPU e tamanho de armazenamento por meio Intune ID do dispositivo gerenciado.
Start	Nenhum	Inicie um PC de Nuvem específico para um usuário. Atualmente, há suporte apenas Windows 365 Frontline PCs na Nuvem.
Stop	Nenhum	Parar um pc de nuvem específico para um usuário. Atualmente, há suporte apenas Windows 365 Frontline PCs na Nuvem.
Solução de problemas	Nenhum	Solucionar problemas de um objeto específico do Cloud PC. Use essa API para marcar o status de integridade do PC cloud e do host de sessão.
Restaurar	Nenhum	Restaure um objeto cloud pc para um estado anterior de um instantâneo.
Ação remota de restauração em massa	cloudPcBulkRemoteActionResult	Restaure vários dispositivos cloud pc com uma única solicitação que inclui as IDs de dispositivos gerenciados Intune e uma data e hora do ponto de restauração.
Definir status de revisão	Nenhum	Defina o status de revisão de um dispositivo de PC de Nuvem específico.
Obter status de revisão	cloudPcReviewStatus	Obtenha a status de revisão de um dispositivo de PC de Nuvem específico.
Revisão de conjunto em massa status	cloudPcBulkRemoteActionResult	Defina o status de revisão de vários dispositivos cloud pc com uma única solicitação que inclui as IDs de Intune dispositivos gerenciados.
Lista para usuário	coleção cloudPC	Liste os dispositivos cloud pc atribuídos ao usuário conectado.
Obter informações de inicialização para o usuário	cloudPcLaunchInfo	Obtenha o cloudPcLaunchInfo para o usuário conectado.
Obter histórico de conectividade	coleção cloudPcConnectivityEvent	Obtenha o histórico de conectividade do Cloud PC.
Obter ações remotas com suporte	coleção cloudPcRemoteActionCapability	Obtenha uma lista de ações remotas do Cloud PC com suporte para um dispositivo de CLOUD PC específico, incluindo os nomes de ação e os recursos.
Instalação do agente de parceiro de repetição	Nenhum	Repita a instalação para os agentes parceiros que não conseguiram instalar no COMPUTADOR de Nuvem.
Redimensionar em massa	coleção cloudPcRemoteActionResult	Execute uma ação de redimensionamento em massa para redimensionar um grupo de PCs de Nuvem que passaram com êxito na validação (cloudPC: validateBulkResize). Se os dispositivos não puderem ser redimensionados, eles serão rotulados como "falha de redimensionamento", enquanto os dispositivos restantes serão provisioned para o processo de redimensionamento.
Validar redimensionamento em massa	coleção cloudPcResizeValidateResult	Valide se um conjunto de dispositivos cloud pc atendem aos requisitos a serem redimensionados em massa.
Obter o estado de acesso da linha de frente	frontlineCloudPcAccessState	Obtenha o estado de acesso do pc de nuvem de linha de frente. Os valores possíveis são unassigned, noLicensesAvailable, activationFailed, active, activating, standbyMode, unknownFutureValue.
Obter o estado de acesso ao trabalho de turno (preterido)	shiftWorkCloudPcAccessState	Obtenha o estado de acesso do computador cloud do trabalho de turno. Os valores possíveis são: unassigned, , noLicensesAvailable, activationFailed, active, activating, waitlisted, unknownFutureValue. standbyMode Observe que você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter o seguinte valor neste enumerável em evolução: standbyMode. Essa API foi preterida e deixará de retornar dados em 31 de dezembro de 2023. Daqui para frente, use a API getFrontlineCloudPcAccessState .
Reprovisionar a ação remota (preterida)	Nenhum	Reprovisionar um PC na Nuvem com uma ID do dispositivo gerenciada Intune. Essa API foi preterida e deixará de retornar dados em 30 de setembro de 2023. Daqui para frente, use a API de reprovisionamento .
Restaurar a ação remota (preterida)	Nenhum	Restaure um dispositivo cloud pc para um estado anterior com uma ID do dispositivo gerenciada Intune. Essa API foi preterida e deixará de retornar dados em 30 de setembro de 2023. Daqui para frente, use a API de restauração .

Propriedades

Propriedade	Tipo	Descrição
aadDeviceId	Cadeia de caracteres	A ID do dispositivo Microsoft Entra do PC de Nuvem.
allotmentDisplayName	Cadeia de caracteres	O nome do loteamento divide licenças de locatário em lotes ou grupos menores que ajudam a restringir o número de licenças disponíveis para uso em uma atribuição específica. Quando o provisioningType é dedicated, o nome do loteamento é null. Somente leitura.
conectividadeResult	cloudPcConnectivityResult	A integridade da conectividade marcar resultado de um PC na nuvem, incluindo o carimbo de data/hora atualizado e se o PC na Nuvem pode estar conectado.
diskEncryptionState	cloudPcDiskEncryptionState	A criptografia de disco aplicada ao PC de Nuvem. Valores possíveis: notAvailable, notEncrypted, encryptedUsingPlatformManagedKey, encryptedUsingCustomerManagedKey e unknownFutureValue.
displayName	Cadeia de caracteres	O nome de exibição do PC cloud.
gracePeriodEndDateTime	DateTimeOffset	A data e a hora em que o período de carência termina e ocorrem reprovisionamento ou desprovisionamento. Necessário somente se o status for inGracePeriod. O carimbo de data/hora é mostrado no formato ISO 8601 e utc (tempo universal coordenado). Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
id	Cadeia de caracteres	O identificador exclusivo para o PC na nuvem. Somente leitura.
imageDisplayName	Cadeia de caracteres	Nome da imagem do sistema operacional que está no PC de nuvem.
lastLoginResult	cloudPcLoginResult	O último resultado de logon do PC na nuvem. Por exemplo, { "time": "2014-01-01T00:00:00Z"}.
lastModifiedDateTime	DateTimeOffset	A última data e hora modificadas do PC na Nuvem. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
lastRemoteActionResult	cloudPcRemoteActionResult	O último resultado de ação remota dos PCs da nuvem corporativa. As ações remotas com suporte são: Reboot, , Rename, Reprovision, Restore, Troubleshoot.
managedDeviceId	Cadeia de caracteres	O Intune ID do dispositivo do PC de Nuvem.
managedDeviceName	Cadeia de caracteres	O Intune nome do dispositivo do PC cloud.
onPremisesConnectionName	Cadeia de caracteres	A conexão de rede do Azure aplicada durante o provisionamento de PCs de Nuvem.
osVersion	cloudPcOperatingSystem	A versão do sistema operacional (sistema operacional) a ser provisionada em PCs de nuvem. Os valores possíveis são: windows10, windows11, unknownFutureValue.
partnerAgentInstallResults	coleção cloudPcPartnerAgentInstallResult	Os resultados da instalação de cada agente parceiro status no Cloud PC.
powerState	cloudPcPowerState	O estado de energia de um COMPUTADOR na Nuvem. Os valores possíveis são: running, poweredOff, unknown. Essa propriedade só dá suporte a PCs de nuvem de trabalho de turno.
provisioningPolicyId	Cadeia de caracteres	A ID da política de provisionamento do PC na nuvem.
provisioningPolicyName	Cadeia de caracteres	A política de provisionamento que é aplicada durante o provisionamento de PCs de Nuvem.
provisioningType	cloudPcProvisioningType	O tipo de licenças a serem usadas ao provisionar computadores na nuvem usando essa política. Os valores possíveis são: dedicated, shared, unknownFutureValue. O valor padrão é dedicated.
servicePlanId	Cadeia de caracteres	A ID do plano de serviço do PC cloud.
servicePlanName	Cadeia de caracteres	O nome do plano de serviço do PC na nuvem.
servicePlanType	cloudPcServicePlanType	O tipo de plano de serviço do PC cloud.
status	microsoft.graph.cloudPcStatus	O status do PC cloud. Os valores possíveis são: notProvisioned, provisioning, provisioned, inGracePeriod, deprovisioning, failed, provisionedWithWarnings, resizing, restoring, pendingProvision, unknownFutureValue, movingRegion e resizePendingLicense. 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: movingRegion, resizePendingLicense.
statusDetails	cloudPcStatusDetails	Os detalhes do status do CLOUD PC.
userAccountType	cloudPcUserAccountType	O tipo de conta do usuário em PCs de nuvem provisionados. Os valores possíveis são: standardUser, administrator, unknownFutureValue.
userPrincipalName	Cadeia de caracteres	O UPN (nome da entidade de usuário) do usuário atribuído ao PC na nuvem.

valores cloudPcDiskEncryptionState

Member	Descrição
Notavailable	O COMPUTADOR na Nuvem não está provisionado ou está em um estado em que a criptografia não está disponível.
notEncrypted	O COMPUTADOR na Nuvem deve ser criptografado, mas a criptografia ainda não foi feita (reservada, não deve acontecer).
encryptedUsingPlatformManagedKey	O PC na Nuvem é criptografado usando uma chave gerenciada pela plataforma. Esse membro será o valor padrão se a chave gerenciada pelo cliente não estiver habilitada.
encryptedUsingCustomerManagedKey	O CLOUD PC é criptografado usando a chave gerenciada pelo cliente.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.

valores cloudPcPowerState

Member	Descrição
Executando	O status do Cloud PC está em execução.
poweredOff	A status do Cloud PC está desligada.
desconhecido	O status do Cloud PC é desconhecido.

valores cloudPcStatus

A tabela a seguir lista os membros de uma enumeração evolução. Observe que você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores neste enumerável em evolução: movingRegion, resizePendingLicense.

Member	Descrição
notProvisioned	O PC da Nuvem ainda não foi provisionado.
Provisionamento	O provisionamento de PC na nuvem está em andamento.
provisionado	O CLOUD PC está provisionado e os usuários podem acessá-lo.
inGracePeriod	O PC da Nuvem está no período de carência de uma semana antes da desprovisionação.
Desprovisionamento	O PC da Nuvem está desprovisionando.
Falhou	A operação no Cloud PC falhou.
provisionedWithWarnings	O PC na Nuvem é provisionado e os usuários finais podem acessá-lo com alguns avisos. O usuário pode continuar a usar este PC na Nuvem.
Redimensionamento	O COMPUTADOR na Nuvem está redimensionando.
pendingProvision	O provisionamento está pendente no COMPUTADOR de Nuvem. Nesse caso, o número de PCs na nuvem no período de carência é maior do que o número de licenças disponíveis totais.
Restaurar	O COMPUTADOR na Nuvem está restaurando.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.
movingRegion	Indica que o PC na Nuvem está sendo movido de uma região para outra.
resizePendingLicense	Indica que o processo de redimensionamento do CLOUD PC foi iniciado, mas não pode ser concluído porque a licença de destino não foi identificada. No momento, aguarda a ação do cliente para resolve o problema de licenciamento.

valores frontlineCloudPcAccessState

Member	Descrição
não atribuído	Defina como não atribuído se o COMPUTADOR de Nuvem não consumir licenças de uso compartilhado. O valor padrão é unassigned.
noLicenses Disponíveis	Indica que todas as licenças de uso compartilhado estão em uso.
Falha na ativação	Indica que a ativação do pc na nuvem de linha de frente falhou depois que o usuário solicitou um pc de nuvem de linha de frente.
Ativo	Indica que o pc cloud de linha de frente está em um estado ativo com uma licença de uso compartilhado atribuída e que o usuário pode se conectar ao PC na nuvem.
Ativar	Indica que um usuário solicitou para conectar o PC na Nuvem e que o serviço está começando.
standbyMode	Indica que o pc cloud de linha de frente está em um estado de espera antes de ser desligado e desalocado. Um pc cloud de linha de frente em estado de espera ainda está acessível pelo usuário.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.

valores shiftWorkCloudPcAccessState (preteridos)

A tabela a seguir lista os membros de uma enumeração evolução. Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores neste enumerável em evolução: standbyMode.

Member	Descrição
não atribuído	Defina como não atribuído se o COMPUTADOR na Nuvem não estiver consumindo nenhuma licença de uso compartilhado. O valor padrão é unassigned.
noLicenses Disponíveis	Indica que todas as licenças de uso compartilhado estão em uso.
Falha na ativação	Indica que a ativação do computador na nuvem de trabalho de turno falhou depois que o usuário solicitou um pc cloud de trabalho de turno.
Ativo	Indica que o computador cloud de trabalho de turno está em um estado ativo com uma licença de uso compartilhado atribuída e que o usuário pode se conectar ao PC na nuvem.
Ativar	Indica que um usuário solicitou para conectar o PC na Nuvem e que o serviço está começando.
waitlisted (preterido)	Indica que o computador cloud de trabalho de turno está em estado de lista de espera após as solicitações do usuário para conectar esse PC na Nuvem e todas as licenças de uso compartilhado estão sendo usadas ativamente. Esse valor foi preterido e deixará de retornar em 17 de maio de 2023.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.
standbyMode	Indica que o computador cloud de trabalho de turno está em um estado de espera antes de ser desligado e desalocado. Um computador cloud de trabalho de turno em estado de espera ainda está acessível pelo usuário.

Relações

Nenhum

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.cloudPC",
  "aadDeviceId": "String",
  "allotmentDisplayName": "String",
  "connectivityResult": "String",
  "diskEncryptionState": "String",
  "displayName": "String",
  "gracePeriodEndDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "lastLoginResult": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "lastRemoteActionResult": "String",
  "managedDeviceId": "String",
  "managedDeviceName": "String",
  "onPremisesConnectionName": "String",
  "powerState": "String",
  "osVersion": "String",
  "partnerAgentInstallResults": "String",
  "provisioningPolicyId": "String",
  "provisioningPolicyName": "String",
  "provisioningType": "String",
  "servicePlanId": "String",
  "servicePlanName": "String",
  "servicePlanType": "String",
  "status": "String",
  "userAccountType": "String",
  "userPrincipalName": "String"
}