Como Configurar Host Pools no AVD com PowerShell

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.

1. Permissões adequadas no Azure (papel de Contributor ou equivalente no grupo de recursos).

   
   

2. Assinatura do Azure: Seu usuário deve ter uma assinatura ativa do Azure. Isso é essencial, pois você não poderá criar recursos sem ela.

   
   

3. 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 instalar para AllUsers

Install-Module -Name Az -AllowClobber -Scope AllUsers

4. 

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

4. 
   

5. "

   
   

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

  
  

2. Criando um Application Group 

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

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

5. 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"

6. Validar a criação

   Get-AzWvdHostPool -ResourceGroupName "NOMEDORESOURCEGROUP" 

   

   Get-AzWvdApplicationGroup -ResourceGroupName "NOMEDORESOURCEGROUP" 

   

   Get-AzWvdWorkspace -ResourceGroupName"NOMEDORESOURCEGROUP"  

   

---