Windows 365 (versão prévia)

Windows 365 é um serviço baseado em nuvem que cria automaticamente um novo tipo de Windows máquina virtual (PCs de nuvem) para os usuários finais. Cada PC na nuvem é atribuído a um usuário individual como um dispositivo Windows dedicado. Windows 365 fornece os benefícios de produtividade, segurança e colaboração de Microsoft 365.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Azure Governamental regiões
     - Azure regiões da China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – 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
Publicador Microsoft
Site 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
Serviço Classe Regiões
Copilot Studio Premium Todas as regiões Power Automate
Aplicativos Lógicos Premium Todas as regiões de Aplicativos Lógicos
Power Apps Premium Todas as regiões Power Apps
Power Automate Premium Todas as regiões Power Automate
Contato
Nome Windows 365
URL https://learn.microsoft.com/en-us/connectors/windows365
Email W365powerplatform@microsoft.com

Problemas e limitações conhecidos

O conector Windows 365 está atualmente em Visualização Pública.

A Microsoft visa garantir que um conector esteja estável antes de liberá-lo para disponibilidade geral. Até esse momento, o conector está em versão preliminar. As versões preliminares são fornecidas "no estado em que se encontram", "com todos os defeitos" e "conforme disponíveis". Elas são excluídas dos SLAs (contratos de nível de serviço), mas são disponibilizadas em uma versão preliminar para que você possa obter acesso antecipado e fornecer comentários. Saiba mais sobre os recursos das versões preliminares e como habilitá-las As pré-visualizações poderiam não ser cobertas pelo suporte ao cliente. Elas podem ser descontinuados a qualquer momento sem aviso prévio e podem não ser liberadas para disponibilidade geral.

Incentivamos você a experimentar os conectores em versão preliminar e fornecer feedback. Isso nos ajudará a estabilizar e melhorar os conectores. Você pode usar os fóruns de produto para compartilhar problemas e comentários. O suporte da Microsoft talvez não esteja disponível para recursos das versões preliminares, incluindo conectores, mas tentaremos fornecer suporte da melhor maneira possível.

Para saber mais, visite os Conectores em perguntas frequentes sobre a versão prévia.

Limites gerais

  1. Os recursos e as limitações são consistentes com o API do Graph subjacente.
  2. Ao precisar chamar algo no ponto de extremidade beta do Graph, use a ação de solicitação HTTP.

Ações:

Listar PCs na Cloud

ID da operação: ListCloudPCs

Essa ação permite listar computadores na nuvem.

Parâmetros

Nome Obrigatório Tipo Description
$select Não cadeia $select permite que você escolha quais propriedades são retornadas do Graph.
$filter Não cadeia $filter permite que você obtenha um subconjunto just de uma coleção do Graph.

Retorna

Nome Tipo Description
aadDeviceId String A ID do dispositivo Microsoft Entra para o PC na nuvem, também conhecida como ID do dispositivo Azure Active Directory (Azure AD), que consiste em 32 caracteres em um formato GUID. Gerado em uma VM ingressada no Microsoft Entra ID. Somente leitura.
diskEncryptionState String Mostra o estado de criptografia de disco.
nome de exibição String O nome a apresentar para o PC na Cloud. O comprimento máximo é de 64 caracteres. Somente leitura.
gracePeriodEndDateTime DateTimeOffset A data e hora em que o período de tolerância termina e o reaprovisionamento ou o desaprovisionamento ocorrem. Necessário somente 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 a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
id String O identificador exclusivo da entidade do CLOUD PC destinado ao cliente que consiste em 32 carateres num formato GUID. Somente leitura.
imageDisplayName String O nome da imagem do sistema operativo utilizada para o PC na Cloud. O comprimento máximo é de 50 carateres. Só são permitidas letras (A-Z, a-z), números (0-9) e carateres especiais (-,_,.) para esta propriedade. O valor da propriedade não pode começar ou terminar com um caráter de sublinhado. Somente leitura.
lastModifiedDateTime DateTimeOffset A data e hora da última modificação do CLOUD PC. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
managedDeviceId String O Intune ID do dispositivo inscrito para o CLOUD PC que consiste em 32 carateres num formato GUID. A propriedade managedDeviceId de Windows 365 Business Cloud PCs é sempre nula, pois os PCs de nuvem Windows 365 Business não são registrados automaticamente pelo Intune por Windows 365. Somente leitura.
managedDeviceName String O Intune nome do dispositivo inscrito para o CLOUD PC. A propriedade managedDeviceName dos PCs na nuvem do Windows 365 Business é sempre nula, pois os PCs na nuvem do Windows 365 Business não são registrados automaticamente no Intune pelo Windows 365. Somente leitura.
onPremisesConnectionName String A ligação no local que foi aplicada durante o aprovisionamento de PCs na Cloud. Somente leitura.
provisioningPolicyId String O ID da política de aprovisionamento para o PC na Cloud que consiste em 32 carateres num formato GUID. Uma política define o tipo de PC na Cloud que o utilizador quer criar. Somente leitura.
provisioningPolicyName String A política de aprovisionamento aplicada durante o aprovisionamento de PCs na Cloud. O comprimento máximo é de 120 carateres. Somente leitura.
provisioningType String Mostra o tipo de provisionamento.
servicePlanId String O ID do plano de serviço para o CLOUD PC que consiste em 32 carateres num formato GUID. Para obter mais informações sobre planos de serviço, consulte Nomes de produtos e identificadores de plano de serviço para licenciamento. Somente leitura.
servicePlanName String O nome do plano de serviço para a entidade do CLOUD PC destinada ao cliente. Somente leitura.
servicePlanType String Mostra o tipo de plano.
userPrincipalName String O nome principal de utilizador (UPN) do utilizador atribuído ao CLOUD PC. O comprimento máximo é de 113 carateres. Para obter mais informações sobre políticas de nome de usuário, consulte Políticas de senha e restrições de conta no Microsoft Entra ID. Somente leitura.

Obter políticas de provisionamento

ID da operação: GetProvisioningPoliciesV1

Essa ação permite que você retorne informações sobre as políticas de provisionamento.

Parâmetros

Nome Obrigatório Tipo Description
$select Não String $select permite que você escolha quais propriedades são retornadas do Graph.
$filter Não String $filter permite que você obtenha um subconjunto just de uma coleção do Graph.
$expand Não String $expand permite que você retorne recursos relacionados do Graph.

Retorna

Use $expand com um valor de atribuições para ver os valores retornados abaixo:

Nome Tipo Description
cloudPCNamingTemplate String O modelo utilizado para atribuir o nome PCs cloud aprovisionados com esta 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 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 os 15 carateres.
description String A descrição da política de aprovisionamento.
nome de exibição String O nome a apresentar da política de aprovisionamento.
domainJoinConfiguration coleção cloudPcDomainJoinConfiguration Especifica uma lista ordenada por prioridade sobre como os PCs de nuvem ingressam Microsoft Entra ID (Azure AD).
enableSingleSignOn booleano 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 se autenticar em Microsoft Entra ID com opções sem senha (por exemplo, chaves FIDO) para acessar seu pc na nuvem
id String O identificador exclusivo associado à política de aprovisionamento. Este ID é preenchido automaticamente durante a criação de uma nova política de aprovisionamento. Somente leitura.
imageDisplayName String O nome a apresentar da imagem do sistema operativo utilizada para o aprovisionamento. Por exemplo, Windows 11 Versão Prévia + Microsoft 365 Apps 23H2 23H2.
imageId String O identificador exclusivo que representa uma imagem do sistema operativo que é utilizada para aprovisionar novos PCs na Cloud. O formato de uma imagem de tipo de galeria é: {publisherName_offerName_skuName}. Os valores com suporte para cada um dos parâmetros são:
  • publisher: Microsoftwindowsdesktop
  • offer: 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
imageType cloudPcProvisioningPolicyImageType O tipo de imagem do sistema operativo (personalizada ou galeria) utilizada para o aprovisionamento em PCs na Cloud. Os valores possíveis são: galeria, personalizado. O valor padrão é a galeria.

Obter uma política de provisionamento

ID da operação: GetAProvisioningPolicyV1

Essa ação permite que você obtenha os detalhes de uma política de provisionamento específica.

Parâmetros

Nome Obrigatório Tipo Description
ID da política de provisionamento Yes String A ID da política de provisionamento. Deve ser incluído.
$select Não String $select permite que você escolha quais propriedades são retornadas do Graph.
$filter Não String $filter permite que você obtenha um subconjunto just de uma coleção do Graph.

Retorna

As saídas desta operação são dinâmicas.

Criar uma política de provisionamento

ID da operação: CreateAProvisioningPolicyV1

Essa ação permite que você crie uma política de provisionamento.

Parâmetros

Nome Obrigatório Tipo Description
Name Yes String A política de aprovisionamento aplicada durante o aprovisionamento de PCs na Cloud. O comprimento máximo é de 120 caracteres
Descrição Yes String A descrição da política de aprovisionamento.
Configuração de ingresso no domínio Yes
ID da imagem Yes String Esta é a ID de imagem que você deseja usar para provisionar computadores na nuvem.
Nome de exibição da imagem Yes String O nome da imagem do sistema operativo utilizada para o PC na Cloud. O comprimento máximo é de 50 carateres. Só são permitidas letras (A-Z, a-z), números (0-9) e carateres especiais (-,_,.) para esta propriedade. O valor da propriedade não pode começar ou terminar com um caráter de sublinhado.
Tipo de imagem Yes String Personalizado ou Galeria.
Tipo de provisionamento Yes String Compartilhado ou dedicado.
Windows configuração/localidade Yes String Forneça o idioma/localidade que você gostaria de usar. Windows 365 fornece mais de 30 desses pares de idiomas/região.

Você também pode adicionar outros campos do Graph em parâmetros avançados.

Retorna

As saídas desta operação são dinâmicas.

Atribuir uma política de provisionamento a um grupo

ID da operação: AssignAProvisioningPolicyToAGroupV1

Essa ação permite que você atribua um grupo a uma política de provisionamento.

Parâmetros

Nome Obrigatório Tipo Description
ID da política de provisionamento Yes String Essa é a ID da política de provisionamento à qual você gostaria de atribuir um grupo.
Atribuições – ID
Atribuições – ID do grupo de destino Yes String Grupo de usuários da ID do Entra.

Retorna

As saídas desta operação são dinâmicas.

Atualizar uma política de provisionamento

ID da operação: UpdateAProvisioningPolicyV1

Essa ação permite que você atualize uma política de provisionamento.

Parâmetros

Nome Obrigatório Tipo Description
ID da política de provisionamento Yes String Essa é a ID da política de provisionamento que você deseja atualizar.
Descrição Não String É para isso que a descrição da política de provisionamento será atualizada.

Você também pode adicionar outros campos do Graph em parâmetros avançados.

Retorna

As saídas desta operação são dinâmicas.

Obter uma política de provisionamento

ID da operação: GetAProvisioningPolicyV1

Essa ação permite que você obtenha os detalhes de uma política de provisionamento.

Parâmetros

Nome Obrigatório Tipo Description
ID da política de provisionamento Yes String O ID da política de aprovisionamento para o PC na Cloud que consiste em 32 carateres num formato GUID. Uma política define o tipo de PC na Cloud que o utilizador quer criar.
$select Não String $select permite que você escolha quais propriedades são retornadas do Graph.
$expand Não String $expand permite que você retorne recursos relacionados do Graph.

Você também pode adicionar outros campos do Graph em parâmetros avançados.

Retorna

As saídas desta operação são dinâmicas.

Iniciar uma ação remota

ID da operação: RemoteActions

Essa ação permite que você inicie uma ação remota em um PC na nuvem.

Parâmetros

Nome Obrigatório Tipo Description
ID do PC na nuvem Yes String Isso permite que você especifique qual ID de pc de nuvem você deseja direcionar com uma ação remota.
Ação remota Yes String Isso permite que você escolha quando uma ação remota deseja realizar em um PC na nuvem.
Ação remota – ID do instantâneo Não String Se você estiver optando por restaurar um PC na nuvem, também deverá fornecer uma ID de instantâneo.
Ação remota – Nome de exibição Não String Se você estiver optando por renomear um PC na nuvem, também deverá fornecer um nome de exibição.

Retorna

Se tiver êxito, isso retornará um código de resposta 204 Sem Conteúdo.

Enviar uma solicitação HTTP Microsoft Graph

ID da operação: HttpRequest

Essa ação permite que você chame o Graph diretamente e personalize a chamada.

Parâmetros

Nome Obrigatório Tipo Description
URI Yes String Isso permite que você especifique qual URI chamar, por exemplo: https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents
Método Yes String Isso permite que você defina o método de chamada.

Você também pode adicionar outros campos (cabeçalhos, corpo etc.) em parâmetros avançados.

Retorna

As saídas desta operação são dinâmicas.

Gatilhos:

Todos os cenários fazem parte de um gatilho, que é selecionável no próprio corpo do gatilho.

Quando uma ação remota em um PC na nuvem é disparada Permite disparar um fluxo quando uma ação remota é disparada.
Quando uma ação remota em um PC na nuvem é concluída Permite disparar um fluxo quando uma ação remota em um PC de nuvem for concluída.
Quando uma política de provisionamento é atualizada Permite disparar um fluxo quando uma política de provisionamento é atualizada
Quando uma nova política de provisionamento é criada Permite iniciar um fluxo quando uma política de provisionamento é criada.
Quando um PC na nuvem é criado Esse gatilho permite que você inicie um fluxo quando um PC na nuvem é criado.

Quando uma política de provisionamento ou pc de nuvem é atualizada

ID da operação: Webhook

Esse gatilho é acionado quando uma política de provisionamento ou pc na nuvem é atualizada.

Parâmetros

Nome Obrigatório Tipo Description
Cenário Yes Lista suspensa Você pode escolher entre os cenários com suporte:
  1. Quando um PC na nuvem é criado
  2. Quando uma nova política de provisionamento é criada
  3. Quando uma política de provisionamento é atualizada
  4. Quando uma ação remota em um PC na nuvem é concluída
  5. Quando uma ação remota em um PC na nuvem é disparada

Retorna

As saídas desta operação são dinâmicas.

Atualizações de documentos do 15/9:

  1. Adicione o gatilho "preterido" ao título de "Quando uma política de provisionamento ou pc de nuvem é atualizado (preterido)"
  2. Adicione abaixo de sua seção: "Esse gatilho pode continuar a ser usado para fluxos existentes, mas não haverá novas atualizações para ele no futuro. É recomendável usar os novos gatilhos."
  3. Adicione novos documentos para novos gatilhos da seguinte maneira:

Quando uma nova política de provisionamento é criada

ID da operação: WebhookProvisioningPolicyCreated

Parâmetros:

Nome Obrigatório Tipo Description
Nome da política de provisionamento de filtro Não String Isso permite que você defina filtros se quiser disparar o fluxo com base em um padrão de nome de política. Por exemplo, se sua organização usa modelos de nome de política de provisionamento e você deseja disparar seu fluxo com base nisso, você pode especificar o modelo aqui.
Filtrar a ID da política de provisionamento Não String Isso permite que você selecione uma única ou várias IDs de política específicas nas quais disparar esse fluxo.
Tipo de provisionamento de filtro Não String Isso permite que você selecione um único ou vários tipos de provisionamento específicos nos quais disparar esse fluxo. Por exemplo, talvez você queira disparar um fluxo apenas para Windows 365 Enterprise políticas de provisionamento.

Retorna

As saídas desta operação são dinâmicas.

Quando um PC na nuvem é criado

ID da operação: WebhookCloudPcProvisioned

Esse gatilho permite disparar um fluxo com base em quando um PC na nuvem é criado.

Parâmetros

Nome Obrigatório Tipo Description
Tipo de provisionamento de filtro Não String Isso permite que você especifique qual edição Windows 365 dispara esse fluxo. Você pode especificar vários tipos no filtro em uma relação "OR".

Retorna

As saídas desta operação são dinâmicas.

Quando uma política de provisionamento é atualizada

ID da operação: WebhookProvisioningPolicyUpdated

Esse gatilho permite disparar um fluxo com base em quando uma política de provisionamento é atualizada.

Parâmetros

Nome Obrigatório Tipo Description
Nome da política de provisionamento de filtro Não String Isso permite que você selecione um único ou vários nomes de política específicos nos quais disparar esse fluxo.
Filtrar a ID da política de provisionamento Não String Isso permite que você selecione uma única ou várias IDs de política específicas nas quais disparar esse fluxo.
Tipo de provisionamento de filtro Não String Isso permite que você selecione um único ou vários tipos de provisionamento específicos nos quais disparar esse fluxo. Por exemplo, talvez você queira disparar um fluxo apenas para Windows 365 Enterprise políticas de provisionamento.

Retorna

Nome Tipo Description
provisioningPolicyId String A ID da política de provisionamento que foi atualizada. Consiste em 32 caracteres em um formato GUID.
provisioningPolicyName String O nome da política de provisionamento que foi atualizado.

Quando uma ação remota em um PC na nuvem é disparada

ID da operação: WebhookCloudPcRemoteActionTriggered

Esse gatilho permite disparar um fluxo com base em quando uma ação remota em um PC na nuvem é disparada.

Parâmetros

Nome Obrigatório Tipo Description
Tipo de provisionamento de filtro Não String Isso permite que você selecione um único ou vários tipos de provisionamento específicos nos quais disparar esse fluxo. Por exemplo, talvez você queira disparar um fluxo de ação remota apenas para computadores de nuvem relacionados a políticas de provisionamento Windows 365 Enterprise.

Retorna

Nome Tipo Description
CloudPcId String A ID do PC na nuvem que teve sua ação remota concluída.
provisioningType String O tipo de provisionamento, que mostra o Windows 365 cloud pc edition.
actionType String O tipo de ação remota, por exemplo, uma reinicialização.

Quando uma ação remota em um PC na nuvem é concluída

ID da operação: Webhook.CloudPC.ActionCompleted

Esse gatilho permite disparar um fluxo com base em quando uma ação remota em um PC na nuvem é concluída.

Parâmetros

Nome Obrigatório Tipo Description
Tipo de provisionamento de filtro Não String Isso permite que você selecione um único ou vários tipos de provisionamento específicos nos quais disparar esse fluxo. Por exemplo, talvez você queira disparar um fluxo de ação remota apenas para computadores de nuvem relacionados a políticas de provisionamento Windows 365 Enterprise.

Retorna

Nome Tipo Description
CloudPcId String A ID do PC na nuvem que teve sua ação remota concluída.
provisioningType String O tipo de provisionamento, que mostra o Windows 365 cloud pc edition.
actionType String O tipo de ação remota, por exemplo, uma reinicialização.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Atribuir uma política de provisionamento a um grupo

Atribua uma política de provisionamento a um grupo.
Atualizar uma política de provisionamento

Atualiza uma política de provisionamento.
Criar uma política de provisionamento

Cria uma política de provisionamento.
Enviar uma solicitação HTTP Microsoft Graph (versão prévia)

Construir uma solicitação de API REST Microsoft Graph
Excluir uma política de provisionamento

Exclui uma política de provisionamento.
Iniciar uma ação remota

Inicie uma ação remota em um computador na nuvem.
Listar PCs na Cloud

Listar CloudPCs
Obter políticas de provisionamento

Obtém uma lista de políticas de provisionamento.
Obter um computador na nuvem

Obtém um PC na nuvem
Obter uma política de provisionamento

Obtém uma política de provisionamento específica.

Atribuir uma política de provisionamento a um grupo

ID da operação:
AssignAProvisioningPolicyToAGroupV1

Atribua uma política de provisionamento a um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da política de provisionamento
 id True string

id
ID da política de provisionamento
 id string

Esta é a ID da política de provisionamento à qual você gostaria de atribuir um grupo
ID do grupo
 groupId True string

groupId
servicePlanId
 servicePlanId string

ID do ServicePlan de destino

Atualizar uma política de provisionamento

ID da operação:
UpdateAProvisioningPolicyV1

Atualiza uma política de provisionamento.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da política de provisionamento
 id True string

id
ID do grupo
 autopatchGroupId string

autopatchGroupId
ID do perfil de preparação do dispositivo
 devicePreparationProfileId string

devicePreparationProfileId
Tempo limite do aplicativo em minutos
 applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
Ao falhar, 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 conexão local
 onPremisesConnectionId string

onPremisesConnectionId
Grupo de regiões
 regionGroup string

regionGroup
Nome da região
 regionName string

regionName
Tipo
 type string

tipo
Habilitar logon único
 enableSingleSignOn boolean

enableSingleSignOn
Nome de exibição da imagem
 imageDisplayName string

imageDisplayName
ID da imagem
 imageId string

imageId
Tipo de Imagem
 imageType string

tipoDeImagem
Tipo gerenciado
 managedType string

managedType
Profile
 profile string

analisar
Local
 locale string

localidade
Outros Campos
 otherFields object

Outros campos

Criar uma política de provisionamento

ID da operação:
CreateAProvisioningPolicyV1

Cria uma política de provisionamento.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome
 displayName True string

nome de exibição
Description
 description True string

descrição
domainJoinType
 domainJoinType string
tipo
 type string
regionName
 regionName string
onPremisesConnectionId
 onPremisesConnectionId string
regionGroup
 regionGroup string
Outros Campos
 otherFields object

Outros campos
Habilitar logon único
 enableSingleSignOn boolean

enableSingleSignOn
ID da imagem
 imageId True string

imageId
Nome de exibição da imagem
 imageDisplayName True string

imageDisplayName
Tipo de Imagem
 imageType True string

tipoDeImagem
Tipo de provisionamento
 provisioningType True string

provisioningType
Local
 locale True string

localidade
Tipo Gerenciado
 managedType string

managedType
Profile
 profile string

analisar

Retornos

Nome Caminho Tipo Description
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 aprovisionamento.
ID da imagem
 imageId string

O ID da imagem do sistema operativo que pretende aprovisionar em PCs cloud.
Nome de exibição da imagem
 imageDisplayName string

O nome a apresentar da imagem do SO que está a aprovisionar.
Tipo de Imagem
 imageType string

O tipo de imagem do SO (personalizada ou galeria) que pretende aprovisionar em PCs cloud.
Habilitar logon único
 enableSingleSignOn boolean

Especifica se a política de provisionamento habilitou o SSO para computadores na nuvem.
Modelo de nomenclatura do PC na nuvem
 cloudPcNamingTemplate string

O modelo utilizado para atribuir o nome PCs cloud aprovisionados com esta política.
Tipo de provisionamento
 provisioningType string

Especifica o tipo de licença utilizado ao aprovisionar PCs na Cloud com esta política.
managedBy
 managedBy string

managedBy
scopeIds
 scopeIds array of

scopeIds
Configurações de autopatch
 autopatch string

Indica as configurações de Windows autopatch para computadores na nuvem usando essa política de provisionamento.
AutopilotConfiguration
 autopilotConfiguration string

AutopilotConfiguration
domainJoinConfigurations
 domainJoinConfigurations array of object

domainJoinConfigurations
domainJoinType
 domainJoinConfigurations.domainJoinType string

domainJoinType
tipo
 domainJoinConfigurations.type string

tipo
regionName
 domainJoinConfigurations.regionName string

regionName
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
regionGroup
 domainJoinConfigurations.regionGroup string

regionGroup
managedType
 microsoftManagedDesktop.managedType string

managedType
tipo
 microsoftManagedDesktop.type string

tipo
analisar
 microsoftManagedDesktop.profile string

analisar
localidade
 windowsSetting.locale string

localidade
linguagem
 windowsSettings.language string

linguagem

Enviar uma solicitação HTTP Microsoft Graph (versão prévia)

ID da operação:
HttpRequest

Construir uma solicitação de API REST Microsoft Graph

Parâmetros

Nome Chave Obrigatório Tipo Description
URI
 Uri True string

O URI completo ou relativo. Exemplo: https://graph.microsoft.com/{version}/{resource}
Método
 Method True string

O método HTTP (o padrão é GET)
Corpo
 Body binary

O conteúdo do corpo da solicitação
Tipo de conteúdo
 ContentType string

O cabeçalho de tipo de conteúdo para o corpo (o padrão é application/json)
CustomHeader1
 CustomHeader1 string

Cabeçalho personalizado 1. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader2
 CustomHeader2 string

Cabeçalho personalizado 2. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader3
 CustomHeader3 string

Cabeçalho personalizado 3. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader4
 CustomHeader4 string

Cabeçalho personalizado 4. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader5
 CustomHeader5 string

Cabeçalho personalizado 5. Especificar no formato: cabeçalho-nome: cabeçalho-valor

Retornos

response
ObjectWithoutType

Excluir uma política de provisionamento

ID da operação:
DeleteAProvisioningPolicyV1

Exclui uma política de provisionamento.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da política de provisionamento
 id True string

id

Iniciar uma ação remota

ID da operação:
RemoteActions

Inicie uma ação remota em um computador na nuvem.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do PC na nuvem
 cloudPcId True string

O identificador exclusivo do CLOUD PC.
Ação remota
 remoteAction True string

A ação remota a ser executada no PC na nuvem.
ID de instantâneo do PC na nuvem
 cloudPcSnapshotId string

Necessário para restauração
Nome de exibição
 displayName string

Necessário para renomear

Listar PCs na Cloud

ID da operação:
ListCloudPCs

Listar CloudPCs

Parâmetros

Nome Chave Obrigatório Tipo Description
Selecionar
 $select string

Selecione as propriedades a serem retornadas.
Filter
 $filter string

Ex.: provisioningPolicyName eq 'XXX' e userPrincipalName eq 'XXX'

Retornos

Nome Caminho Tipo Description
ID
 id string

O identificador exclusivo da entidade do CLOUD PC destinado ao cliente que consiste em 32 carateres num formato GUID.
ID do dispositivo Entra
 aadDeviceId string

A ID do dispositivo Microsoft Entra para o PC na nuvem, também conhecida como ID do dispositivo Azure Active Directory (Azure AD), que consiste em 32 caracteres em um formato GUID. Gerado em uma VM ingressada no Microsoft Entra ID. Somente leitura.
Nome de exibição
 displayName string

O nome a apresentar para o PC na Cloud. O comprimento máximo é de 64 caracteres. Somente leitura.
Nome de exibição da imagem
 imageDisplayName string

O nome da imagem do sistema operativo utilizada para o PC na Cloud. O comprimento máximo é de 50 carateres.
ID da política de provisionamento
 provisioningPolicyId string

O ID da política de aprovisionamento para o PC na Cloud que consiste em 32 carateres num formato GUID. Uma política define o tipo de PC na Cloud que o utilizador quer criar.
Nome da política de provisionamento
 provisioningPolicyName string

A política de aprovisionamento aplicada durante o aprovisionamento de PCs na Cloud.
Nome da conexão local
 onPremisesConnectionName string

O Azure conexão de rede aplicada durante o provisionamento de computadores na nuvem.
ID do plano de serviço
 servicePlanId string

O ID do plano de serviço para o CLOUD PC que consiste em 32 carateres num formato GUID.
Nome do plano de serviço
 servicePlanName string

O nome do plano de serviço para a entidade de PC na nuvem de acing do cliente.
status
 status string

status
Nome Principal do Usuário
 userPrincipalName string

O nome principal de utilizador (UPN) do utilizador atribuído ao CLOUD PC.
Data/hora da última modificação
 lastModifiedDateTime string

A data e hora da última modificação do CLOUD PC. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC.
ID do dispositivo gerenciado
 managedDeviceId string

O Intune ID do dispositivo inscrito para o CLOUD PC que consiste em 32 carateres num formato GUID.
Nome do dispositivo gerenciado
 managedDeviceName string

O Intune nome do dispositivo inscrito para o CLOUD PC.
Data/hora de término do período de carência
 gracePeriodEndDateTime string

A data e hora em que o período de tolerância termina e o reaprovisionamento ou o desaprovisionamento ocorrem.
Estado de criptografia de disco
 diskEncryptionState string

Estado de criptografia de disco
Tipo de provisionamento
 provisioningType string

O tipo de licenças a utilizar ao aprovisionar PCs na Cloud com esta política.
Nome de exibição de loteamento
 allotmentDisplayName string

Nome de exibição de loteamento
Detalhes do estado
 statusDetail string

Detalhes do estado
Habilitar logon único
 connectionSetting.enableSingleSignOn boolean

Especifica se a política de provisionamento habilitou o SSO para computadores na nuvem.
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

Obter políticas de provisionamento

ID da operação:
GetProvisioningPoliciesV1

Obtém uma lista de políticas de provisionamento.

Parâmetros

Nome Chave Obrigatório Tipo Description
Selecionar
 $select string

Retorna propriedades padrão se não for especificado; a primeira opção retorna todas as propriedades.
Filter
 $filter string

Filtrar itens por valores de propriedade.
Expanda
 $expand string

Expande entidades relacionadas embutidas.

Retornos

Nome Caminho Tipo Description
value
 value array of object

value
assignments
 value.assignments array of object
items
 value.assignments object
Description
 value.description string

A descrição da política de aprovisionamento.
Nome de exibição
 value.displayName string

O nome de exibição da política de provisionamento.
Configurações de ingresso no domínio
 value.domainJoinConfigurations array of object

Especifica uma lista ordenada por prioridade sobre como os PCs de nuvem se juntam Microsoft Entra ID.
onPremisesConnectionId
 value.domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
tipo
 value.domainJoinConfigurations.type string

tipo
managedType
 value.microsoftManagedDesktop.managedType string

managedType
analisar
 value.microsoftManagedDesktop.profile string

analisar
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 habilitou o SSO para computadores na nuvem.
ID
 value.id string

id
Nome de exibição da imagem
 value.imageDisplayName string

O nome a apresentar da imagem do SO que está a aprovisionar.
ID da imagem
 value.imageId string

O ID da imagem do sistema operativo que pretende aprovisionar em PCs cloud.
Tipo de Imagem
 value.imageType string

O tipo de imagem do SO (personalizada ou galeria) que pretende aprovisionar em PCs cloud.
localidade
 value.windowsSetting.locale string

localidade
managedBy
 value.managedBy string

managedBy
Tipo de provisionamento
 value.provisioningType string

Especifica o tipo de licença utilizado ao aprovisionar PCs na Cloud com esta política.

Obter um computador na nuvem

ID da operação:
GetACloudPCObject

Obtém um PC na nuvem

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do PC na nuvem
 cloudPcId True string

O identificador exclusivo do CLOUD PC.
Selecionar
 $select string

Selecione as propriedades a serem retornadas.

Retornos

Nome Caminho Tipo Description
ID
 id string

O identificador exclusivo da entidade do CLOUD PC destinado ao cliente que consiste em 32 carateres num formato GUID.
ID do dispositivo Entra
 aadDeviceId string

A ID do dispositivo Microsoft Entra para o PC na nuvem, também conhecida como ID do dispositivo Azure Active Directory (Azure AD), que consiste em 32 caracteres em um formato GUID. Gerado em uma VM ingressada no Microsoft Entra ID. Somente leitura.
Nome de exibição
 displayName string

O nome a apresentar para o PC na Cloud. O comprimento máximo é de 64 caracteres. Somente leitura.
Nome de exibição da imagem
 imageDisplayName string

O nome da imagem do sistema operativo utilizada para o PC na Cloud. O comprimento máximo é de 50 carateres.
ID da política de provisionamento
 provisioningPolicyId string

O ID da política de aprovisionamento para o PC na Cloud que consiste em 32 carateres num formato GUID. Uma política define o tipo de PC na Cloud que o utilizador quer criar.
Nome da política de provisionamento
 provisioningPolicyName string

A política de aprovisionamento aplicada durante o aprovisionamento de PCs na Cloud.
Nome da conexão local
 onPremisesConnectionName string

O Azure conexão de rede aplicada durante o provisionamento de computadores na nuvem.
ID do plano de serviço
 servicePlanId string

O ID do plano de serviço para o CLOUD PC que consiste em 32 carateres num formato GUID.
Nome do plano de serviço
 servicePlanName string

O nome do plano de serviço para a entidade de PC na nuvem de acing do cliente.
status
 status string

status
Nome Principal do Usuário
 userPrincipalName string

O nome principal de utilizador (UPN) do utilizador atribuído ao CLOUD PC.
Data/hora da última modificação
 lastModifiedDateTime string

A data e hora da última modificação do CLOUD PC. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC.
ID do dispositivo gerenciado
 managedDeviceId string

O Intune ID do dispositivo inscrito para o CLOUD PC que consiste em 32 carateres num formato GUID.
Nome do dispositivo gerenciado
 managedDeviceName string

O Intune nome do dispositivo inscrito para o CLOUD PC.
Data/hora de término do período de carência
 gracePeriodEndDateTime string

A data e hora em que o período de tolerância termina e o reaprovisionamento ou o desaprovisionamento ocorrem.
Estado de criptografia de disco
 diskEncryptionState string

Estado de criptografia de disco
Tipo de provisionamento
 provisioningType string

O tipo de licenças a utilizar ao aprovisionar PCs na Cloud com esta política.
Nome de exibição de loteamento
 allotmentDisplayName string

Nome de exibição de loteamento
Detalhes do estado
 statusDetail string

Detalhes do estado
Habilitar logon único
 connectionSetting.enableSingleSignOn boolean

Habilitar logon único
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

Obter uma política de provisionamento

ID da operação:
GetAProvisioningPolicyV1

Obtém uma política de provisionamento específica.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da política de provisionamento
 id True string

id
Selecionar
 $select string

Retorna propriedades padrão se não for especificado; a primeira opção retorna todas as propriedades.
Expanda
 $expand string

Expande entidades relacionadas embutidas.

Retornos

Nome Caminho Tipo Description
assignments
 assignments array of object
items
 assignments object
Description
 description string

A descrição da política de aprovisionamento.
Nome de exibição
 displayName string

O nome de exibição da política de provisionamento.
Configurações de ingresso no domínio
 domainJoinConfigurations array of object

Especifica uma lista ordenada por prioridade sobre como os PCs de nuvem se juntam Microsoft Entra ID.
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
tipo
 domainJoinConfigurations.type string

tipo
managedType
 microsoftManagedDesktop.managedType string

managedType
analisar
 microsoftManagedDesktop.profile string

analisar
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 habilitou o SSO para computadores na nuvem.
ID
 id string

id
Nome de exibição da imagem
 imageDisplayName string

O nome a apresentar da imagem do SO que está a aprovisionar.
ID da imagem
 imageId string

O ID da imagem do sistema operativo que pretende aprovisionar em PCs cloud.
Tipo de Imagem
 imageType string

O tipo de imagem do SO (personalizada ou galeria) que pretende aprovisionar em PCs cloud.
localidade
 windowsSetting.locale string

localidade
managedBy
 managedBy string

managedBy
Tipo de provisionamento
 provisioningType string

Especifica o tipo de licença utilizado ao aprovisionar PCs na Cloud com esta política.

Gatilhos

Quando um PC na nuvem é criado

Esse gatilho permite que você inicie um fluxo quando um PC na nuvem é criado.
Quando uma ação remota em um PC na nuvem é concluída

Permite disparar um fluxo quando uma ação remota em um PC de nuvem for concluída.
Quando uma ação remota em um PC na nuvem é disparada

Permite disparar um fluxo quando uma ação remota em um PC de nuvem for concluída.
Quando uma nova política de provisionamento é criada

Permite iniciar um fluxo quando uma política de provisionamento é criada.
Quando uma política de provisionamento ou PC na nuvem é atualizada (preterida) [PRETERIDA]

Quando uma política de provisionamento ou pc na nuvem é atualizada (preterida)
Quando uma política de provisionamento é atualizada

Permite disparar um fluxo quando uma política de provisionamento é atualizada

Quando um PC na nuvem é criado

ID da operação:
WebhookCloudPcProvisioned

Esse gatilho permite que você inicie um fluxo quando um PC na nuvem é criado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de provisionamento
 provisioningTypeNames array of string

Selecione um ou mais tipos de provisionamento.

Retornos

Nome Caminho Tipo Description
array of object
tenantId
 data.tenantId string

tenantId
categoria
 data.category string

categoria
ação
 data.action string

ação
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

Quando uma ação remota em um PC na nuvem é concluída

ID da operação:
WebhookCloudPcRemoteActionCompleted

Permite disparar um fluxo quando uma ação remota em um PC de nuvem for concluída.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de provisionamento
 provisioningTypeNames array of string

Selecione um ou mais tipos de provisionamento.

Retornos

Nome Caminho Tipo Description
array of object
tenantId
 data.tenantId string

tenantId
categoria
 data.category string

categoria
ação
 data.action string

ação
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

Quando uma ação remota em um PC na nuvem é disparada

ID da operação:
WebhookCloudPcRemoteActionTriggered

Permite disparar um fluxo quando uma ação remota em um PC de nuvem for concluída.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de provisionamento
 provisioningTypeNames array of string

Selecione um ou mais tipos de provisionamento.

Retornos

Nome Caminho Tipo Description
array of object
tenantId
 data.tenantId string

tenantId
categoria
 data.category string

categoria
ação
 data.action string

ação
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

Quando uma nova política de provisionamento é criada

ID da operação:
WebhookProvisioningPolicyCreated

Permite iniciar um fluxo quando uma política de provisionamento é criada.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da política de provisionamento
 provisioningPolicyNames array of string

Selecione uma política de provisionamento para monitorar atualizações.
ID da política de provisionamento
 provisioningPolicyIds array of string

Insira uma ou mais IDs de política de provisionamento.
Tipo de provisionamento
 provisioningTypeNames array of string

Selecione um ou mais tipos de provisionamento.

Retornos

Nome Caminho Tipo Description
array of object
tenantId
 data.tenantId string

tenantId
categoria
 data.category string

categoria
ação
 data.action string

ação
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

Quando uma política de provisionamento ou PC na nuvem é atualizada (preterida) [PRETERIDA]

ID da operação:
Webhook

Quando uma política de provisionamento ou pc na nuvem é atualizada (preterida)

Parâmetros

Nome Chave Obrigatório Tipo Description
cenário
 scenario True string

cenário

Quando uma política de provisionamento é atualizada

ID da operação:
WebhookProvisioningPolicyUpdated

Permite disparar um fluxo quando uma política de provisionamento é atualizada

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da política de provisionamento
 provisioningPolicyNames array of string

Selecione uma política de provisionamento para monitorar atualizações.
ID da política de provisionamento
 provisioningPolicyIds array of string

Insira uma ou mais IDs de política de provisionamento.
Tipo de provisionamento
 provisioningTypeNames array of string

Selecione um ou mais tipos de provisionamento.

Retornos

Nome Caminho Tipo Description
array of object
tenantId
 data.tenantId string

tenantId
categoria
 data.category string

categoria
ação
 data.action string

ação
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

Definições

ObjectWithoutType