Configurar a identidade gerenciada na Área de Trabalho Virtual do Azure (versão prévia)

Importante

O suporte de identidade gerenciada para pools de host da Área de Trabalho Virtual do Azure está atualmente em VERSÃO PRÉVIA. Consulte os Termos de Uso Complementares das Versões Prévias do Microsoft Azure para obter os termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que ainda não foram lançados em disponibilidade geral.

Azure Área de Trabalho Virtual dá suporte à atribuição de permissões a identidades gerenciadas para recursos Azure para recursos que precisam executar operações Azure Resource Manager (ARM) em máquinas virtuais, cofre de chaves e redes virtuais na assinatura Azure. O seguinte recurso pode usar uma identidade gerenciada:

dimensionamento automático.
Atualização do host da sessão.
Iniciar VM na Conexão.
Área de Trabalho Virtual do Azure para o Azure Local.

Alguns recursos da Área de Trabalho Virtual do Azure não podem usar uma identidade gerenciada. Os recursos que exigem que você Atribua funções RBAC do Azure para funções do Microsoft Entra a uma entidade de serviço usando a abordagem da entidade de serviço da Área de Trabalho Virtual do Azure são:

Anexo de Aplicativo (ao usar Arquivos do Azure e seus hosts de sessão ingressaram no Microsoft Entra ID).

Ao usar uma identidade gerenciada, você tem duas opções:

Identidade gerenciada atribuída ao sistema
Identidade gerenciada atribuída ao usuário

Saiba mais sobre as diferenças entre identidades gerenciadas atribuídas pelo sistema e atribuídas pelo usuário.

Pré-requisitos

Para criar e atribuir uma identidade gerenciada atribuída pelo sistema a um pool de hosts, é necessário:

Um pool de hosts existente.
Uma conta do Azure atribuída ao Colaborador do Pool de Host de Virtualização de Área de Trabalho no escopo do pool de host ou superior.
Se você quiser usar a CLI do Azure ou o Azure PowerShell localmente, consulte Usar a CLI do Azure e o Azure PowerShell com a Área de Trabalho Virtual do Azure para verificar se você tem a extensão da CLI do Azure desktopvirtualization ou o módulo Az.DesktopVirtualization do PowerShell instalado. Como alternativa, use o Azure Cloud Shell.

Criar e atribuir uma identidade gerenciada atribuída pelo sistema

Selecione a guia relevante para seu cenário.

Portal do Azure
Azure PowerShell

Veja como criar uma identidade gerenciada atribuída pelo sistema com o portal do Azure:

Entre no portal do Azure.
Na barra de pesquisa, insira Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente
Selecione Pools de host e, em seguida, selecione o nome do pool de host que você deseja configurar.
Selecione Identidade (Versão prévia).
Selecione Atribuir uma identidade gerenciada para que a caixa seja marcada e, em seguida, selecione Identidade gerenciada atribuída ao sistema.
Selecione Salvar para criar e atribuir uma identidade gerenciada atribuída pelo sistema.

Veja como criar uma identidade gerenciada atribuída pelo sistema com o Azure PowerShell. Certifique-se de alterar os <placeholder> seus próprios valores.

Abra Azure Cloud Shell no portal do Azure com o tipo de terminal do PowerShell ou execute o PowerShell em seu dispositivo local.
- Se você estiver usando o Cloud Shell, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.
- Se você estiver usando o PowerShell localmente, primeiro entre no Azure PowerShell e, em seguida, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

Obtenha os valores atuais do pool de hosts:

$parameters = @{
    Name = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

$existingHostPool = Get-AzWvdHostPool @parameters

Execute o New-AzWvdHostPool comando com as mesmas informações, alterando apenas para IdentityType 'SystemAssigned'. Como esse pool de hosts já existe, esse comando altera apenas a IdentityType propriedade:

$parameters = @{
    Name = $existingHostPool.Name
    ResourceGroupName = $existingHostPool.ResourceGroupName
    Location = $existingHostPool.Location
    HostPoolType = $existingHostPool.HostPoolType
    LoadBalancerType = $existingHostPool.LoadBalancerType
    PreferredAppGroupType = $existingHostPool.PreferredAppGroupType
    IdentityType = 'SystemAssigned'
}

New-AzWvdHostPool @parameters

Para marcar as alterações, execute o seguinte comando:

$parameters = @{
    Name = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Get-AzWvdHostPool @parameters | Format-Table Name, IdentityType

A saída deve ser semelhante ao exemplo a seguir:

Name        IdentityType
----------- ----------------
contosohp01 SystemAssigned

Pré-requisitos

Para atribuir uma identidade gerenciada atribuída pelo usuário a um pool de hosts, é necessário:

Um pool de hosts existente.
Uma conta do Azure atribuída:
1. Colaborador do Pool de Host de Virtualização de Área de Trabalho no escopo do pool de host ou superior.
2. Operador de Identidade Gerenciada no escopo da identidade gerenciada ou superior.
Se você quiser usar a CLI do Azure ou o Azure PowerShell localmente, consulte Usar a CLI do Azure e o Azure PowerShell com a Área de Trabalho Virtual do Azure para verificar se você tem a extensão da CLI do Azure desktopvirtualization ou o módulo Az.DesktopVirtualization do PowerShell instalado. Como alternativa, use o Azure Cloud Shell.

Atribuir uma identidade gerenciada atribuída ao usuário

Selecione a guia relevante para seu cenário.

Portal do Azure
Azure PowerShell

Veja como atribuir uma identidade gerenciada atribuída pelo usuário com o portal do Azure:

Entre no portal do Azure.
Na barra de pesquisa, insira Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente
Selecione Pools de host e, em seguida, selecione o nome do pool de host que você deseja configurar.
Selecione Identidade (Versão prévia).
Selecione Atribuir uma identidade gerenciada para que a caixa seja marcada e, em seguida, selecione Identidade gerenciada atribuída pelo usuário.
Em Assinatura, selecione a assinatura apropriada no menu suspenso.
Para Identidades gerenciadas atribuídas pelo usuário existentes, selecione a identidade gerenciada apropriada no menu suspenso.
Selecione Salvar para aplicar a nova identidade gerenciada.

Veja como atribuir uma identidade gerenciada atribuída pelo usuário com o Azure PowerShell. Certifique-se de alterar os <placeholder> seus próprios valores.

Abra Azure Cloud Shell no portal do Azure com o tipo de terminal do PowerShell ou execute o PowerShell em seu dispositivo local.
- Se você estiver usando o Cloud Shell, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.
- Se você estiver usando o PowerShell localmente, primeiro entre no Azure PowerShell e, em seguida, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

Obtenha os valores atuais do pool de hosts:

$parameters = @{
    Name = '<HostPoolName>'
    ResourceGroupName = '<HostPoolResourceGroupName>'
}

$existingHostPool = Get-AzWvdHostPool @parameters

Obtenha o objeto de identidade gerenciada que você deseja atribuir ao pool de hosts:

$parameters = @{
    Name = '<ManagedIdentityName>'
    ResourceGroupName = '<ManagedIdentityResourceGroupName>'
}

$managedIdentity = Get-AzUserAssignedIdentity @parameters

$parameters = @{
    Name = $existingHostPool.Name
    ResourceGroupName = $existingHostPool.ResourceGroupName
    Location = $existingHostPool.Location
    HostPoolType = $existingHostPool.HostPoolType
    LoadBalancerType = $existingHostPool.LoadBalancerType
    PreferredAppGroupType = $existingHostPool.PreferredAppGroupType
    IdentityType = 'UserAssigned'
    IdentityUserAssignedIdentity = @{$managedIdentity.Id = @{}}
}

New-AzWvdHostPool @parameters

Para marcar as alterações, execute o seguinte comando:

$parameters = @{
    Name = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Get-AzWvdHostPool @parameters | Format-Table Name, IdentityType, IdentityUserAssignedIdentity

A saída deve ser semelhante ao exemplo a seguir:

Name        IdentityType     IdentityUserAssignedIdentity
----------- ---------------- ----------------------------
contosohp01 UserAssigned   {...

Remover uma identidade gerenciada

A remoção de uma identidade gerenciada de um pool de hosts tem um comportamento ligeiramente diferente, dependendo do tipo de identidade gerenciada:

Atribuído pelo sistema: quando você conclui a remoção, o Azure exclui automaticamente a identidade gerenciada e todos os metadados associados.
Atribuído pelo usuário: quando você conclui a remoção, o Azure remove a associação entre o pool de hosts e a identidade gerenciada, mas não faz outras alterações. Por exemplo, ele não altera as permissões atribuídas à identidade gerenciada.

Importante

Os pools de host configurados com uma configuração de host de sessão exigirão uma identidade gerenciada a partir de 1º de novembro de 2025 para adicionar hosts de sessão ao pool de hosts. Isso substitui a dependência da entidade de serviço da Área de Trabalho Virtual do Azure e permite uma configuração mais segura. Saiba mais sobre como usar identidades gerenciadas com pools de host da Área de Trabalho Virtual do Azure.

Selecione a guia relevante para seu cenário.

Portal do Azure
Azure PowerShell

Veja como remover uma identidade gerenciada pelo portal do Azure:

Entre no portal do Azure.
Na barra de pesquisa, insira Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente
Selecione Pools de host e, em seguida, selecione o nome do pool de host que você deseja configurar.
Selecione Identidade (Versão prévia).
Selecione a opção Atribuir uma identidade gerenciada para que a caixa seja desmarcada.
Selecione Salvar para concluir a remoção da identidade gerenciada.

Veja como remover uma identidade gerenciada com o Azure PowerShell. Certifique-se de alterar os <placeholder> seus próprios valores.

Abra Azure Cloud Shell no portal do Azure com o tipo de terminal do PowerShell ou execute o PowerShell em seu dispositivo local.
- Se você estiver usando o Cloud Shell, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.
- Se você estiver usando o PowerShell localmente, primeiro entre no Azure PowerShell e, em seguida, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

Obtenha os valores atuais do pool de hosts:

$parameters = @{
    Name = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

$existingHostPool = Get-AzWvdHostPool @parameters

Execute o New-AzWvdHostPool comando com as mesmas informações, alterando apenas para IdentityType 'Nenhum'. Como esse pool de hosts já existe, esse comando altera apenas a IdentityType propriedade:

$parameters = @{
    Name = $existingHostPool.Name
    ResourceGroupName = $existingHostPool.ResourceGroupName
    Location = $existingHostPool.Location
    HostPoolType = $existingHostPool.HostPoolType
    LoadBalancerType = $existingHostPool.LoadBalancerType
    PreferredAppGroupType = $existingHostPool.PreferredAppGroupType
    IdentityType = 'None'
}

New-AzWvdHostPool @parameters

Para marcar as alterações, execute o seguinte comando:

$parameters = @{
    Name = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Get-AzWvdHostPool @parameters | Format-Table Name, IdentityType

A saída deve ser semelhante ao exemplo a seguir:

Name        IdentityType
----------- ----------------
contosohp01 None

Atribuir identidade gerenciada a hosts de sessão no local

A Área de Trabalho Virtual do Azure para o Azure Local exige que a identidade gerenciada receba acesso de Leitor ao host da sessão. Essas instruções concederão acesso de leitor ao grupo de recursos que hospeda esses recursos.

Portal do Azure
Azure PowerShell

Veja como atribuir acesso de leitor a uma identidade gerenciada com o portal do Azure:

Entre no portal do Azure.
Na barra de pesquisa, insira Grupos de Recursos e selecione a entrada correspondente
Selecione o grupo de recursos que contém os hosts da sessão
Selecione Controle de Acesso (IAM) na navegação do lado esquerdo.
Selecione Adicionar e, em seguida, Adicionar atribuição de função
Na caixa de pesquisa Pesquisar por nome, descrição, permissão ou ID da função, pesquise Leitor e clique em Avançar
Para Atribuir acesso a selecionar Identidade gerenciada
Para Membros , clique em Selecionar membros
Selecione a Assinatura correta
Na lista suspensa Identidade Gerenciada , selecione Hostpool
Selecione a Identidade Gerenciada correta para o Hostpool
Clique em Selecionar e depois em Avançar
Selecione Examinar + atribuir
Examine suas seleções e selecione Examinar + atribuir

Veja como atribuir acesso de leitor a uma identidade gerenciada com o Azure PowerShell. Certifique-se de alterar os <placeholder> seus próprios valores.

Abra Azure Cloud Shell no portal do Azure com o tipo de terminal do PowerShell ou execute o PowerShell em seu dispositivo local.
- Se você estiver usando o Cloud Shell, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.
- Se você estiver usando o PowerShell localmente, primeiro entre no Azure PowerShell e, em seguida, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

Obtenha o objeto de identidade gerenciada atribuído ao pool de hosts.

$hostPool = Get-AzWvdHostPool -Name "<HOSTPOOL_NAME>" -ResourceGroupName "<RESOURCE_GROUP>"
$HP_PRINCIPAL_ID = $hostPool.IdentityPrincipalId

Atribuir acesso de leitor no grupo de recursos à identidade gerenciada

New-AzRoleAssignment -ObjectId $HP_PRINCIPAL_ID -RoleDefinitionName "Reader" -ResourceGroupName "<RESOURCE_GROUP>"

Execute as próximas etapas para atribuir funções RBAC do Azure ou funções do Microsoft Entra a uma entidade de serviço usando a abordagem de identidade gerenciada.

Comentários

Esta página foi útil?

Last updated on 2026-08-22

Configurar a identidade gerenciada na Área de Trabalho Virtual do Azure (versão prévia)

Pré-requisitos

Criar e atribuir uma identidade gerenciada atribuída pelo sistema

Pré-requisitos

Atribuir uma identidade gerenciada atribuída ao usuário

Remover uma identidade gerenciada

Atribuir identidade gerenciada a hosts de sessão no local

Comentários

Recursos adicionais