Windows 365 (Pré-visualização)
O Windows 365 é um serviço baseado na cloud que cria automaticamente um novo tipo de máquina virtual Windows (PCs na nuvem) para os seus utilizadores finais. Cada PC na nuvem é atribuído a um utilizador individual como um dispositivo Windows dedicado. O Windows 365 fornece os benefícios de produtividade, segurança e colaboração do Microsoft 365.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://powerautomate.microsoft.com/en-us/support/ |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://www.microsoft.com/en-us/windows-365 |
| Política de privacidade | https://privacy.microsoft.com/en-us/privacystatement |
| Categorias | Operações de TI; Produtividade |
O conector Windows 365 fornece ações para gerir PCs com Windows 365 Cloud e políticas de provisionamento dentro do seu ambiente Microsoft Intune. Este conector permite-lhe automatizar operações do ciclo de vida do PC na Cloud, gestão de políticas de provisionamento e tarefas administrativas através dos fluxos do Power Automate.
Serviço, Classe e Regiões
| Serviço | Classe | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões Power Automate |
| Aplicações Lógicas | Premium | Todas as regiões de Logic Apps |
| Aplicações Power | Premium | Todas as regiões Power Apps |
| Power Automate | Premium | Todas as regiões Power Automate |
Contato
| Entrar em contato | |
|---|---|
| Nome | Windows 365 |
| URL | https://learn.microsoft.com/en-us/connectors/windows365 |
W365powerplatform@microsoft.com |
Pré-requisitos
Para usar esse conector, você precisa:
- Licenças do Windows 365 para a sua organização
- Subscrição Microsoft Intune
- Privilégios suficientes no controlo de acesso baseado em papéis (RBAC) do Microsoft Intune para gerir os recursos do Windows 365
- Conta Azure AD com permissões apropriadas
Permissões necessárias
Os utilizadores devem ter um dos seguintes papéis RBAC no Intune:
- Administrador Global
- Administrador de Serviços Intune
- Administrador do Windows365 (para operações específicas de PC na nuvem)
- Função personalizada com permissões do Windows 365 (requer
Webhook.CreateeWebhook.Deletepara operações de gatilho)
Importante: Este conector requer licenças do Windows 365 e permissões RBAC apropriadas do Microsoft Intune. Todas as operações utilizam a Microsoft Graph API e estão sujeitas a limites de limitação da Graph API.
Problemas conhecidos e limitações
O conector do Windows 365 está atualmente em Pré-visualização Pública.
A Microsoft quer certificar-se de que um conector é estável antes de o lançarmos em disponibilidade geral. Até lá, o conector está em pré-visualização. As pré-visualizações são fornecidas "tal como estão", "com todas as falhas" e "conforme disponível". São excluídos dos contratos de nível de serviço (SLAs), mas são disponibilizados numa base de pré-visualização, para que possa obter acesso antecipado e fornecer feedback. Saiba mais sobre as funcionalidades de pré-visualização e como as ativar. As visualizações prévias podem não ser cobertas pelo suporte ao cliente. Poderão ser descontinuadas a qualquer momento, sem aviso prévio e poderão não ser lançadas para disponibilidade geral.
Recomendamos que experimente os conectores de pré-visualização e forneça feedback. Isto irá ajudar-nos a estabilizar e a melhorar os conectores. Você pode usar os fóruns do produto para compartilhar problemas e comentários. O suporte da Microsoft poderá não estar disponível para funcionalidades de pré-visualização, incluindo conectores, mas tentaremos fornecer suporte numa base de melhor esforço. Para saber mais, por favor visite o FAQ de Conectores em pré-visualização.
Limites gerais
- As capacidades e limitações são consistentes com a API subjacente do Graph.
- Quando for necessário chamar algo no endpoint beta do Graph, use a ação de pedido HTTP.
Ações
PCs Cloud de Lista
ID da Operação: ListCloudPCs
Esta ação permite-lhe listar PCs na nuvem.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| $select | Não | cadeia (de caracteres) | $select permite escolher quais as propriedades que são devolvidas do Graph. |
| $filtro | Não | cadeia (de caracteres) | $filter permite obter apenas um subconjunto de uma coleção a partir do Graph. |
Regressos
| Nome | Tipo | Description |
|---|---|---|
| aadDeviceId | String | O ID de dispositivo Microsoft Entra para o PC na Cloud, também conhecido como ID de dispositivo Azure Active Directory (Azure AD), consiste em 32 caracteres num formato GUID. Gerado numa VM ligada ao Microsoft Entra ID. Somente leitura. |
| diskEncryptionState | String | Mostra o estado da encriptação do disco. |
| nome de exibição | String | O nome de exibição para o Cloud PC. O comprimento máximo é de 64 caracteres. Somente leitura. |
| PeríodoGraçaFimDataDataHora | DateTimeOffset | A data e hora em que o período de carência termina e ocorre o reabastecimento ou desprovisionamento. Obrigatório apenas se o estado for inGracePeriod. O carimbo temporal é mostrado no formato ISO 8601 e no Tempo Universal Coordenado (UTC). Por exemplo, meia-noite UTC de 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. |
| id | String | O identificador único da entidade Cloud PC voltada para o cliente, que consiste em 32 caracteres num formato GUID. Somente leitura. |
| imageDisplayName | String | O nome da imagem do sistema operativo usada para o PC na Cloud. O comprimento máximo é de 50 caracteres. Apenas letras (A-Z, a-z), números (0-9) e caracteres especiais (-,_,.) são permitidos para esta propriedade. O valor da propriedade não pode começar nem terminar com um sublinhado. Somente leitura. |
| lastModifiedDateTime | DateTimeOffset | A última data e hora modificadas do Cloud PC. O tipo de carimbo temporal representa informação de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC de 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. |
| managedDeviceId | String | O ID de dispositivo inscrito no Intune para o Cloud PC consiste em 32 caracteres num formato GUID. A propriedade managedDeviceId dos PCs Business Cloud do Windows 365 é sempre nula, pois os PCs do Windows 365 Business Cloud não são automaticamente inscritos no Intune. Somente leitura. |
| NomeDispositivogerenciado | String | O nome do dispositivo inscrito no Intune para o PC na nuvem. A propriedade managed DeviceName dos PCs Cloud Empresariais com Windows 365 é sempre nula, pois os PCs Cloud Empresariais com Windows 365 não são automaticamente inscritos no Intune. Somente leitura. |
| onPremisesConnectionName | String | A ligação on-premises que se aplicava durante o provisionamento dos PCs Cloud. Somente leitura. |
| provisioningPolicyId | String | O ID da política de provisão para o Cloud PC consiste em 32 caracteres em formato GUID. Uma política define o tipo de PC Cloud que o utilizador pretende criar. Somente leitura. |
| provisioningPolicyName | String | A política de provisionamento que se aplicava durante o provisionamento dos PCs Cloud. O comprimento máximo é de 120 caracteres. Somente leitura. |
| provisioningType | String | Mostra o tipo de provisionamento. |
| servicePlanId | String | O ID do plano de serviço para o Cloud PC consiste em 32 caracteres em formato GUID. Para mais informações sobre planos de serviço, consulte nomes de produtos e identificadores de planos de serviço para licenciamento. Só leitura. |
| servicePlanName | String | O nome do plano de serviço para a entidade Cloud PC voltada para o cliente. Somente leitura. |
| ServicePlanType | String | Mostra o tipo de plano. |
| userPrincipalName | String | O nome principal do utilizador (UPN) do utilizador atribuído ao PC na Cloud. O comprimento máximo é de 113 caracteres. Para mais informações sobre políticas de nomes de utilizador, consulte Políticas de palavras-passe e restrições de conta no Microsoft Entra ID. Só leitura. |
Obtenha políticas de aprovisionamento
ID da Operação: GetProvisioningPoliciesV1
Esta ação permite-lhe devolver informações sobre as políticas de provisionamento.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| $select | Não | String | $select permite escolher quais as propriedades que são devolvidas do Graph. |
| $filtro | Não | String | $filter permite obter apenas um subconjunto de uma coleção a partir do Graph. |
| $expand | Não | String | $expand permite devolver recursos relacionados do Graph. |
Regressos
Use $expand com um valor de atribuições para ver os valores devolvidos abaixo:
| Nome | Tipo | Description |
|---|---|---|
| cloudPCNamingTemplate | String | O modelo usado para nomear os PCs Cloud era provisionado através desta política. O modelo pode conter texto personalizado e tokens de substituição, incluindo %USERNAME:x% e %RAND:x%, que representam, respetivamente, o nome do utilizador e um número gerado aleatoriamente. Por exemplo, CPC-%USERNAME:4%-%RAND:5% significa que o nome do Cloud PC começa por CPC-, seguido de um nome de utilizador de quatro caracteres, um caractere - e depois cinco caracteres aleatórios. O comprimento total do texto gerado pelo modelo não pode exceder 15 caracteres. |
| descrição | String | A descrição da política de provisionamento. |
| nome de exibição | String | O nome de exibição para a política de provisionamento. |
| domainJoinConfiguração | Coleção cloudPcDomainJoinConfiguration | Especifica uma lista ordenada por prioridade sobre como os PCs Cloud se juntam ao Microsoft Entra ID (Azure AD). |
| enableSingleSignOn | booleano | É verdade se o PC Cloud provisionado puder ser acedido por login único. False indica que o PC Cloud provisionado não suporta esta funcionalidade. O valor predefinido é false. Os utilizadores do Windows 365 podem usar o single logon para autenticar-se no Microsoft Entra ID com opções sem palavra-passe (por exemplo, chaves FIDO) para aceder ao seu PC Cloud |
| id | String | O identificador único associado à política de provisionamento. Este ID é preenchido automaticamente durante a criação de uma nova política de provisionamento. Somente leitura. |
| imageDisplayName | String | O nome de exibição da imagem do sistema operativo usada para o provisionamento. Por exemplo, Pré-visualização do Windows 11 + Aplicações Microsoft 365 23H2 23H2. |
| imageId | String | O identificador único que representa uma imagem do sistema operativo usada para provisionar novos PCs na Cloud. O formato para uma imagem do tipo galeria é: {publisherName_offerName_skuName}. Os valores suportados para cada um dos parâmetros são: editor: Microsoftwindowsdesktop oferece: 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 |
| Tipo de imagem | cloudPcProvisioningPolicyImageType | O tipo de imagem do sistema operativo (personalizada ou de galeria) usada para provisionamento em PCs Cloud. Os valores possíveis são: galeria, personalizado. O valor padrão é galeria. |
Obtenha uma política de provisionamento
ID da Operação: GetAProvisioningPolicyV1
Esta ação permite-lhe obter os detalhes de uma política de provisão específica.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| ID da política de provisão | Yes | String | O ID da política de provisionamento. Tem de estar incluído. |
| $select | Não | String | $select permite escolher quais as propriedades que são devolvidas do Graph. |
| $filtro | Não | String | $filter permite obter apenas um subconjunto de uma coleção a partir do Graph. |
Regressos
As saídas desta operação são dinâmicas.
Criar uma política de provisionamento
ID da Operação: CreateAProvisioningPolicyV1
Esta ação permite-lhe criar uma política de provisionamento.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| Nome | Yes | String | A política de provisionamento que se aplicava durante o provisionamento dos PCs Cloud. O comprimento máximo é de 120 caracteres |
| Description | Yes | String | A descrição da política de provisionamento. |
| Configuração de união de domínio | Yes | ||
| ID da imagem | Yes | String | Este é o ID de imagem que queres usar para provisionar PCs na Cloud. |
| Nome de visualização da imagem | Yes | String | O nome da imagem do sistema operativo usada para o PC na Cloud. O comprimento máximo é de 50 caracteres. Apenas letras (A-Z, a-z), números (0-9) e caracteres especiais (-,_,.) são permitidos para esta propriedade. O valor da propriedade não pode começar nem terminar com um sublinhado. |
| Tipo de imagem | Yes | String | Personalizado ou Galeria. |
| Tipo de aprovisionamento | Yes | String | Partilhado ou dedicado. |
| Configuração/localização do Windows | Yes | String | Fornece a língua/local que gostarias de usar. O Windows 365 disponibiliza mais de 30 pares de linguagens e regiões deste tipo. |
Também pode adicionar outros campos do Graph em parâmetros Avançados.
Regressos
As saídas desta operação são dinâmicas.
Atribuir uma política de provisionamento a um grupo
ID da Operação: AssignAProvisioningPolicyToAGroupV1
Esta ação permite-lhe atribuir um grupo a uma política de provisionamento.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| ID da política de provisão | Yes | String | Este é o ID da política de provisionamento ao qual gostaria de atribuir um grupo. |
| Atribuições – ID do Grupo Alvo | Yes | String | Grupo de utilizadores do Entra ID. |
| Atribuições – ID do Plano de Serviço Alvo | Não | String | O identificador único do plano de serviço que indica qual o tamanho do PC Cloud a fornecer ao utilizador. |
Regressos
As saídas desta operação são dinâmicas.
Atualizar uma política de aprovisionamento
ID da Operação: UpdateAProvisioningPolicyV1
Esta ação permite-lhe atualizar uma política de provisionamento.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| ID da política de provisão | Yes | String | Este é o ID da política de provisionamento da política que pretende atualizar. |
| Description | Não | String | É para isto que a descrição da política de aprovisionamento será atualizada. |
Também pode adicionar outros campos do Graph em parâmetros Avançados.
Regressos
As saídas desta operação são dinâmicas.
Obtenha uma política de provisionamento
ID da Operação: GetAProvisoningPolicyV1
Esta ação permite-lhe obter os detalhes de uma política de provisionamento.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| ID da política de provisão | Yes | String | O ID da política de provisão para o Cloud PC consiste em 32 caracteres em formato GUID. Uma política define o tipo de PC Cloud que o utilizador pretende criar. |
| $select | Não | String | $select permite escolher quais as propriedades que são devolvidas do Graph. |
| $expand | Não | String | $expand permite devolver recursos relacionados do Graph. |
Também pode adicionar outros campos do Graph em parâmetros Avançados.
Regressos
As saídas desta operação são dinâmicas.
Iniciar uma ação remota
ID da Operação: RemoteActions
Esta ação permite-lhe iniciar uma ação remota num PC na Cloud.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| Cloud PC ID | Yes | String | Isto permite-lhe especificar qual o ID do PC na Cloud que quer direcionar com uma ação remota. |
| Ação remota | Yes | String | Isto permite-lhe escolher quando a ação remota quer realizar num PC na Cloud. |
| Ação remota – ID de snapshot | Não | String | Se optar por restaurar um PC na Cloud, deve também fornecer um ID de snapshot. |
| Ação remota – Nome de visualização | Não | String | Se optar por renomear um PC Cloud, deve também fornecer um nome de visualização. |
Regressos
Se for bem-sucedido, isto devolve um código de resposta 204 Sem Conteúdo.
Enviar uma solicitação HTTP do Microsoft Graph
ID da Operação: HttpRequest
Esta ação permite-lhe chamar diretamente o Graph e personalizar a chamada.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| URI | Yes | String | Isto permite-lhe especificar qual URI chamar, por exemplo: https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents |
| Método | Yes | String | Isto permite-lhe definir o método de chamada. |
Também podes adicionar outros campos (cabeçalhos, corpo, etc.) em parâmetros avançados.
Regressos
As saídas desta operação são dinâmicas.
Acionadores
Todos os cenários fazem parte de um único gatilho, que pode ser selecionado no próprio corpo do gatilho.
| Nome do gatilho | Descrição |
|---|---|
| Quando uma ação remota num PC Cloud é acionada | Permite desencadear um fluxo quando uma ação remota é acionada. |
| Quando uma ação remota num PC Cloud é concluída | Permite-te ativar um fluxo quando uma ação remota num PC Cloud termina. |
| Quando uma política de provisionamento é atualizada | Permite desencadear um fluxo quando uma política de provisionamento é atualizada. |
| Quando é criada uma nova política de aprovisionamento | Permite iniciar um fluxo quando uma política de provisionamento é criada. |
| Quando um PC Cloud é criado | Este gatilho permite-lhe iniciar um fluxo quando um PC Cloud é criado. |
Quando uma política de provisionamento ou um PC na nuvem é atualizado
- ID da Operação: Webhook
- Descrição: Este gatilho é ativado quando uma política de provisionamento ou um PC na nuvem é atualizado.
Parâmetros
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| Scenario | Yes | Menu Suspenso | Pode escolher entre os cenários suportados: |
| - Quando um PC Cloud é criado | |||
| - Quando é criada uma nova política de provisionamento | |||
| - Quando uma política de provisionamento é atualizada | |||
| - Quando uma ação remota num PC Cloud é concluída | |||
| - Quando uma ação remota num PC Cloud é desencadeada |
Regressos
As saídas desta operação são dinâmicas.
Limites de Limitação
| Nome | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Atribuir uma política de provisionamento a um grupo |
Atribuir uma política de provisionamento a um grupo. |
| Atualizar uma política de aprovisionamento |
Atualiza uma política de provisionamento. |
| Compra um PC Cloud |
Compra um PC Cloud |
| Criar uma política de provisionamento |
Cria uma política de provisionamento. |
| Eliminar uma política de provisionamento |
Elimina uma política de provisionamento. |
| Enviar um pedido HTTP Microsoft Graph (Pré-visualização) |
Construir um pedido de API REST para Microsoft Graph |
| Iniciar uma ação remota |
Inicia uma ação remota num PC na Cloud. |
| Obtenha políticas de aprovisionamento |
Recebe uma lista de políticas de provisionamento. |
| Obtenha uma política de provisionamento |
Recebe uma política de aprovisionamento específica. |
| PCs Cloud de Lista |
Lista CloudPCs |
Atribuir uma política de provisionamento a um grupo
Atribuir uma política de provisionamento a um grupo.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
ID da política de provisão
|
id | True | string |
id |
|
ID da Política de Provisionamento
|
id | string |
Este é o ID da política de provisão ao qual gostaria de atribuir um grupo |
|
|
ID do grupo
|
groupId | True | string |
groupId |
|
servicePlanId
|
servicePlanId | string |
ID do Plano de Serviço Alvo |
Atualizar uma política de aprovisionamento
Atualiza uma política de provisionamento.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
ID da política de provisão
|
id | True | string |
id |
|
ID do grupo
|
autopatchGroupId | string |
autopatchGroupId |
|
|
ID do perfil de preparação do dispositivo
|
devicePreparationProfileId | string |
devicePreparationProfileId |
|
|
Tempo de pausa da candidatura em minutos
|
applicationTimeoutInMinutes | integer |
applicationTimeOutInMinutes |
|
|
Em caso de falha, o acesso ao dispositivo foi negado
|
onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
|
Description
|
description | string |
descrição |
|
|
Nome de exibição
|
displayName | string |
nome de exibição |
|
|
Tipo de junção de domínio
|
domainJoinType | string |
domainJoinType |
|
|
ID de ligação local
|
onPremisesConnectionId | string |
onPremisesConnectionId |
|
|
Grupo de regiões
|
regionGroup | string |
Região Grupo |
|
|
Nome da região
|
regionName | string |
nome_da_região |
|
|
Tipo
|
type | string |
tipo |
|
|
Ativar login único
|
enableSingleSignOn | boolean |
enableSingleSignOn |
|
|
Nome de visualização da imagem
|
imageDisplayName | string |
imageDisplayName |
|
|
ID da imagem
|
imageId | string |
imageId |
|
|
Tipo de imagem
|
imageType | string |
Tipo de imagem |
|
|
Tipo gerido
|
managedType | string |
managedType |
|
|
Profile
|
profile | string |
perfil |
|
|
Localidade
|
locale | string |
região |
|
|
Outras áreas
|
otherFields | object |
Outros domínios |
Compra um PC Cloud
Compra um PC Cloud
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
Cloud PC ID
|
cloudPcId | True | string |
O identificador único do Cloud PC. |
|
Selecionar
|
$select | string |
Selecione propriedades a serem devolvidas. |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
ID
|
id | string |
O identificador único da entidade Cloud PC voltada para o cliente, que consiste em 32 caracteres num formato GUID. |
|
ID do dispositivo Entra
|
aadDeviceId | string |
O ID de dispositivo Microsoft Entra para o PC na Cloud, também conhecido como ID de dispositivo Azure Active Directory (Azure AD), consiste em 32 caracteres num formato GUID. Gerado numa VM ligada ao Microsoft Entra ID. Somente leitura. |
|
Nome de exibição
|
displayName | string |
O nome de exibição para o Cloud PC. O comprimento máximo é de 64 caracteres. Somente leitura. |
|
Nome de visualização da imagem
|
imageDisplayName | string |
O nome da imagem do sistema operativo usada para o PC na Cloud. O comprimento máximo é de 50 caracteres. |
|
ID da política de provisão
|
provisioningPolicyId | string |
O ID da política de provisão para o Cloud PC consiste em 32 caracteres em formato GUID. Uma política define o tipo de PC Cloud que o utilizador pretende criar. |
|
Nome da política de aprovisionamento
|
provisioningPolicyName | string |
A política de provisionamento que se aplicava durante o provisionamento dos PCs Cloud. |
|
Nome da ligação on-premises
|
onPremisesConnectionName | string |
A ligação de rede Azure aplicada durante o provisionamento dos PCs Cloud. |
|
ID do plano de serviço
|
servicePlanId | string |
O ID do plano de serviço para o Cloud PC consiste em 32 caracteres em formato GUID. |
|
Nome do plano de serviço
|
servicePlanName | string |
O nome do plano de serviço para a entidade Cloud PC que é cliente ace. |
|
estado
|
status | string |
estado |
|
Nome principal do usuário
|
userPrincipalName | string |
O nome principal do utilizador (UPN) do utilizador atribuído ao PC na Cloud. |
|
Data/hora da última modificação
|
lastModifiedDateTime | string |
A última data e hora modificadas do Cloud PC. O tipo de carimbo temporal representa informação de data e hora usando o formato ISO 8601 e está sempre em UTC. |
|
ID de dispositivo gerido
|
managedDeviceId | string |
O ID de dispositivo inscrito no Intune para o Cloud PC consiste em 32 caracteres num formato GUID. |
|
Nome do dispositivo gerido
|
managedDeviceName | string |
O nome do dispositivo inscrito no Intune para o PC na nuvem. |
|
Data/hora de término do período de carência
|
gracePeriodEndDateTime | string |
A data e hora em que o período de carência termina e ocorre o reabastecimento ou desprovisionamento. |
|
Estado da encriptação do disco
|
diskEncryptionState | string |
Estado da encriptação do disco |
|
Tipo de aprovisionamento
|
provisioningType | string |
O tipo de licenças a utilizar ao provisionar PCs Cloud com esta política. |
|
Nome de exibição do lote
|
allotmentDisplayName | string |
Nome de exibição do lote |
|
Detalhe de estado
|
statusDetail | string |
Detalhe de estado |
|
Habilitar logon único
|
connectionSetting.enableSingleSignOn | boolean |
Habilitar logon único |
|
partnerAgentInstallResults
|
partnerAgentInstallResults | array of string |
partnerAgentInstallResults |
Criar uma política de provisionamento
Cria uma política de provisionamento.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
Nome
|
displayName | True | string |
nome de exibição |
|
Description
|
description | True | string |
descrição |
|
domainJoinType
|
domainJoinType | string | ||
|
tipo
|
type | string | ||
|
nome_da_região
|
regionName | string | ||
|
onPremisesConnectionId
|
onPremisesConnectionId | string | ||
|
Região Grupo
|
regionGroup | string | ||
|
Outras áreas
|
otherFields | object |
Outros domínios |
|
|
Habilitar logon único
|
enableSingleSignOn | boolean |
enableSingleSignOn |
|
|
ID da imagem
|
imageId | True | string |
imageId |
|
Nome de visualização da imagem
|
imageDisplayName | True | string |
imageDisplayName |
|
Tipo de imagem
|
imageType | True | string |
Tipo de imagem |
|
Tipo de aprovisionamento
|
provisioningType | True | string |
provisioningType |
|
Localidade
|
locale | True | string |
região |
|
Tipo Gerido
|
managedType | string |
managedType |
|
|
Profile
|
profile | string |
perfil |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
id
|
id | string |
id |
|
Nome de exibição
|
displayName | string |
O nome de exibição da política de provisionamento. |
|
Description
|
description | string |
A descrição da política de provisionamento. |
|
ID da imagem
|
imageId | string |
O ID da imagem do sistema operativo que pretende provisionar nos PCs Cloud. |
|
Nome de visualização da imagem
|
imageDisplayName | string |
O nome de exibição da imagem do sistema operativo que estás a provisionar. |
|
Tipo de imagem
|
imageType | string |
O tipo de imagem do sistema operativo (personalizada ou de galeria) que queres provisionar em PCs na Cloud. |
|
Habilitar logon único
|
enableSingleSignOn | boolean |
Especifica se a política de provisionamento ativou SSO para PCs Cloud. |
|
Modelo de nomeação de PC na nuvem
|
cloudPcNamingTemplate | string |
O modelo usado para nomear os PCs Cloud era provisionado através desta política. |
|
Tipo de aprovisionamento
|
provisioningType | string |
Especifica o tipo de licença utilizado ao provisionar PCs Cloud usando esta política. |
|
managedBy
|
managedBy | string |
managedBy |
|
ScopeIds
|
scopeIds | array of |
ScopeIds |
|
Definições do Autopatch
|
autopatch | string |
Indica as definições do Windows Autopatch para PCs na nuvem usando esta política de provisionamento. |
|
autopilotConfiguração
|
autopilotConfiguration | string |
autopilotConfiguração |
|
domainJoinConfigurations
|
domainJoinConfigurations | array of object |
domainJoinConfigurations |
|
domainJoinType
|
domainJoinConfigurations.domainJoinType | string |
domainJoinType |
|
tipo
|
domainJoinConfigurations.type | string |
tipo |
|
nome_da_região
|
domainJoinConfigurations.regionName | string |
nome_da_região |
|
onPremisesConnectionId
|
domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
Região Grupo
|
domainJoinConfigurations.regionGroup | string |
Região Grupo |
|
managedType
|
microsoftManagedDesktop.managedType | string |
managedType |
|
tipo
|
microsoftManagedDesktop.type | string |
tipo |
|
perfil
|
microsoftManagedDesktop.profile | string |
perfil |
|
região
|
windowsSetting.locale | string |
região |
|
linguagem
|
windowsSettings.language | string |
linguagem |
Eliminar uma política de provisionamento
Elimina uma política de provisionamento.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
ID da política de provisão
|
id | True | string |
id |
Enviar um pedido HTTP Microsoft Graph (Pré-visualização)
Construir um pedido de API REST para Microsoft Graph
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
O URI completo ou relativo. Exemplo: |
|
Método
|
Method | True | string |
O método HTTP (o padrão é GET) |
|
Body
|
Body | binary |
O conteúdo do corpo da solicitação |
|
|
Tipo de conteúdo
|
ContentType | string |
O cabeçalho do tipo de conteúdo para o corpo (o padrão é application/json) |
|
|
CustomHeader1
|
CustomHeader1 | string |
Cabeçalho personalizado 1. Especificar em formato: header-name: header-value |
|
|
CustomHeader2
|
CustomHeader2 | string |
Cabeçalho personalizado 2. Especificar em formato: header-name: header-value |
|
|
CustomHeader3
|
CustomHeader3 | string |
Cabeçalho personalizado 3. Especificar em formato: header-name: header-value |
|
|
CustomHeader4
|
CustomHeader4 | string |
Cabeçalho personalizado 4. Especificar em formato: header-name: header-value |
|
|
CustomHeader5
|
CustomHeader5 | string |
Cabeçalho personalizado 5. Especificar em formato: header-name: header-value |
Regressos
- response
- ObjectWithoutType
Iniciar uma ação remota
Inicia uma ação remota num PC na Cloud.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
Cloud PC ID
|
cloudPcId | True | string |
O identificador único do Cloud PC. |
|
Ação remota
|
remoteAction | True | string |
A ação remota a realizar no PC na Cloud. |
|
Cloud PC snapshot Id
|
cloudPcSnapshotId | string |
Necessária para restauro |
|
|
Nome de exibição
|
displayName | string |
Obrigatório para mudança de nome |
Obtenha políticas de aprovisionamento
Recebe uma lista de políticas de provisionamento.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
Selecionar
|
$select | string |
Devolve propriedades padrão se não especificadas; A primeira opção devolve todas as propriedades. |
|
|
Filter
|
$filter | string |
Filtra os itens pelo valor das propriedades. |
|
|
Expandir
|
$expand | string |
Expande entidades relacionadas em linha. |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
valor
|
value | array of object |
valor |
|
assignments
|
value.assignments | array of object | |
|
items
|
value.assignments | object | |
|
Description
|
value.description | string |
A descrição da política de provisionamento. |
|
Nome de exibição
|
value.displayName | string |
O nome de exibição da política de provisionamento. |
|
Configurações de união de domínio
|
value.domainJoinConfigurations | array of object |
Especifica uma lista ordenada por prioridade sobre como os PCs Cloud se juntam ao Microsoft Entra ID. |
|
onPremisesConnectionId
|
value.domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
tipo
|
value.domainJoinConfigurations.type | string |
tipo |
|
managedType
|
value.microsoftManagedDesktop.managedType | string |
managedType |
|
perfil
|
value.microsoftManagedDesktop.profile | string |
perfil |
|
autopatchGroupId
|
value.autopatch.autopatchGroupId | string |
autopatchGroupId |
|
devicePreparationProfileId
|
value.autopilotConfiguration.devicePreparationProfileId | string |
devicePreparationProfileId |
|
applicationTimeOutInMinutes
|
value.autopilotConfiguration.applicationTimeoutInMinutes | integer |
applicationTimeOutInMinutes |
|
onFailureDeviceAccessDenied
|
value.autopilotConfiguration.onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
Habilitar logon único
|
value.enableSingleSignOn | boolean |
Especifica se a política de provisionamento ativou SSO para PCs Cloud. |
|
Id
|
value.id | string |
id |
|
Nome de visualização da imagem
|
value.imageDisplayName | string |
O nome de exibição da imagem do sistema operativo que estás a provisionar. |
|
ID da imagem
|
value.imageId | string |
O ID da imagem do sistema operativo que pretende provisionar nos PCs Cloud. |
|
Tipo de imagem
|
value.imageType | string |
O tipo de imagem do sistema operativo (personalizada ou de galeria) que queres provisionar em PCs na Cloud. |
|
região
|
value.windowsSetting.locale | string |
região |
|
managedBy
|
value.managedBy | string |
managedBy |
|
Tipo de aprovisionamento
|
value.provisioningType | string |
Especifica o tipo de licença utilizado ao provisionar PCs Cloud usando esta política. |
Obtenha uma política de provisionamento
Recebe uma política de aprovisionamento específica.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
ID da política de provisão
|
id | True | string |
id |
|
Selecionar
|
$select | string |
Devolve propriedades padrão se não especificadas; A primeira opção devolve todas as propriedades. |
|
|
Expandir
|
$expand | string |
Expande entidades relacionadas em linha. |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
assignments
|
assignments | array of object | |
|
items
|
assignments | object | |
|
Description
|
description | string |
A descrição da política de provisionamento. |
|
Nome de exibição
|
displayName | string |
O nome de exibição da política de provisionamento. |
|
Configurações de união de domínio
|
domainJoinConfigurations | array of object |
Especifica uma lista ordenada por prioridade sobre como os PCs Cloud se juntam ao Microsoft Entra ID. |
|
onPremisesConnectionId
|
domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
tipo
|
domainJoinConfigurations.type | string |
tipo |
|
managedType
|
microsoftManagedDesktop.managedType | string |
managedType |
|
perfil
|
microsoftManagedDesktop.profile | string |
perfil |
|
autopatchGroupId
|
autopatch.autopatchGroupId | string |
autopatchGroupId |
|
devicePreparationProfileId
|
autopilotConfiguration.devicePreparationProfileId | string |
devicePreparationProfileId |
|
applicationTimeOutInMinutes
|
autopilotConfiguration.applicationTimeoutInMinutes | integer |
applicationTimeOutInMinutes |
|
onFailureDeviceAccessDenied
|
autopilotConfiguration.onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
Habilitar logon único
|
enableSingleSignOn | boolean |
Especifica se a política de provisionamento ativou SSO para PCs Cloud. |
|
Id
|
id | string |
id |
|
Nome de visualização da imagem
|
imageDisplayName | string |
O nome de exibição da imagem do sistema operativo que estás a provisionar. |
|
ID da imagem
|
imageId | string |
O ID da imagem do sistema operativo que pretende provisionar nos PCs Cloud. |
|
Tipo de imagem
|
imageType | string |
O tipo de imagem do sistema operativo (personalizada ou de galeria) que queres provisionar em PCs na Cloud. |
|
região
|
windowsSetting.locale | string |
região |
|
managedBy
|
managedBy | string |
managedBy |
|
Tipo de aprovisionamento
|
provisioningType | string |
Especifica o tipo de licença utilizado ao provisionar PCs Cloud usando esta política. |
PCs Cloud de Lista
Lista CloudPCs
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
Selecionar
|
$select | string |
Selecione propriedades a serem devolvidas. |
|
|
Filter
|
$filter | string |
Ex. provisioningPolicyName eq 'XXX' e userPrincipalName eq 'XXX' |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
ID
|
id | string |
O identificador único da entidade Cloud PC voltada para o cliente, que consiste em 32 caracteres num formato GUID. |
|
ID do dispositivo Entra
|
aadDeviceId | string |
O ID de dispositivo Microsoft Entra para o PC na Cloud, também conhecido como ID de dispositivo Azure Active Directory (Azure AD), consiste em 32 caracteres num formato GUID. Gerado numa VM ligada ao Microsoft Entra ID. Somente leitura. |
|
Nome de exibição
|
displayName | string |
O nome de exibição para o Cloud PC. O comprimento máximo é de 64 caracteres. Somente leitura. |
|
Nome de visualização da imagem
|
imageDisplayName | string |
O nome da imagem do sistema operativo usada para o PC na Cloud. O comprimento máximo é de 50 caracteres. |
|
ID da política de provisão
|
provisioningPolicyId | string |
O ID da política de provisão para o Cloud PC consiste em 32 caracteres em formato GUID. Uma política define o tipo de PC Cloud que o utilizador pretende criar. |
|
Nome da política de aprovisionamento
|
provisioningPolicyName | string |
A política de provisionamento que se aplicava durante o provisionamento dos PCs Cloud. |
|
Nome da ligação on-premises
|
onPremisesConnectionName | string |
A ligação de rede Azure aplicada durante o provisionamento dos PCs Cloud. |
|
ID do plano de serviço
|
servicePlanId | string |
O ID do plano de serviço para o Cloud PC consiste em 32 caracteres em formato GUID. |
|
Nome do plano de serviço
|
servicePlanName | string |
O nome do plano de serviço para a entidade Cloud PC que é cliente ace. |
|
estado
|
status | string |
estado |
|
Nome principal do usuário
|
userPrincipalName | string |
O nome principal do utilizador (UPN) do utilizador atribuído ao PC na Cloud. |
|
Data/hora da última modificação
|
lastModifiedDateTime | string |
A última data e hora modificadas do Cloud PC. O tipo de carimbo temporal representa informação de data e hora usando o formato ISO 8601 e está sempre em UTC. |
|
ID de dispositivo gerido
|
managedDeviceId | string |
O ID de dispositivo inscrito no Intune para o Cloud PC consiste em 32 caracteres num formato GUID. |
|
Nome do dispositivo gerido
|
managedDeviceName | string |
O nome do dispositivo inscrito no Intune para o PC na nuvem. |
|
Data/hora de término do período de carência
|
gracePeriodEndDateTime | string |
A data e hora em que o período de carência termina e ocorre o reabastecimento ou desprovisionamento. |
|
Estado da encriptação do disco
|
diskEncryptionState | string |
Estado da encriptação do disco |
|
Tipo de aprovisionamento
|
provisioningType | string |
O tipo de licenças a utilizar ao provisionar PCs Cloud com esta política. |
|
Nome de exibição do lote
|
allotmentDisplayName | string |
Nome de exibição do lote |
|
Detalhe de estado
|
statusDetail | string |
Detalhe de estado |
|
Habilitar logon único
|
connectionSetting.enableSingleSignOn | boolean |
Especifica se a política de provisionamento ativou SSO para PCs Cloud. |
|
partnerAgentInstallResults
|
partnerAgentInstallResults | array of string |
partnerAgentInstallResults |
Gatilhos
| Quando uma política de provisionamento ou um PC na nuvem é atualizado |
Quando uma política de provisionamento ou um PC na nuvem é atualizado |
Quando uma política de provisionamento ou um PC na nuvem é atualizado
Quando uma política de provisionamento ou um PC na nuvem é atualizado
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
cenário
|
scenario | True | string |
cenário |