Modo de drenagem no Azure Virtual Desktop explicado
Parceiro · Parceiro neutro: Nerdio
By Mirko Peters ·
O modo de drenagem impede que um host de sessão aceite novas sessões de novos usuários, enquanto as sessões existentes continuam até terminarem. Este artigo explica o que ele muda e o que não muda, como o balanceador de carga e o dimensionamento automático o tratam, e como configurá-lo no portal e configurá-lo e consultá-lo com o PowerShell.
Automatically translated with AI from the original post. Read the English original
O modo de drenagem é uma configuração por host que impede que um host de sessão aceite novas sessões de usuários. As sessões já existentes não são afetadas. Este artigo explica o que essa configuração muda, o que não muda, como o balanceador de carga e o dimensionamento automático a tratam, e como configurá-la no portal e configurá-la e consultá-la no PowerShell. O runbook passo a passo de manutenção é um artigo separado, "Como usar o modo de drenagem para aplicar patches e manutenção em hosts de sessão", e o planejamento de ondas em um pool é abordado em "Aplicando patches no AVD sem indisponibilidade: atualizações contínuas com modo de drenagem".
Pontos-chave
- Um host de sessão em drenagem não aceita novas sessões. As sessões existentes permanecem conectadas até que o usuário saia ou um administrador as encerre, e os administradores ainda podem se conectar diretamente ao servidor.
- O modo de drenagem não é um logoff, um desligamento nem um estado de integridade. Ele altera apenas se o host pode ser escolhido para novas conexões.
- Um usuário que já tenha uma sessão ativa ou desconectada em um host em drenagem continua sendo redirecionado para esse host ao fazer login novamente. Novos usuários não são direcionados para ele.
- Em pools de hosts compartilhados, o dimensionamento automático liga e desliga o modo de drenagem independentemente de quem o tenha definido. Use a tag de exclusão para proteger um host. Em pools pessoais, o dimensionamento automático não usa o modo de drenagem.
- No PowerShell, Update-AzWvdSessionHost com AllowNewSession $False ativa a drenagem, e $True a desativa. A Learn lista a função Desktop Virtualization Session Host Operator como pré-requisito.
O que o modo de drenagem faz
A Microsoft Learn descreve o modo de drenagem como uma forma de isolar um host de sessão para que você possa realizar manutenção sem interromper o serviço. Os efeitos documentados são:
- Novas sessões. Um host em drenagem não aceita novas sessões. As novas conexões são redirecionadas para o próximo host de sessão disponível.
- Sessões existentes. Elas permanecem ativas até que o usuário saia ou um administrador as encerre.
- Manutenção. Quando não restarem sessões no host, você pode realizar a manutenção.
- Acesso de administrador. Os administradores ainda podem se conectar diretamente ao servidor, sem passar pelo serviço Azure Virtual Desktop.
Na referência do Azure PowerShell, o mesmo estado é representado pelo parâmetro -AllowNewSession de Update-AzWvdSessionHost, e o objeto de saída de Get-AzWvdSessionHost contém a propriedade AllowNewSession, descrita como "Allow a new session." O texto da Learn usa o plural AllowNewSessions em alguns trechos, e suas perguntas frequentes sobre o dimensionamento automático dizem que, quando ele desativa o modo de drenagem após desalocar uma VM, define AllowNewSessions como true. Portanto, modo de drenagem ativado significa que novas sessões não são permitidas, e modo de drenagem desativado significa que são permitidas.
O que o modo de drenagem não é
- Não é um logoff. Nada é encerrado pelo fato de você tê-lo ativado.
- Não é um desligamento. A Learn não descreve nenhum desligamento, portanto a VM continua em execução e o custo continua. Essa é uma conclusão a partir da descrição, e não uma afirmação da Learn.
- Não é um estado de integridade. A Learn lista a configuração de novas sessões e o status como propriedades separadas. Verificações de integridade e status são um tema à parte; veja "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
- Não é o mesmo que o limite máximo de sessões. Com o balanceamento de carga em profundidade (depth-first), um host que está no seu limite máximo de sessões deixa de ser considerado na consulta de novas sessões, mas somente até que as sessões terminem e haja espaço novamente. Um host em drenagem permanece excluído até que o modo de drenagem seja desativado, seja por você ou, em grupos de hosts agrupados com um plano de escala, pelo dimensionamento automático, a menos que o host tenha a tag de exclusão (veja abaixo).
Como o balanceador de carga trata um host em drenagem
A página do Learn sobre balanceamento de carga apresenta duas regras que explicam o que os usuários experimentam:
- Para novos usuários, o balanceador de carga não considera hosts de sessão em modo de drenagem.
- Um usuário que tenha uma sessão ativa ou desconectada e faça login novamente é redirecionado para esse host de sessão, mesmo que o modo de drenagem esteja habilitado.
A segunda regra é importante para o planejamento. Um usuário com uma sessão desconectada em um host em modo de drenagem volta para esse mesmo host, então o host não se esvazia sozinho enquanto existirem essas sessões. O host só fica vazio quando os usuários encerram a sessão ou quando você finaliza essas sessões. O Learn descreve as duas regras como comportamentos compartilhados pelo balanceamento de carga em largura e em profundidade. Ele acrescenta que o balanceamento de carga não se aplica a pools de host pessoais.
Quem pode definir e como
A página do Learn sobre drenagem lista os pré-requisitos de todo o procedimento, tanto no portal quanto no PowerShell: um grupo de hosts com pelo menos um host de sessão e a função Operador de Host de Sessão de Virtualização de Área de Trabalho. Para o Azure PowerShell local, você também precisa do módulo Az.DesktopVirtualization, ou pode usar o Azure Cloud Shell.
No portal do Azure, abra o grupo de hosts, selecione Hosts de sessão, marque o host e escolha Ativar modo de drenagem. Escolha Desativar modo de drenagem para permitir conexões novamente.
No Azure PowerShell, a página do Learn sobre drenagem traz um comando para cada direção. Ele é executado em um host de sessão por vez, então repita-o para cada host que você quiser alterar:
# Drain mode on: block new sessions
$params = @{
ResourceGroupName = '<ResourceGroupName>'
HostPoolName = '<HostPoolName>'
Name = '<SessionHostName>'
AllowNewSession = $False
}
Update-AzWvdSessionHost @params
# Drain mode off: allow new sessions
$params.AllowNewSession = $True
Update-AzWvdSessionHost @paramsA página apresenta os dois blocos separadamente; a tabela hash única acima é um resumo feito por este artigo.
Para ler o estado, Get-AzWvdSessionHost retorna um objeto ISessionHost. Sua propriedade AllowNewSession contém a configuração, e a referência de REST lista o mesmo valor como properties.allowNewSession. Uma linha como Get-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> -HostPoolName <HostPoolName> | Select-Object Name, AllowNewSession, Session, Status lista todos os hosts de um grupo com sua configuração e contagem de sessões. O filtro Select-Object é uma sugestão deste artigo, não um exemplo do Learn. Depois de uma alteração no portal, aguarde pelo menos 60 segundos antes de atualizar, pois o Learn alerta que uma atualização imediata pode mostrar um status fora de sincronia.
Como o dimensionamento automático usa e sobrescreve o modo de drenagem
O próprio dimensionamento automático usa o modo de drenagem, o que é fácil de passar despercebido. Em grupos de hosts agrupados, ele coloca um host em modo de drenagem antes de desalocá-lo, define AllowNewSessions de volta como true depois e ativa ou desativa o modo de drenagem em qualquer VM no escopo, independentemente de quem o tenha definido. Apenas um host que tenha a tag de exclusão fica intocado. Em grupos de hosts pessoais, o dimensionamento automático não usa o modo de drenagem, e um usuário que se conecta durante a desalocação recebe "No resources available" (Nenhum recurso disponível). O artigo do runbook mostra como marcar um host com tag antes de colocá-lo em drenagem, e o artigo sobre encerramento forçado de sessão descreve a sequência de redução gradual.
Um exemplo rápido
Imagine um pool compartilhado com três sessões: o usuário A está ativo, o usuário B está desconectado e o usuário C está ativo. Você ativa o modo de drenagem. O usuário D faz login pela primeira vez e é enviado para outro host, porque o balanceador de carga não considera hosts em drenagem para novos usuários. O usuário A faz logoff. O usuário B se reconecta e, como tem uma sessão desconectada neste host, volta para ele mesmo estando em drenagem. O usuário C continua conectado. O host só fica livre para manutenção depois que B e C fizerem logoff ou um administrador encerrar as sessões deles. Se você não fizer nada, ele permanece nesse estado, a menos que o dimensionamento automático altere o modo de drenagem de um host de pool que não tenha a tag de exclusão. Este passo a passo aplica as regras documentadas e não é um cenário do Learn.
Modo de drenagem comparado com controles relacionados
| Controle | O que muda | Sessões existentes |
|---|---|---|
| Modo de drenagem | O host não recebe novas sessões de novos usuários | Permanecem conectadas |
| Limite máximo de sessões reduzido | Quantas sessões o host aceita | O Learn informa que reduzir esse limite em um host com sessões ativas não afeta essas sessões |
| Tag de exclusão | O dimensionamento automático não inicia, para nem altera o modo de drenagem do host | Não afetadas |
| Forçar logoff durante a redução de escala | O dimensionamento automático encerra as sessões restantes após o tempo de espera | Encerradas |
Só a última linha encerra sessões. Por isso, o modo de drenagem precisa de uma segunda etapa, esperar ou encerrar as sessões, antes que o host fique livre para trabalho. A tabela é um resumo das afirmações do Learn citadas acima.
Como interpretar o resultado
- Sessões. Verifique a quantidade de sessões no host antes de começar o trabalho. O modo de drenagem não encerra as sessões existentes. O glossário de Insights informa que o item Sessões mostra as sessões conectadas e desconectadas, enquanto Sessões ociosas mostra apenas as desconectadas.
- Acesso direto. Esta é uma conclusão baseada no acesso documentado de administrador, e não uma afirmação do Learn: como os administradores podem acessar a VM sem passar pelo serviço, seus próprios testes em um host em drenagem não comprovam o que os usuários vão ver.
Equívocos comuns
- "Ativei o modo de drenagem e os usuários foram desconectados." A página do modo de drenagem não descreve esse comportamento. Verifique se há dimensionamento automático, política ou processo de patch que encerre sessões.
- "O host está em drenagem, mas ainda tem usuários." Esperado: as sessões persistem e os usuários que voltam são direcionados ao próprio host.
- "O modo de drenagem foi desativado de novo." Em pools compartilhados, verifique primeiro o plano de escalonamento e a tag de exclusão.
- "Novos usuários não conseguem se conectar de jeito nenhum." Se todos os hosts de um pool estiverem em modo de drenagem, nenhum host pode receber um novo usuário. A página do modo de drenagem não documenta nenhuma mensagem de erro para esse caso.
Fontes
Acessado em 17 de novembro de 2026.
- Microsoft Learn: Drenar hosts de sessão para manutenção no Azure Virtual Desktop
- Microsoft Learn: Configurar o balanceamento de carga do pool de hosts no Azure Virtual Desktop
- Microsoft Learn: Perguntas frequentes sobre o autoscale
- Microsoft Learn: Cenários de dimensionamento automático do Azure Virtual Desktop
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdSessionHost
- Microsoft Learn: Modelo ISessionHost
- Microsoft Learn: Session Hosts - Get (API REST)
- Microsoft Learn: Glossário de Insights do Azure Virtual Desktop
Perguntas frequentes
O modo de drenagem desconecta os usuários?
Não. A Microsoft Learn diz que as conexões existentes permanecem ativas até que o usuário saia ou um administrador encerre a sessão. O modo de drenagem afeta apenas para onde as novas sessões são direcionadas.
Por que meu host saiu do modo de drenagem sozinho?
Se o host estiver em um pool de hosts compartilhado com um plano de escalonamento automático, o dimensionamento automático substitui o modo de drenagem nas VMs incluídas no escalonamento, independentemente de quem o tenha definido. As perguntas frequentes indicam o uso de tags de exclusão para manter uma VM fora das ações de escalonamento.
Quanto tempo o portal leva para mostrar a alteração?
A Learn informa que, se você atualizar o portal logo após alterar o modo de drenagem, o status pode aparecer dessincronizado, e recomenda aguardar pelo menos 60 segundos antes de atualizar.