Windows 365 (versão prévia)

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

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões do 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:      – Regiões do Azure Governamental      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões do 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 do 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

O conector do Windows 365 fornece ações para gerenciar PCs de nuvem do Windows 365 e políticas de provisionamento em seu ambiente do Microsoft Intune. Esse conector permite automatizar operações de ciclo de vida do PC na nuvem, gerenciamento de políticas de provisionamento e tarefas administrativas por meio de fluxos do Power Automate.

Serviço, Classe e Regiões

Serviço	Classe	Regions
Copilot Studio	Premium	Todas as regiões do Power Automate
Aplicativos Lógicos	Premium	Todas as regiões de Aplicativos Lógicos
Power Apps	Premium	Todas as regiões do Power Apps
Power Automate	Premium	Todas as regiões do Power Automate

Contato

Contato
Nome	Windows 365
URL	https://learn.microsoft.com/en-us/connectors/windows365
Email	W365powerplatform@microsoft.com

Pré-requisitos

Para usar esse conector, você precisa:

• Licenças do Windows 365 para sua organização
• Assinatura do Microsoft Intune
• Privilégios suficientes no RBAC (controle de acesso baseado em função) do Microsoft Intune para gerenciar recursos do Windows 365
• Conta do Azure AD com permissões apropriadas

Permissões necessárias

Os usuários devem ter uma das seguintes funções RBAC do Intune:

• Administrador global
• Administrador de Serviços do Intune
• Administrador do Windows365 (para operações específicas do PC na nuvem)
• Função personalizada com permissões do Windows 365 (requer Webhook.Create e Webhook.Delete para operações de gatilho)

Importante: esse conector requer licenças do Windows 365 e permissões rbac apropriadas do Microsoft Intune. Todas as operações usam a API do Microsoft Graph e estão sujeitas aos limites de limitação da API do Graph.

Problemas e limitações conhecidos

O conector do Windows 365 está atualmente em Versão Prévia 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 de visualização e como habilitá-los. 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

• Os recursos e as limitações são consistentes com a API do Graph subjacente.
• 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.
$filtro	Não	cadeia	$filter permite que você obtenha um subconjunto just de uma coleção do Graph.

Retorna

Nome	Tipo	Description
aadDeviceId	String	O Microsoft Entra ID do dispositivo para o PC na Cloud, também conhecido como o ID do dispositivo do Azure Active Directory (Azure AD), que consiste em 32 carateres num formato GUID. Gerado numa VM associada ao 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 dos PCs da Cloud Windows 365 Business é sempre nula, uma vez que Windows 365 Business PCs na Cloud não são inscritos automaticamente Intune pelo Windows 365. Somente leitura.
managedDeviceName	String	O Intune nome do dispositivo inscrito para o CLOUD PC. A propriedade managedDeviceName de PCs da Nuvem de Negócios do Windows 365 é sempre nula, pois os PCs da Nuvem de Negócios do Windows 365 não são registrados automaticamente 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 na ID do Microsoft Entra. 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.
$filtro	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.
descrição	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 a forma como os PCs na Cloud se associam 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. Os usuários do Windows 365 podem usar o logon único para autenticar na ID do Microsoft Entra com opções sem senha (por exemplo, chaves FIDO) para acessar o computador 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 Preview + 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: oferta microsoftwindowsdesktop: 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
tipoDeImagem	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.
$filtro	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
Nome	Yes	String	A política de aprovisionamento aplicada durante o aprovisionamento de PCs na Cloud. O comprimento máximo é de 120 caracteres
Description	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.
Configuração/localidade do Windows	Yes	String	Forneça o idioma/localidade que você gostaria de usar. O 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 do grupo de destino	Yes	String	Grupo de usuários da ID do Entra.
Atribuições – ID do ServicePlan de destino	Não	String	O identificador exclusivo para o plano de serviço que indica qual tamanho do PC na nuvem será provisionado para o usuário.

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.
Description	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: GetAProvisoningPolicyV1

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 do 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.

Triggers

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

Nome do Acionador	Descrição
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
• Descrição: Esse gatilho é acionado quando uma política de provisionamento ou pc na nuvem é atualizada.

Parâmetros

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

Retorna

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

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 do Microsoft Graph (versão prévia)	Construir uma solicitação da API REST do 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

Atualizar uma política de provisionamento

Criar uma política de provisionamento

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

Excluir uma política de provisionamento

Iniciar uma ação remota

Listar PCs na Cloud

Obter políticas de provisionamento

Obter um computador na nuvem

Obter uma política de provisionamento

Gatilhos

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

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

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

Definições

ObjectWithoutType