Como Configurar Host Pools no AVD com PowerShell

Steps and Tech
1 de abr.
3 min de leitura

A configuração de Host Pools no Azure Virtual Desktop (AVD) pode parecer desafiadora, mas não precisa ser assim. Com o uso do PowerShell, você pode facilitar bastante o processo. Neste guia, você encontrará um passo a passo que o ajudará a criar e configurar Host Pools de maneira eficiente e descomplicada. Prepare-se para um tutorial prático que o levará ao sucesso!

Se você quer criar um ambiente de AVD na "mão", clicando em tudo pelo portal, beleza! Funciona... Mas se você quer escalar, automatizar ou integrar com pipelines, o caminho mais inteligente é usar PowerShell.

Com o módulo certo, dá pra criar host pools, application groups, registrar session hosts e mais — tudo via script. Neste artigo, você vai aprender o essencial para criar e configurar um host pool no AVD com PowerShell, usando o módulo Az.DesktopVirtualization.

Pré-requisitos

Antes de adicionar/criar os Host Pools, você deve garantir algumas configurações e pré-requisitos.

Permissões adequadas no Azure (papel de Contributor ou equivalente no grupo de recursos).
Assinatura do Azure: Seu usuário deve ter uma assinatura ativa do Azure. Isso é essencial, pois você não poderá criar recursos sem ela.
O Azure PowerShell instalado e atualizado. Caso não tenha, você pode instalar executando:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Altere o -Scope se deseja installar para AllUsers

Install-Module -Name Az -AllowClobber -Scope AllUsers

Módulo do Azure Virtual Desktop instalado:

Install-Module -Name Az.DesktopVirtualization -Force

Esse módulo permite gerenciar todos os recursos do AVD via PowerShell - de forma remota e automatizada.

✅Depois de atender aos pré-requisitos, você estará pronto para configurar seu Host Pool!

Conectando-se ao Azure

O primeiro passo é conectar-se à sua conta do Azure usando o PowerShell. Execute o seguinte comando:

Connect-AzAccount

Após rodar o comando, uma janela de login irá aparecer. Insira suas credenciais do Azure.
Selecione a conta e continue.

Se você tiver mais de uma subscription irá aparecer para você selecionar qual será utilizada.

1 . Criando o Host Pool

Agora, é hora de criar o Host Pool! Ajuste os parametros conforme sua necessidade.:

New-AzWvdHostPool ` 
  -ResourceGroupName "NOMEDORESOURCEGROUP" `
  -Name "HostPool01- Exemplo de Nome" ` 
  -Location "East US - Escolha a localização" `
  -FriendlyName "Teste para o Blog" `
  -HostPoolType "Pooled OU Personal" ` 	
  -MaxSessionLimit 10 `
  -LoadBalancerType "DepthFirst OU BreadthFirst" ` 
  -PreferredAppGroupType "Desktop"

HostPoolType: Escolha entre "Pooled" (multiusuário) ou "Personal" (dedicado a um usuário).
LoadBalancerType: "BreadthFirst" para distribuir sessões igualmente ou "DepthFirst" para ocupar servidores um a um.
O `MaxSessionLimit` é crucial, pois controla o número de conexões simultâneas permitidas. Por exemplo, se você espera 10 usuários simultâneos, configure para esse número.

Dica: Um Host Pool bem dimensionado é fundamental para a performance. Se você configurar uma limitação muito baixa, usuários poderão enfrentar dificuldades ao tentar acessar o sistema.

Criando um Application Group

New-AzWvdApplicationGroup `   
-ResourceGroupName "MeuGrupo" ` 
-HostPoolName "HostPool01" `   
-Location "East US" `   
-Name "AppGroupDesktop" `  
-ApplicationGroupType "Desktop"

Associar um Workspace

Depois, associe o Host Pool a um Workspace existente (ou crie um novo):

New-AzWvdWorkspace 
  -ResourceGroupName "NOMEDORESOURCEGROUP" `
  -Location "eastus" `
  -Name "NovoWorkspaceBlog" `
  -Description "Workspace para o Host Pool via PS"

4. Adicionando Máquinas Virtuais ao Host Pool

Depois de criar o Host Pool, é hora de adicionar as máquina virtuais! Se você tiver uma imagem pronta e quiser registrar VMs manualmente:

1º - Instale o agente do AVD nas VMs.

Após, execute o comando:

Add-AzWvdSessionHost 
  -ResourceGroupName "NOMEDORESOURCEGROUP" `  
  -HostPoolName "HostPoolPS" `
  -Name "NomeDaVM" `
  -AllowNewSession $true

🧑‍💻Caso precise criar as VMs, você pode usar o PowerShell ou uma imagem personalizada no Azure.

Configurar App Group e as Permissões de Usuário

Com as máquinas virtuais prontas, você pode configurar aplicativos para os usuários.

Adicione um App Group para o Host Pool:

New-AzWvdAppGroup 
  -ResourceGroupName "NOMEDORESOURCEGROUP" ``
  -Location "eastus" `
  -Name "AppGroupDesktop" `
  -HostPoolName "HostPoolPS" `
  -AppGroupType "Desktop OU RemoteApp"

Vincular usuários ao App Group:

New-AzWvdAppGroupUser 
  -ResourceGroupName "SeuResourceGroup" `
  -AppGroupName "AppGroupDesktop" `
  -UserPrincipalName "usuario@dominio.com"

Validar a criação
Get-AzWvdHostPool -ResourceGroupName "NOMEDORESOURCEGROUP"
Get-AzWvdApplicationGroup -ResourceGroupName "NOMEDORESOURCEGROUP"
Get-AzWvdWorkspace -ResourceGroupName"NOMEDORESOURCEGROUP"

Considerações

Criar e configurar host pools via PowerShell te dá mais controle, agilidade e produtividade!

Com um planejamento certo, você consegue montar ambientes AVD completos em minutos. Se você ainda está criando tudo na mão, esse é o momento de dar o próximo passo. 😀

Fique ligado para mais Insights e Novidades!

Até Breve!

Steps and Tech