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 Government 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 |
O conector Windows 365 fornece ações para gerenciar Windows 365 PCs de nuvem e políticas de provisionamento em seu ambiente de 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 de Power Automate.
Serviço, Classe e Regiões
| Serviço | Classe | Regiões |
|---|---|---|
| Copilot Studio | Premium | As regiões de Power Automate |
| Aplicativos Lógicos | Premium | Todas as regiões de Aplicativos Lógicos |
| Power Apps | Premium | As regiões de Power Apps |
| Power Automate | Premium | As regiões de Power Automate |
Contato
| Contato | |
|---|---|
| Nome | Windows 365 |
| URL | https://learn.microsoft.com/en-us/connectors/windows365 |
W365powerplatform@microsoft.com |
Pré-requisitos
Para usar esse conector, você precisa:
- Windows 365 licenças para sua organização
- assinatura Microsoft Intune
- Privilégios suficientes no RBAC (controle de acesso baseado em função) Microsoft Intune para gerenciar recursos de Windows 365
- Azure conta do 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 de Windows 365 (requer
Webhook.CreateeWebhook.Deletepara operações de gatilho)
Important: esse conector requer licenças de Windows 365 e permissões RBAC de Microsoft Intune apropriadas. Todas as operações usam o microsoft Graph API e estão sujeitas a limites de limitação Graph API.
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 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 o Graph API 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 | 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 de Windows 365 Business Cloud PCs é sempre nula, pois Windows 365 Business os PCs de nuvem não são registrados automaticamente pelo Intune por 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 Ajustes de conta e políticas doPassword em 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. |
| $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 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: 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. |
| 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 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 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 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
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
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
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)
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: |
|
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
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
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
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
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
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
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 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
Quando uma política de provisionamento ou pc de nuvem é atualizada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
cenário
|
scenario | True | string |
cenário |