Como usar a tag de exclusão para janelas de manutenção e hosts de sessão especiais
Parceiro · Parceiro neutro: Nerdio
By Mirko Peters ·
Para aplicar patch em um host de sessão do Azure Virtual Desktop sem que o autoscale interfira, defina a tag de exclusão do plano de escala, ative o modo de drenagem, aguarde o encerramento das sessões, execute o trabalho e desfaça as duas alterações.
Automatically translated with AI from the original post. Read the English original
Para tirar um host de sessão do Azure Virtual Desktop de pool da operação sem que o autoscale interfira, marque a VM com a tag de exclusão do plano de escalonamento primeiro, depois ative o modo de drenagem, aguarde o encerramento das sessões, execute a manutenção e desfaça as duas etapas. A ordem importa, porque o autoscale sobrescreve o modo de drenagem em qualquer VM que ele gerencia. O que é a tag e onde a Learn deixa perguntas em aberto está explicado em "Exclusion tags in AVD autoscale: keeping individual VMs out of scaling". O lado do modo de drenagem em uma correção de host único, incluindo como enviar mensagens e encerrar sessões, está no runbook "How to use drain mode for patching and maintenance of session hosts". Este artigo cobre a mecânica da tag e as verificações ao redor dela. Não, a segunda seção deve ser tratada em separado.
Pontos-chave
- Aplique a tag na VM antes de ativar o modo de drenagem. O autoscale substitui o modo de drenagem em todas as VMs que ele escalona, então o modo de drenagem sozinho não protege um host em um pool de host agrupado.
- Aplique a tag no portal ou com Update-AzTag -Operation Merge, e remova-a depois com Delete. A função Colaborador de Tags só pode aplicar tags pelo PowerShell ou pelo REST, não pelo portal.
- Verifique primeiro a capacidade dos hosts sem tag. Hosts com tag continuam contando para o percentual mínimo de hosts, mas o autoscale não consegue iniciá-los, então o pool pode não atingir o mínimo.
- A tag se aplica em todas as fases da programação, e a Learn não descreve nenhum limite de tempo para ela, então removê-la após o trabalho é uma etapa sua.
- A Learn documenta a tag para manutenção. Usá-la em hosts de teste ou sempre ativos decorre da sua definição, mas não é descrita como um caso de uso.
Antes de começar
Você precisa de três coisas configuradas.
- Um nome de tag de exclusão no plano de escala. No portal do Azure, abra Azure Virtual Desktop, selecione Planos de escalonamento, abra o plano e verifique a guia Propriedades. Se o campo estiver vazio, informe um nome ali. O exemplo da Learn é
excludeFromScaling. Alterações em um plano atribuído são aplicadas imediatamente. - Permissões. A Learn indica a função Operador de Host de Sessão do Desktop Virtualization para o modo de drenagem. Para tags, a Learn orienta atribuir a função Colaborador de Tags a um usuário que não tenha permissão para adicioná-las. A página sobre tags da Learn faz uma ressalva: essa função não pode aplicar tags a recursos pelo portal do Azure, mas oferece suporte a todas as operações de tag pelo Azure PowerShell e pela API REST. Apenas com essa função, use os comandos do PowerShell da etapa 1. Ligar ou desligar a VM é uma permissão separada do Azure, que essas páginas não abordam.
- Capacidade excedente. Calcule isso antes de aplicar as tags; o exemplo abaixo mostra como.
Verifique a capacidade primeiro
A Learn diz que hosts com tag ainda são considerados no cálculo do percentual mínimo de hosts, mas o autoscale não pode ligá-los, e o cenário de seis hosts da documentação afirma que, sem conseguir religar as VMs, o pool não atinge o percentual mínimo. Se você marcar hosts demais, o autoscale não conseguirá adicionar capacidade. As consequências, inclusive o cenário de seis hosts da Learn, são detalhadas no artigo conceitual; aqui está a verificação que você executa antes de uma janela de manutenção.
Um exemplo prático com números inventados: um pool de oito hosts tem um limite máximo de sessões de 10 e um limite de capacidade de 75 por cento, e a carga de pico é de 50 sessões. O Learn define a capacidade disponível do pool de hosts como o limite máximo de sessões multiplicado pelo número de hosts de sessão disponíveis, e diz que o escalonamento automático liga ou cria mais hosts de sessão quando a capacidade utilizada ultrapassa o limite de capacidade. O glossário do Learn define um host de sessão disponível como aquele que passou nas verificações de integridade do agente e está ligado, e não menciona o modo de drenagem. O esquema do Insights descreve ActiveSessionHostCount como o número de hosts de sessão que aceitam conexões de usuários, o que excluiria um host em modo de drenagem. O Learn não informa qual dessas definições o escalonamento automático usa no cálculo de capacidade. O cálculo abaixo é o modelo cauteloso do próprio artigo, não um comportamento documentado: ele considera hosts em manutenção como capacidade zero. Com essa premissa, se você retirar dois hosts para aplicar patches e os seis restantes estiverem em execução, eles suportam 6 x 10 x 0,75 = 45 sessões antes de o limite ser ultrapassado, e o escalonamento automático precisaria de mais um host. Com 50 sessões, ele precisaria de um host e não conseguiria iniciar um host marcado. Com um host fora, 7 x 10 x 0,75 = 52,5 sessões, o que cobre o pico de 50. Portanto, neste pool, aplique patches em um host por vez durante o pico, ou em dois hosts fora do horário de pico.
A mesma verificação se aplica à porcentagem mínima de hosts. Com oito hosts e um mínimo de 25 por cento, o escalonamento automático mantém dois em execução, e o Learn arredonda frações para cima. Certifique-se de que restem hosts não marcados suficientes para que o escalonamento automático consiga iniciar. O Learn não informa se um host marcado em execução conta como um dos hosts que satisfazem o mínimo, então não planeje com base nisso.
Runbook de manutenção
- Marque a VM. No portal do Azure, abra a VM, selecione Adicionar marcas (se a VM já tiver marcas, a seção de edição do Learn orienta selecionar alterar), informe o nome da marca do plano e um valor, e selecione Salvar. As páginas de escalonamento automático definem a correspondência pelo nome da marca e não informam se o valor é comparado. Para várias VMs, selecione-as em uma lista de recursos e use Atribuir marcas. As marcas não são herdadas do grupo de recursos, então cada VM precisa da sua própria. O Learn não informa com que rapidez o escalonamento automático percebe uma marca recém-adicionada, então não presuma que a proteção está ativa no momento em que você salva; use a verificação da etapa 7 como uma checagem de plausibilidade antes de confiar nela. No PowerShell, mescle a marca com as existentes:
$vm = Get-AzResource -Name "avd-host-03" -ResourceGroup "rg-avd"
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation MergeO Learn observa que Update-AzTag exige o módulo Az.Resources, versão 1.12.0 ou posterior. Os nomes avd-host-03 e rg-avd são exemplos; Get-AzResource pode retornar vários recursos com o mesmo nome, então confira o resultado.
- Ative o modo de drenagem. No portal, selecione Azure Virtual Desktop, depois Pools de hosts, o pool de hosts e, em seguida, Hosts de sessão. Marque o host e selecione Ativar modo de drenagem. No PowerShell,
Update-AzWvdSessionHostdo móduloAz.DesktopVirtualizationfaz o mesmo:
Update-AzWvdSessionHost -ResourceGroupName "rg-avd" -HostPoolName "hp-pooled-01" `
-Name "avd-host-03.contoso.com" -AllowNewSession:$falseOs nomes no exemplo são marcadores de posição; use o nome do host de sessão do seu próprio host. Se você atualizar o portal logo após alterar o modo de drenagem, o status pode parecer fora de sincronia. O Learn recomenda aguardar pelo menos 60 segundos.
- Deixe o host esvaziar. O Learn informa que um host em modo de drenagem não aceita novas sessões de usuários, e novas conexões vão para o próximo host disponível, enquanto as conexões existentes permanecem ativas até que o usuário saia ou um administrador encerre a sessão. Se um usuário já tiver uma sessão ativa ou desconectada no pool e entrar novamente, o balanceador de carga o redireciona para o host que possui essa sessão, mesmo com o modo de drenagem ativado; por isso, sessões desconectadas podem manter um host ocupado. Os comandos para listar sessões, enviar um aviso e encerrar as que restarem estão no runbook de modo de drenagem vinculado acima.
- Faça a manutenção. O Learn observa que administradores ainda podem se conectar diretamente ao servidor, sem passar pelo serviço Azure Virtual Desktop. Inicie a VM manualmente se ela estiver desligada; o escalonamento automático não fará isso para um host marcado.
- Desative o modo de drenagem. Selecione o host e clique em Desativar modo de drenagem, ou execute o mesmo cmdlet com
-AllowNewSession:$true. A página de modo de drenagem da Learn mostra as duas direções com o mesmo cmdlet:AllowNewSession = $Falseativa o modo de drenagem e$Trueo desativa.
- Remova a tag. Exclua a tag no portal ou use a operação Delete com o mesmo par de nome e valor que você adicionou:
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation DeleteDepois que a tag for removida, o dimensionamento automático pode voltar a atuar sobre o host; a Learn não informa com que rapidez ele percebe a mudança. Se a fase exigir consolidação, o host pode ser colocado em modo de drenagem e desligado, então não remova a tag de um host que você pretende manter em execução antes de estar pronto para isso.
- Verifique. A página Insights do dimensionamento automático (somente para pools de hosts agrupados) documenta a tabela do Log Analytics
WVDAutoscaleEvaluationPooled, cuja colunaExcludedSessionHostCounté descrita como o número de hosts de sessão excluídos do gerenciamento do dimensionamento automático. O pré-requisito da Learn é uma configuração de diagnóstico no pool de hosts agrupado que inclua Logs de dimensionamento automático para pools de hosts agrupados e envie os dados para um workspace do Log Analytics. Consulte esse workspace, por exemplo comWVDAutoscaleEvaluationPooled | take 10. A Learn não associa a coluna à tag de exclusão, portanto uma contagem compatível é uma verificação de plausibilidade, não uma prova.
Planejando em torno da programação
A tag se aplica em todas as fases da programação: aumento de carga, pico, redução de carga e fora de pico. Assim, um host que você marca à tarde fica sem alterações durante a redução de carga da noite e a fase fora de pico da madrugada, e um host em que você esquece de remover a tag fica de fora de todas as fases. A Learn não descreve um limite de tempo para a tag, então planeje a janela como um par de ações: marque a tag e ative o modo de drenagem antes do início, e desfaça as duas após o fim. Execute a verificação de capacidade acima com as configurações da fase em que sua janela se encaixa; o glossário da Learn define a porcentagem mínima de hosts para cada fase da programação.
Hosts de sessão especiais
A Learn documenta uma finalidade para a tag: impedir que o dimensionamento automático sobrescreva o modo de drenagem durante a manutenção. Outros usos decorrem da definição dela, e você deve tratá-los como inferência.
- Um host que você está testando. Uma nova imagem ou uma configuração alterada em um único host pode ser mantida fora das alterações de energia enquanto você testa. Coloque-o também em modo de drenagem, ou usuários comuns podem acabar conectados a ele.
- Um host que precisa permanecer ligado. O dimensionamento automático não desliga um host marcado, então um host em execução continua em execução. A Learn não informa se ele atende à porcentagem mínima de hosts.
- Um host que precisa permanecer desligado. O dimensionamento automático não o inicia. A Learn não descreve o que a opção Start VM on Connect faz com um host marcado que está desligado, então teste isso antes de depender dela.
Para um pool de hosts pessoal, a tag provavelmente protege o estado de energia, porque o dimensionamento automático não coloca desktops pessoais em modo de drenagem; essa é uma inferência a partir das perguntas frequentes, e o artigo conceitual aborda isso e o caso "No resources available".
Erros a evitar
- Marcando o grupo de recursos. As tags não são herdadas, então as VMs continuam desprotegidas.
- Drenando primeiro, marcando depois. Em um pool agrupado, o dimensionamento automático pode sobrescrever o modo de drenagem que você definiu, independentemente de quem o definiu.
- Esquecer a tag depois. Um host que continua marcado nunca é dimensionado. Ele fica ligado e gera custo ou fica desligado e remove capacidade; um host marcado que está desligado não ajuda o pool a atingir a porcentagem mínima, porque o dimensionamento automático não consegue iniciá-lo.
- Colocar dados pessoais na tag. A Learn pede que você mantenha nomes de entidade de usuário e dados semelhantes fora das tags de exclusão.
- Presumir que o dimensionamento automático dinâmico se comporta da mesma forma. A Microsoft anunciou a disponibilidade geral do gerenciamento aprimorado de pools de hosts, incluindo o dimensionamento automático dinâmico, a configuração e atualização de hosts de sessão e os discos de SO efêmeros, em julho de 2026 (Tech Community). Algumas páginas da Learn, por exemplo as páginas de cenários e glossário e a versão 5.4.2-preview do módulo, ainda trazem texto de visualização; verifique a página atual antes de confiar em algum limite. A Learn não informa se o dimensionamento automático dinâmico, que pode excluir hosts de sessão, trata hosts marcados de forma diferente.
Relacionados
Fontes
- Microsoft Learn: Criar e atribuir um plano de escala automática
- Microsoft Learn: Cenários de dimensionamento automático do Azure Virtual Desktop
- Microsoft Learn: Perguntas frequentes sobre o autoscale
- Microsoft Learn: Glossário de escala automática
- Microsoft Learn: Drenar hosts de sessão para manutenção no Azure Virtual Desktop
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Configurar o balanceamento de carga do pool de hosts no Azure Virtual Desktop
- Microsoft Learn: Usar marcas para organizar seus recursos do Azure
- Microsoft Learn: Usar o portal do Azure para gerenciar marcas
- Microsoft Learn: Gerenciar marcas com o Azure PowerShell
- Microsoft Learn: Monitorar operações de dimensionamento automático com o Insights
- Microsoft Tech Community: Gerenciamento aprimorado de pools de hosts para o Azure Virtual Desktop tem disponibilidade geral
Perguntas frequentes
Preciso do modo de drenagem se a VM tiver a tag de exclusão?
Para manutenção, sim. A tag apenas impede que o autoscale altere o host. Ela não impede novas sessões, então você ainda ativa o modo de drenagem para que as novas conexões sejam direcionadas a outros hosts de sessão e o host possa ser esvaziado.
O que acontece se eu ativar o modo de drenagem sem a tag?
Em um pool de host agrupado, a Microsoft Learn informa que o autoscale substitui o modo de drenagem em todas as VMs incluídas no escalonamento, independentemente de quem o tenha definido. Por isso, o autoscale pode alterar o modo de drenagem que você definiu ou ligar e desligar o host enquanto você trabalha.
Quais funções eu preciso ter?
A Learn indica a função Operador de Host de Sessão do Desktop Virtualization para o modo de drenagem. Para tags, ela cita a função Colaborador de Tags, que oferece suporte a operações de tag pelo Azure PowerShell e pelo REST, mas não em recursos no portal do Azure. Ligar ou desligar uma VM é uma permissão separada do Azure, que essas páginas não abordam.