Como usar o modo de drenagem para aplicar patches e fazer manutenção em session hosts
Parceiro · Parceiro neutro: Nerdio
By Mirko Peters ·
Runbook para tirar um session host do Azure Virtual Desktop de serviço: proteja-o do dimensionamento automático, ative o modo de drenagem, avise e encerre as sessões restantes, execute o trabalho e depois desative o modo de drenagem.
Automatically translated with AI from the original post. Read the English original
Para aplicar patch em um session host sem desconectar usuários, marque a VM para que o dimensionamento automático a ignore, ative o modo de drenagem, envie aos usuários restantes uma mensagem com um prazo, encerre as sessões que sobrarem, aplique o patch e reinicie e, por fim, desative o modo de drenagem.
Pontos-chave
- O modo de drenagem impede novas sessões em um host. As sessões existentes permanecem até que o usuário faça logoff ou um administrador as encerre.
- Um usuário que já tem uma sessão ativa ou desconectada no grupo de hosts continua sendo direcionado de volta para esse host, mesmo com o modo de drenagem ativado. Por isso, liste e encerre as sessões antes de aplicar o patch.
- Em grupos de hosts em pool, o dimensionamento automático sobrepõe o modo de drenagem em todas as VMs no escopo, então defina primeiro a tag de exclusão do plano de escalonamento. Em grupos pessoais, o dimensionamento automático não define o modo de drenagem.
- Ativar o modo de drenagem exige a função Desktop Virtualization Session Host Operator; enviar mensagens e desconectar usuários exige User Session Operator. Verifique as permissões efetivas da conta usada no runbook.
- Para atualizações baseadas em imagem de hosts que usam uma configuração de session host, o session host update gerencia o modo de drenagem por conta própria, e a Learn recomenda não alterá-lo manualmente durante uma atualização.
Este artigo é o runbook para um único host. O que é o modo de drenagem está em "Drain mode in Azure Virtual Desktop explained". O planejamento de ondas em um grupo de hosts inteiro, com tamanhos de onda e capacidade, é o tema de "Patching AVD without downtime: rolling updates with drain mode". A mecânica da tag de exclusão, incluindo como aplicá-la, está em "How to use the exclusion tag for maintenance windows and special session hosts".
O que você precisa antes de começar
- Funções. A documentação do Learn informa que ativar ou desativar o modo de drenagem exige a função Desktop Virtualization Session Host Operator. A descrição dessa função na página de RBAC acrescenta que ela permite exibir e remover hosts de sessão e alterar o modo de drenagem. Enviar mensagens, desconectar sessões e encerrar a sessão de usuários é coberto pela função Desktop Virtualization User Session Operator, que, segundo a página de RBAC, não permite alterar o modo de drenagem. A definição integrada da função Session Host Operator lista
Microsoft.DesktopVirtualization/hostpools/sessionhosts/, enquanto a definição da User Session Operator lista explicitamente.../sessionhosts/usersessions/. Portanto, se uma mesma conta consegue executar as duas etapas depende das funções realmente atribuídas a ela. Por isso, teste com a conta que vai executar o runbook. - Azure PowerShell com o módulo Az.DesktopVirtualization, ou o Azure Cloud Shell, se você quiser automatizar o processo com script.
- Capacidade. A Learn informa que novas conexões vão para o próximo session host disponível, então verifique se os hosts restantes conseguem absorver a carga. Em um grupo de profundidade primeiro, verifique também o limite máximo de sessões, porque a Learn informa que, quando todos os hosts atingem esse limite, você precisa aumentá-lo ou adicionar hosts.
Passo a passo
- Mantenha o autoscale longe do host (pools de host compartilhados). A página de cenários do Learn diz que, para pools de host compartilhados, o autoscale sobrescreve o modo de drenagem, e o FAQ de autoscale diz que o autoscale continua ligando ou desligando VMs em drenagem, independentemente de quem as colocou nesse modo, porque ele substitui o modo de drenagem em todas as VMs incluídas no dimensionamento. A tag de exclusão é um nome de tag que você informa na guia Noções básicas do plano de dimensionamento (na guia Propriedades de um plano existente). O exemplo do Learn é
excludeFromScaling. O campo existe para planos de gerenciamento de energia e para planos dinâmicos, que se aplicam apenas a pools de host compartilhados com configuração de host de sessão. Com a tag em um host de sessão, o autoscale não inicia, não para e não altera o modo de drenagem desse host. Adicione uma tag com esse nome à VM. As permissões de tag e mais detalhes estão no artigo sobre a tag de exclusão mencionado acima. Para pools de host pessoais, veja a seção mais adiante. - Ative o modo de drenagem. No portal do Azure, abra Azure Virtual Desktop, depois Pools de host, selecione o pool de host, selecione Hosts de sessão, marque o host e selecione Ativar modo de drenagem. Com o Azure PowerShell, a página de modo de drenagem do Learn define o modo de drenagem com o parâmetro
AllowNewSessiondeUpdate-AzWvdSessionHost, executado uma vez para cada host de sessão. A página usa uma tabela hash$paramscomAllowNewSession = $Falsee a passa por splatting para o cmdlet; a mesma chamada em um único bloco, na forma do exemplo da referência do cmdlet, é:
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> `
-Name <SessionHostName> `
-AllowNewSession:$falseO Learn alerta que o status no portal pode parecer dessincronizado se você atualizar imediatamente. Aguarde pelo menos 60 segundos antes.
- Liste as sessões que restam no host.
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName>A saída de exemplo do Learn identifica cada sessão como HostPoolName/SessionHostName/2, e a referência de Remove-AzWvdUserSession recebe o número da sessão em -Id (alias UserSessionId). Por isso, use a última parte do nome como ID da sessão.
- Avise os usuários. A referência do Learn mostra este formato, com o título e o corpo da mensagem como texto livre:
Send-AzWvdUserSessionMessage -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> `
-UserSessionId <id> -MessageTitle 'Maintenance' `
-MessageBody 'Please save your work and sign out. This host is patched at 18:30.'Defina um prazo que você consiga cumprir.
- Encerre o que restou. Após o prazo, remova as sessões restantes:
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>A página de referência também lista um parâmetro -Force ("Especifique para forçar a exclusão de userSession"), mas não mostra nenhum exemplo com ele. Remover uma sessão a encerra, então qualquer coisa que o usuário não tenha salvado será perdida. Por isso, o passo 4 vem primeiro.
- Faça a manutenção. O Learn diz que, quando não restarem sessões, você pode executar a manutenção necessária, e que os administradores ainda podem se conectar diretamente ao servidor sem passar pelo serviço Azure Virtual Desktop. A aplicação de patches em si, pelo Windows Update, Intune, WSUS ou outra ferramenta, está fora deste artigo, mas verifique antes como o Learn avalia a aplicação de patches in-place para o seu sistema operacional (veja a última seção). Se o host não voltar como disponível depois, use a checklist do artigo irmão "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
- Desative o modo de drenagem. No portal, marque o host e selecione Desativar modo de drenagem. No PowerShell, execute o mesmo cmdlet com
-AllowNewSession:$true; a página de modo de drenagem do Learn mostra os dois sentidos,$Falsepara ativar o modo de drenagem e$Truepara desativá-lo. Aguarde pelo menos 60 segundos antes de verificar o status no portal. Em seguida, remova a tag de exclusão para que o autoscale volte a gerenciar o host.
Comportamentos que surpreendem as pessoas
- Sessões desconectadas voltam. A página de balanceamento de carga do Learn diz que um usuário com uma sessão ativa ou desconectada que entra novamente é direcionado ao host com essa sessão, mesmo em modo de drenagem. Um usuário sem sessão nunca é direcionado a um host em drenagem. É por isso que o passo 3 é importante: um host que parece vazio ainda pode ter sessões desconectadas.
- Um host de pool sem tag continua no escopo. Se você colocar manualmente em drenagem um host de um pool de host compartilhado e não o marcar com tag, o autoscale ainda pode iniciar, parar ou alterar o modo de drenagem desse host, segundo o FAQ. A tag é o que tira o host do dimensionamento, não o modo de drenagem.
- O trabalho não salvo é perdido.
Remove-AzWvdUserSessionencerra a sessão. A referência do Learn não descreve nenhuma forma de recuperar a sessão, então envie a mensagem da etapa 4 primeiro. - Uma tag esquecida mantém o host fora do dimensionamento. O Learn diz que hosts com tag continuam fazendo parte do cálculo da porcentagem mínima de hosts, mas o dimensionamento automático não os inicia. Remova a tag na etapa 7. Enquanto ela permanecer, o dimensionamento automático não inicia o host, mesmo quando o pool precisa da capacidade. O cenário 4 do Learn descreve usuários vendo "No resources available" quando todos os hosts do pool estão com tag e desligados.
Um exemplo de cronograma para um host
Estes horários são fictícios, apenas para ilustração, e não são uma recomendação da Microsoft. Um host de pool, avd-host-03, recebe a aplicação de atualizações em uma noite de dia útil.
| Tempo | Ação |
|---|---|
| 17:30 | Marque a VM com tag, ative o modo de drenagem e liste as sessões (etapas 1 a 3). |
| 17:35 | Envie uma mensagem para cada sessão restante: salve o trabalho, encerre a sessão, o host será atualizado às 18h30 (etapa 4). |
| 18:30 | Remova as sessões que restaram, inclusive as desconectadas (etapa 5). |
| 18:35 | Instale as atualizações e reinicie (etapa 6). |
| 19:15 | Confirme que o host está informado como disponível, desative o modo de drenagem e remova a tag (etapa 7). |
Antes de começar, verifique se os outros hosts conseguem suportar a carga da noite. O artigo irmão sobre atualizações contínuas explica quantos hosts retirar de uma vez.
Pools de hosts pessoais
A FAQ do Learn diz que o dimensionamento automático não coloca um desktop pessoal em modo de drenagem antes de desalocá-lo, e que um usuário que se conecta durante a desalocação vê "No resources available". A FAQ também diz que, se um host de sessão for ligado pelo dimensionamento automático, pelo Start VM on Connect ou por um administrador, e ninguém fizer login nele, o dimensionamento automático o desaloca após um período de inatividade que a página não define. Isso afeta você se o pool tiver um plano de dimensionamento: um host pessoal que você inicia para aplicar atualizações, sem que um usuário faça login, pode ser desalocado enquanto você trabalha. O Learn descreve o campo de tag de exclusão para planos de gerenciamento de energia sem limitá-lo a pools de hosts compartilhados, mas não detalha seu efeito em pools de hosts pessoais. Por isso, marcar o host pessoal com tag antes de iniciar a VM é uma precaução sugerida por este artigo, não uma garantia documentada; verifique em um host de teste. Avise também o usuário atribuído, pois um host de sessão pessoal é atribuído a um único usuário.
Quando o modo de drenagem é a ferramenta errada
A página do Learn sobre métodos de atualização para hosts de sessão classifica a aplicação de atualizações no próprio local por sistema operacional. Para hosts multissessão de cliente Windows, marca o Windows Update como "Not recommended" para atualizações mensais e de recursos, e o WSUS como "Not recommended" para atualizações de recursos, enquanto marca a atualização de host de sessão e o Azure Compute Gallery como "Recommended". Para o Windows Server, marca o Windows Update como "Supported" e o Azure Update Manager e a aplicação automática de patches no convidado como "Recommended". Para o Windows client Enterprise (sessão única), marca o Windows Update como "Recommended", mas marca como "Not recommended" os pools de hosts compartilhados desse tipo. O parágrafo da mesma página sobre aplicar patches no local lista o Windows Update entre as tecnologias comuns, então leia as tabelas por sistema, e não apenas essa frase. Nossa leitura: este runbook se aplica a hosts Windows Server, hosts pessoais e manutenções que não são de patching, como mudanças de configuração, reinicializações, solução de problemas ou desativação de um host. Para pools multissessão de cliente Windows, o Learn recomenda a manutenção baseada em imagem.
Se você atualizar substituindo a imagem, em vez de aplicar a correção no local, o recurso de atualização de hosts de sessão do Learn faz o trabalho para hosts que usam uma configuração de host de sessão. O Learn diz que ele mesmo coloca os hosts selecionados em modo de drenagem e que você não deve alterar o modo de drenagem manualmente durante uma atualização. A mesma página também recomenda desativar o escalonamento automático no pool de hosts antes da atualização, porque um plano de escala habilitado pode fazer a atualização falhar com um erro de tempo de execução. Ela também informa que personalizações manuais, como arquivos, chaves do Registro e certificados, não estarão presentes após a atualização. A Microsoft anunciou a disponibilidade geral do gerenciamento aprimorado de pools de hosts, que inclui a configuração e a atualização de hosts de sessão, em julho de 2026 (Tech Community). Algumas páginas do Learn ainda trazem texto de versão prévia. Por exemplo, a página de configuração marca os cmdlets do Azure PowerShell para esses pools de hosts como versão prévia e pede a versão prévia do módulo Az.DesktopVirtualization. Verifique a página atual antes de confiar em qualquer limite. Compare essa abordagem com a drenagem em sequência descrita em "Patching AVD without downtime: rolling updates with drain mode".
Fontes
Acessado em 17 de novembro de 2026.
- Microsoft Learn: Drenar hosts de sessão para manutenção no Azure Virtual Desktop
- Microsoft Learn: Funções RBAC do Azure para o Azure Virtual Desktop (página rbac)
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdUserSession
- Microsoft Learn: Send-AzWvdUserSessionMessage
- Microsoft Learn: Remove-AzWvdUserSession
- Microsoft Learn: Configurar o balanceamento de carga do host pool
- Microsoft Learn: FAQ de escala automática do Azure Virtual Desktop
- Microsoft Learn: Criar e atribuir um plano de escala automática
- Microsoft Learn: Planos de escala automática e cenários de exemplo
- Microsoft Learn: Metodologias de gerenciamento de atualizações do Windows para hosts de sessão
- Microsoft Learn: Atualização de host de sessão
- Microsoft Learn: Atualizar hosts de sessão com uma configuração de host de sessão
- Microsoft Tech Community: Gerenciamento aprimorado de pools de hosts para o Azure Virtual Desktop tem disponibilidade geral
Perguntas frequentes
O que acontece com os usuários conectados quando eu ativo o modo de drenagem?
Nada acontece com eles. A Microsoft Learn informa que as conexões existentes permanecem ativas até que o usuário faça logoff ou um administrador encerre a sessão. O modo de drenagem apenas impede novas sessões. Você precisa enviar mensagens aos usuários e encerrar as sessões manualmente, por exemplo com Send-AzWvdUserSessionMessage e Remove-AzWvdUserSession.
Por que um usuário ainda está caindo no host que eu coloquei em drenagem?
A página de balanceamento de carga da Learn informa que um usuário que já tem uma sessão ativa ou desconectada no grupo de hosts é redirecionado para o host que contém essa sessão, mesmo com o modo de drenagem ativado. Usuários sem sessão não são enviados para um host em drenagem. Verifique sessões desconectadas com Get-AzWvdUserSession.
O dimensionamento automático vai religar meu host durante a manutenção?
Em um grupo de hosts em pool, pode. A FAQ de dimensionamento automático da Learn informa que o dimensionamento automático sobrepõe o modo de drenagem em todas as VMs incluídas no escalonamento. Para manter uma VM fora das ações de escalonamento, use a tag de exclusão definida no plano de escalonamento: a Learn informa que, nesse caso, o dimensionamento automático não inicia, não para nem altera o modo de drenagem dos hosts marcados. Para grupos de hosts pessoais, a FAQ informa que o dimensionamento automático não coloca o session host em modo de drenagem, mas ainda pode desalocar um host no qual ninguém fez logon.