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 um ambiente de trabalho virtual gerido na cloud. Este CLOUD PC também está inscrito no Intune e gerido através do portal do Microsoft Endpoint Manager, pelo que o PC na Cloud também tem um ID de dispositivo gerido Intune correspondente.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Listar cloudPCs | coleção cloudPC | Listar propriedades e relações dos objetos do CLOUD PC. |
| Obter cloudPC | cloudPC | Leia as propriedades e relações de um objeto de PC na Cloud. |
| Obter PCs cloud aprovisionados | coleção cloudPC | Obtenha todos os PCs cloud aprovisionados de um plano de serviço específico para utilizadores num grupo de utilizadores Microsoft Entra. |
| Alterar o tipo de conta de utilizador | Nenhum | Altere o tipo de conta do utilizador num PC na Cloud específico. |
| Fim do período de carência | Nenhum | Termine o período de tolerância para um objeto de PC na Cloud. |
| Ligar | Nenhum | Ligar um objeto específico do WINDOWS Frontline Cloud PC. Esta ação suporta cenários de administrador mem. |
| Desligar | Nenhum | Desligue um objeto específico do WINDOWS Frontline Cloud PC. Esta ação suporta cenários de administrador mem. |
| Reiniciar | Nenhum | Reinicie um objeto específico do CLOUD PC. |
| Rename | Nenhum | Mude o nome de um objeto específico do CLOUD PC. Utilize esta API para atualizar o displayName para a entidade do PC na Cloud. |
| Reprovisionar | Nenhum | Aprovisionar novamente um objeto de PC na Cloud. |
| Resize | Nenhum | Atualize ou mude para uma versão anterior de um PC na Cloud existente para uma configuração com uma nova CPU virtual (vCPU) e tamanho de armazenamento. |
| Start | Nenhum | Inicie um PC na Cloud específico. Atualmente, apenas são suportados Windows 365 Frontline PCs na Cloud. |
| Stop | Nenhum | Pare uma Cloud específica. Atualmente, apenas são suportados Windows 365 Frontline PCs na Cloud. |
| Solução de problemas | Nenhum | Resolver problemas de um objeto específico do PC na Cloud. Utilize esta API para marcar a status de estado de funcionamento do PC cloud e do anfitrião da sessão. |
| Restaurar | Nenhum | Restaure um objeto do CLOUD PC para um estado anterior a partir de um snapshot. |
| Definir revisão status | Nenhum | Defina a revisão status de um dispositivo Cloud PC específico com o ID do PC na Cloud. |
| Obter status de revisão | cloudPcReviewStatus | Obtenha a revisão status de um PC na Cloud. |
| Lista para o utilizador | coleção cloudPC | Liste os dispositivos cloud PC que são atribuídos ao utilizador com sessão iniciada. |
| Obter informações de inicialização | cloudPcLaunchInfo | Obtenha o cloudPCLaunchInfo para um PC na Cloud específico. |
| Obter histórico de conectividade | cloudPcConnectivityEvent collection | Obtenha o histórico de conectividade do Cloud PC. |
| Obter ações remotas suportadas | cloudPcRemoteActionCapability collection | Obtenha uma lista de ações remotas suportadas do CLOUD PC para um dispositivo Cloud PC específico, incluindo os nomes e capacidades da ação. |
| Obter resultados da ação remota | cloudPcRemoteActionResult collection | Obtenha os resultados da ação remota e marcar o status de uma ação remota específica executada no dispositivo Cloud PC associado. |
| Repetir a instalação do agente do parceiro | Nenhum | Repita a instalação dos agentes parceiros que não foram instalados no Cloud PC. |
| Validar o redimensionamento em massa | cloudPcResizeValidateResult collection | Confirme que um conjunto de dispositivos CLOUD PC cumpre os requisitos a redimensionar em massa. |
| Criar snapshot | Nenhum | Crie um snapshot para um dispositivo Cloud PC específico. |
| Obter instantâneos | coleção cloudPcSnapshot | Obtenha uma lista de recursos cloudPcSnapshot para um PC na Cloud. |
| Obter estado de acesso de primeira linha | frontlineCloudPcAccessState | Obtenha o estado de acesso do PC cloud de primeira linha. Os valores possíveis são unassigned, noLicensesAvailable, activationFailed, active, activating, standbyMode, unknownFutureValue. O noLicensesAvailable membro foi preterido e deixará de regressar a 30 de setembro de 2024. |
| Ação remota de aprovisionamento em massa (preterida) | Nenhum | Aprovisionar em massa um conjunto de dispositivos CLOUD PC com Intune IDs de dispositivo geridos. Esta API foi preterida e deixará de devolver dados a 28 de fevereiro de 2025. No futuro, utilize o recurso cloudPcBulkReprovision . |
| Redimensionamento em massa (preterido) | cloudPcRemoteActionResult collection | Execute uma ação de redimensionamento em massa para redimensionar um grupo de PCs na Cloud que passaram com êxito a validação (cloudPC: validateBulkResize). Se não for possível redimensionar quaisquer dispositivos, estes são identificados como "falha no redimensionamento", enquanto os restantes dispositivos se destinam provisioned ao processo de redimensionamento. Esta API foi preterida e deixará de devolver dados a 28 de fevereiro de 2025. No futuro, utilize o recurso cloudPcBulkResize . |
| Ação remota de restauro em massa (preterida) | cloudPcBulkRemoteActionResult | Restaure vários dispositivos cloud PC com um único pedido que inclua os IDs de Intune dispositivos geridos e uma data e hora de ponto de restauro. Esta API foi preterida e deixará de devolver dados a 28 de fevereiro de 2025. No futuro, utilize o recurso cloudPcBulkRestore . |
| Obter resultados de ação remota (preterido) | cloudPcRemoteActionResult | Verifique os resultados da ação remota especificada pelo PC na Cloud para um dispositivo CLOUD PC. Esta API foi preterida e deixará de devolver dados a 28 de fevereiro de 2025. No futuro, utilize a API retrieveCloudPcRemoteActionResults . |
| Obter status de revisão (preterido) | cloudPcReviewStatus | Obtenha a revisão status de um dispositivo Cloud PC específico por managedDeviceId. Esta API foi preterida e deixará de devolver dados a 28 de fevereiro de 2025. No futuro, utilize a API cloudPC: retrieveReviewStatus . |
| Definir status de revisão (preterido) | Nenhum | Defina a revisão status de um dispositivo Cloud PC específico com o ID do dispositivo gerido. Esta API foi preterida e deixará de devolver dados a 28 de fevereiro de 2025. No futuro, utilize a API cloudPC: setReviewStatus . |
| Revisão de conjuntos em massa status (preterido) | Nenhum | Defina a status de revisão de vários dispositivos CLOUD PC com um único pedido que inclui os IDs de Intune dispositivos geridos. Esta API foi preterida e deixará de devolver dados a 28 de fevereiro de 2025. No futuro, utilize o recurso cloudPcBulkSetReviewStatus . |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| aadDeviceId | Cadeia de caracteres | O Microsoft Entra ID do dispositivo do CLOUD PC. |
| allotmentDisplayName | Cadeia de caracteres | O nome do loteamento divide as licenças de inquilino em lotes ou grupos mais pequenos que ajudam a restringir o número de licenças disponíveis para utilização numa atribuição específica. Quando o provisioningType é dedicated, o nome do loteamento é null. Somente leitura. |
| connectivityResult | cloudPcConnectivityResult | O estado de funcionamento da conectividade marcar resultado de um PC na Cloud, incluindo o carimbo de data/hora atualizado e se o PC na Cloud pode ser ligado. |
| deviceRegionName | Cadeia de caracteres | O nome da região geográfica onde o PC na Cloud está atualmente aprovisionado. Por exemplo, westus3, eastus2e southeastasia. Somente leitura. |
| disasterRecoveryCapability | cloudPcDisasterRecoveryCapability | A recuperação após desastre status do PC na Cloud, incluindo a região primária, a região secundária e o tipo de capacidade. O valor predefinido é null que indica que a definição de recuperação após desastre está desativada. Para receber uma resposta com a propriedade $selectdisasterRecoveryCapability e $filter a mesma no disasterRecoveryCapability/{subProperty} URL do pedido. Para obter mais informações, veja Exemplo 4: Listar PCs na Cloud filtrados por tipo de capacidade de recuperação após desastre. Somente leitura. |
| diskEncryptionState | cloudPcDiskEncryptionState | A encriptação de disco aplicada ao PC na Cloud. Valores possíveis: notAvailable, notEncrypted, encryptedUsingPlatformManagedKey, encryptedUsingCustomerManagedKey e unknownFutureValue. |
| displayName | Cadeia de caracteres | O nome a apresentar do PC na Cloud. |
| gracePeriodEndDateTime | DateTimeOffset | A data e hora em que o período de tolerância termina e o reaprovisionamento ou desaprovisionamento ocorre. Necessário apenas se o status for inGracePeriod. O carimbo de data/hora é apresentado no formato ISO 8601 e hora universal coordenada (UTC). Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. |
| id | Cadeia de caracteres | O identificador exclusivo do PC na Cloud. Somente leitura. |
| imageDisplayName | Cadeia de caracteres | Nome da imagem do SO que está no PC na Cloud. |
| lastLoginResult | cloudPcLoginResult | O último resultado de início de sessão do CLOUD PC. Por exemplo, { "time": "2014-01-01T00:00:00Z"}. |
| lastModifiedDateTime | DateTimeOffset | A data e hora da última modificação do CLOUD PC. 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 a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. |
| lastRemoteActionResult | cloudPcRemoteActionResult | O último resultado da ação remota dos PCs de Cloud empresariais. As ações remotas suportadas são: Reboot, , RenameReprovision, , . TroubleshootRestore |
| managedDeviceId | Cadeia de caracteres | O Intune ID do dispositivo do CLOUD PC. |
| managedDeviceName | Cadeia de caracteres | O Intune nome do dispositivo do CLOUD PC. |
| onPremisesConnectionName | Cadeia de caracteres | A ligação de rede do Azure que é aplicada durante o aprovisionamento de PCs na Cloud. |
| osVersion | cloudPcOperatingSystem | A versão do sistema operativo (SO) a aprovisionar em PCs cloud. Os valores possíveis são: windows10, windows11, unknownFutureValue. |
| partnerAgentInstallResults | cloudPcPartnerAgentInstallResult collection (coleção cloudPcPartnerAgentInstallResult ) | Os resultados da instalação de todos os agentes parceiros status no Cloud PC. |
| powerState | cloudPcPowerState | O estado de energia de um PC na Cloud. Os valores possíveis são: running, poweredOff, unknown. Esta propriedade só suporta PCs na Cloud de trabalho por turnos. |
| provisioningPolicyId | Cadeia de caracteres | O ID da política de aprovisionamento do PC na Cloud. |
| provisioningPolicyName | Cadeia de caracteres | A política de aprovisionamento que é aplicada durante o aprovisionamento de PCs na Cloud. |
| provisioningType | cloudPcProvisioningType | O tipo de licenças a utilizar ao aprovisionar PCs na Cloud com esta política. Os valores possíveis são: dedicated, , sharedunknownFutureValue,sharedByUser, sharedByEntraGroup. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: sharedByUser, sharedByEntraGroup. O valor padrão é dedicated. ATENÇÃO: O shared membro foi preterido e deixará de regressar a 30 de abril de 2027; no futuro, utilize o sharedByUser membro. |
| servicePlanId | Cadeia de caracteres | O ID do plano de serviço do PC na Cloud. |
| servicePlanName | Cadeia de caracteres | O nome do plano de serviço do CLOUD PC. |
| servicePlanType | cloudPcServicePlanType | O tipo de plano de serviço do CLOUD PC. |
| status | microsoft.graph.cloudPcStatus | O status do CLOUD PC. Os valores possíveis são: notProvisioned, , provisioning, inGracePeriodprovisioned, , faileddeprovisioning, provisionedWithWarnings, resizing, restoring, pendingProvision, , unknownFutureValue, movingRegion, , resizePendingLicense, , modifyingSingleSignOn, . preparing Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: movingRegion, resizePendingLicense, modifyingSingleSignOn, preparing. |
| statusDetails (preterido) | cloudPcStatusDetails | Os detalhes do Cloud PC status. Por exemplo, { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. Esta propriedade foi preterida e deixará de ser suportada a partir de 31 de agosto de 2024. Em alternativa, utilize statusDetail. |
| statusDetail | cloudPcStatusDetail | Indica os status detalhados associados ao Cloud PC, incluindo código de erro/aviso, mensagem de erro/aviso, adicionalInformação. Por exemplo, { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. |
| connectionSetting | cloudPcConnectionSetting | A definição de ligação do PC na Cloud. Valores possíveis: enableSingleSignOn. Somente leitura. |
| userAccountType | cloudPcUserAccountType | O tipo de conta do utilizador em PCs cloud aprovisionados. Os valores possíveis são: standardUser, administrator, unknownFutureValue. |
| userPrincipalName | Cadeia de caracteres | O nome principal de utilizador (UPN) do utilizador atribuído ao CLOUD PC. |
cloudPcDiskEncryptionState valores
| Member | Descrição |
|---|---|
| não disponível | O Cloud PC não está aprovisionado ou está num estado em que a encriptação não está disponível. |
| notEncrypted | O CLOUD PC deve ser encriptado, mas a encriptação ainda não o fez (reservado, não deve acontecer). |
| encryptedUsingPlatformManagedKey | O CLOUD PC é encriptado através de uma chave gerida pela plataforma. Este membro é o valor predefinido se a chave gerida pelo cliente não estiver ativada. |
| encryptedUsingCustomerManagedKey | O CLOUD PC é encriptado com a chave gerida pelo cliente. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
valores cloudPcPowerState
| Member | Descrição |
|---|---|
| em execução | O cloud PC status está em execução. |
| poweredOff | O status do Cloud PC está desligado. |
| desconhecido | A status do Cloud PC é desconhecida. |
valores cloudPcStatus
A tabela seguinte lista os membros de uma enumeração evoluível. Tenha em atenção que tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: movingRegion, resizePendingLicense, modifyingSingleSignOn, preparing.
| Member | Descrição |
|---|---|
| não Aprovisionado | O CLOUD PC ainda não foi aprovisionado. |
| aprovisionamento | O aprovisionamento do PC na Cloud está em curso. |
| provisionado | O CLOUD PC está aprovisionado e os utilizadores podem aceder ao mesmo. |
| inGracePeriod | O Cloud PC está no período de tolerância de uma semana antes do desaprovisionamento. |
| desaprovisionamento | O CLOUD PC está a desaprovisionar. |
| falha | A operação no Cloud PC falhou. |
| provisionedWithWarnings | O CLOUD PC é aprovisionado e os utilizadores finais podem aceder ao mesmo com alguns avisos. O utilizador pode continuar a utilizar este PC na Cloud. |
| redimensionar | O CLOUD PC está a redimensionar. |
| pendingProvision | O aprovisionamento está pendente no CLOUD PC. Neste caso, o número de PCs na Cloud no período de tolerância é superior ao número total de licenças disponíveis. |
| a restaurar | O Cloud PC está a restaurar. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
| movingRegion | Indica que o PC na Cloud está a ser 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. Atualmente, aguarda a ação do cliente para resolve o problema de licenciamento. |
| modifyingSingleSignOn | Indica que o CLOUD PC está a atualizar a definição de início de sessão único. |
| a preparar | Indica que o PC na Cloud está a preparar-se com a configuração definida pelo administrador de TI (Aplicações, Configuração e Segurança) após o aprovisionamento status. Aplicar-se apenas a dispositivos Partilhados de Primeira Linha. |
frontlineCloudPcAccessState valores
| Member | Descrição |
|---|---|
| não atribuído | Defina como não atribuído se o PC na Cloud não consumir licenças de utilização partilhada. O valor padrão é unassigned. |
| noLicenses Disponíveis (preterido) | Indica que todas as licenças de utilização partilhada estão a ser utilizadas. O noLicensesAvailable membro foi preterido e deixará de regressar a 30 de setembro de 2024. |
| ativação Falhada | Indica que a ativação do CLOUD PC na linha da frente falhou depois de o utilizador ter pedido um PC na Cloud de primeira linha. |
| ativo | Indica que o CLOUD PC de primeira linha está num estado ativo com uma licença de utilização partilhada atribuída e o utilizador pode ligar-se ao CLOUD PC. |
| ativar | Indica que um utilizador pediu para ligar o CLOUD PC e o serviço está a iniciar. |
| standbyMode | Indica que o PC cloud de primeira linha está num estado de espera antes de ser encerrado e desalocado. Um PC cloud de primeira linha num estado de reserva ainda está acessível pelo utilizador. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
Relações
Nenhum
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.cloudPC",
"aadDeviceId": "String",
"allotmentDisplayName": "String",
"connectivityResult": "String",
"deviceRegionName": "String",
"disasterRecoveryCapability": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryCapability"},
"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"
}