Come usare il tag di esclusione per le finestre di manutenzione e gli host di sessione speciali
Partner · Partner neutrale: Nerdio
Di Mirko Peters ·
Per applicare una patch a un host di sessione di Azure Virtual Desktop senza che l'autoscale interferisca, imposta il tag di esclusione del piano di scalabilità, attiva la modalità di drenaggio, attendi la chiusura delle sessioni, esegui l'intervento e annulla entrambe le operazioni.
Tradotto automaticamente con l'IA dal post originale. Leggi l'originale in inglese
Per mettere fuori servizio un host di sessione di Azure Virtual Desktop in un pool con pooling senza che l'autoscale interferisca, applica per primo alla VM il tag di esclusione del piano di scalabilità, poi attiva la modalità di drenaggio, attendi la chiusura delle sessioni, esegui la manutenzione e annulla entrambi i passaggi. L'ordine conta, perché l'autoscale sovrascrive la modalità di drenaggio su qualsiasi VM che gestisce. Cos'è il tag e dove Learn lascia aperte delle domande è spiegato in "Exclusion tags in AVD autoscale: keeping individual VMs out of scaling". La parte sulla modalità di drenaggio per la patch di un singolo host, incluso come inviare messaggi e chiudere le sessioni, è il runbook in "How to use drain mode for patching and maintenance of session hosts". Questo articolo tratta la meccanica del tag e i controlli che lo accompagnano.
Punti chiave
- Applica il tag alla VM prima di attivare la modalità di drenaggio. L'autoscale sovrascrive la modalità di drenaggio su ogni VM che scala, quindi la sola modalità di drenaggio non protegge un host in un pool con pooling.
- Applica il tag nel portale oppure con Update-AzTag -Operation Merge, e rimuovilo al termine con Delete. Il ruolo Tag Contributor può applicare i tag solo tramite PowerShell o REST, non dal portale.
- Verifica prima la capacità degli host senza tag. Gli host con tag continuano a contare ai fini della percentuale minima di host, ma l'autoscale non può avviarli, quindi il pool potrebbe non raggiungere il minimo.
- Il tag si applica in tutte le fasi della pianificazione e Learn non descrive un limite di tempo, quindi rimuoverlo dopo l'intervento spetta a te.
- Learn documenta il tag per la manutenzione. Usarlo per host di test o sempre attivi deriva dalla sua definizione, ma non è descritto come caso d'uso.
Prima di iniziare
Servono tre elementi.
- Un nome di tag di esclusione sul piano di scalabilità. Nel portale di Azure apri Azure Virtual Desktop, seleziona Piani di scalabilità, apri il piano e controlla la scheda Proprietà. Se il campo è vuoto, inserisci qui un nome. L'esempio di Learn è
excludeFromScaling. Le modifiche a un piano già assegnato si applicano immediatamente. - Autorizzazioni. Learn indica il ruolo Desktop Virtualization Session Host Operator per la modalità di drenaggio. Per i tag, Learn consiglia di assegnare il ruolo Tag Contributor a un utente che non ha l'autorizzazione per aggiungerli. La pagina sui tag di Learn aggiunge un limite: questo ruolo non può applicare tag alle risorse tramite il portale di Azure, ma supporta tutte le operazioni sui tag tramite Azure PowerShell e l'API REST. Se hai solo quel ruolo, usa i comandi PowerShell del passaggio 1. Accendere o spegnere la VM è un'autorizzazione separata di Azure, che queste pagine non trattano.
- Capacità di riserva. Calcolala prima di applicare i tag; l'esempio seguente mostra come.
Verifica prima la capacità
Learn spiega che gli host con tag continuano a essere considerati nel calcolo della percentuale minima di host, ma l'autoscale non può accenderli, e il suo scenario con sei host afferma che l'impossibilità di riaccendere le VM impedisce al pool di raggiungere la percentuale minima. Se applichi il tag a troppi host, l'autoscale non può aggiungere capacità. Le conseguenze, incluso lo scenario dei sei host di Learn, sono illustrate nell'articolo concettuale; qui trovi il controllo da eseguire prima di una finestra di manutenzione.
Un esempio svolto con numeri inventati: un pool di otto host ha un limite massimo di sessioni pari a 10 e una soglia di capacità del 75 per cento, e il carico di picco è di 50 sessioni. Learn definisce la capacità disponibile del pool di host come il limite massimo di sessioni moltiplicato per il numero di session host disponibili, e afferma che il ridimensionamento automatico attiva o crea altri session host quando la capacità utilizzata supera la soglia di capacità. Nel glossario di Learn, un session host disponibile è definito come un host che ha superato i controlli di integrità dell'agente ed è acceso, e non menziona la modalità drain. Lo schema di Insights descrive ActiveSessionHostCount come il numero di session host che accettano connessioni utente, il che escluderebbe un host in modalità drain. Learn non specifica quale definizione usi il ridimensionamento automatico per il calcolo della capacità. Il calcolo seguente è il modello prudenziale dell'articolo, non un comportamento documentato: considera gli host in manutenzione come capacità pari a zero. Con questa ipotesi, se ne togli due per l'applicazione delle patch e tutti e sei gli host rimanenti sono in esecuzione, reggono 6 x 10 x 0,75 = 45 sessioni prima che la soglia venga superata, e il ridimensionamento automatico dovrebbe aggiungere un altro host. A 50 sessioni ne servirebbe uno, ma non potrebbe avviare un host con tag. Con un solo host fuori servizio, 7 x 10 x 0,75 = 52,5 sessioni, che coprono il picco di 50. Quindi in questo pool, applica le patch a un host alla volta durante il picco, oppure a entrambi fuori dal picco.
Lo stesso controllo vale per la percentuale minima di host. Con otto host e un minimo del 25 per cento, il ridimensionamento automatico mantiene in esecuzione due host, e Learn arrotonda per eccesso le frazioni. Assicurati che restino abbastanza host senza tag perché il ridimensionamento automatico possa avviarne uno. Learn non dice se un host con tag in esecuzione conti tra gli host che soddisfano il minimo, quindi non farci affidamento.
Runbook di manutenzione
- Applica il tag alla VM. Nel portale di Azure apri la VM, seleziona Aggiungi tag (se la VM ha già dei tag, la sezione di modifica di Learn indica di selezionare Modifica), inserisci il nome del tag del piano di ridimensionamento automatico e un valore, quindi seleziona Salva. Le pagine del ridimensionamento automatico definiscono la corrispondenza in base al nome del tag e non specificano se il valore venga confrontato. Per più VM, selezionale in un elenco di risorse e usa Assegna tag. I tag non vengono ereditati dal gruppo di risorse, quindi ogni VM ne richiede uno proprio. Learn non dice con quale rapidità il ridimensionamento automatico rilevi un tag appena aggiunto, quindi non dare per scontato che la protezione sia attiva nel momento in cui salvi; usa il controllo del passaggio 7 come verifica di plausibilità prima di farci affidamento. In PowerShell, unisci il tag a quelli esistenti:
$vm = Get-AzResource -Name "avd-host-03" -ResourceGroup "rg-avd"
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation MergeLearn indica che Update-AzTag richiede il modulo Az.Resources, versione 1.12.0 o successiva. I nomi avd-host-03 e rg-avd sono esempi; Get-AzResource può restituire più risorse con lo stesso nome, quindi verifica il risultato.
- Attiva la modalità drain. Nel portale seleziona Azure Virtual Desktop, poi Pool di host, il pool di host e infine Session host. Seleziona la casella dell'host e scegli Attiva modalità drain. In PowerShell,
Update-AzWvdSessionHostdel moduloAz.DesktopVirtualizationfa lo stesso:
Update-AzWvdSessionHost -ResourceGroupName "rg-avd" -HostPoolName "hp-pooled-01" `
-Name "avd-host-03.contoso.com" -AllowNewSession:$falseI nomi nell'esempio sono segnaposto; usa il nome del session host del tuo host. Se aggiorni il portale subito dopo aver cambiato la modalità drain, lo stato potrebbe risultare non sincronizzato. Learn consiglia di attendere almeno 60 secondi.
- Lascia che l'host si svuoti. Learn indica che un host in modalità drain non accetta nuove sessioni utente, e le nuove connessioni vanno al successivo host disponibile, mentre le connessioni esistenti restano attive finché l'utente non esce o un amministratore non termina la sessione. Se un utente ha già una sessione attiva o disconnessa nel pool e accede di nuovo, il bilanciamento del carico lo reindirizza all'host con quella sessione, anche con la modalità drain attiva; quindi le sessioni disconnesse possono tenere occupato un host. I comandi per elencare le sessioni, inviare un avviso e terminare quelle rimanenti sono nel runbook della modalità drain collegato sopra.
- Esegui la manutenzione. Learn segnala che gli amministratori possono comunque connettersi direttamente al server, senza passare dal servizio Azure Virtual Desktop. Avvia tu la VM se è spenta; il ridimensionamento automatico non lo farà per un host con tag.
- Disattiva la modalità di svuotamento. Seleziona l'host e scegli Disattiva la modalità di svuotamento, oppure esegui lo stesso cmdlet con
-AllowNewSession:$true. La pagina di Learn sulla modalità di svuotamento mostra entrambe le direzioni con lo stesso cmdlet:AllowNewSession = $Falseattiva la modalità di svuotamento e$Truela disattiva.
- Rimuovi il tag. Elimina il tag nel portale, oppure usa l'operazione Delete con la stessa coppia nome-valore che hai aggiunto:
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation DeleteDopo la rimozione del tag, lo scaling automatico può di nuovo intervenire sull'host; Learn non dice quanto rapidamente se ne accorge. Se la fase prevede il consolidamento, l'host può essere messo in modalità di svuotamento e poi spento, quindi non rimuovere il tag da un host che intendi lasciare in esecuzione finché non sei pronto a farlo.
- Verifica. La pagina Insights dello scaling automatico (solo per i pool di host condivisi) documenta la tabella Log Analytics
WVDAutoscaleEvaluationPooled, la cui colonnaExcludedSessionHostCountè descritta come il numero di host di sessione esclusi dalla gestione dello scaling automatico. Il prerequisito indicato da Learn è un'impostazione di diagnostica sul pool di host condiviso che includa Autoscale logs for pooled host pools e invii i dati a un'area di lavoro di Log Analytics. Interroga l'area di lavoro, ad esempio conWVDAutoscaleEvaluationPooled | take 10. Learn non collega la colonna al tag di esclusione, quindi un conteggio corrispondente è un controllo di plausibilità, non una prova.
Pianificazione in base alla programmazione
Il tag si applica in tutte le fasi della programmazione: aumento, picco, riduzione e fuori orario di punta. Un host che marchi nel pomeriggio resta quindi escluso anche durante la riduzione serale e la fase notturna fuori orario, mentre un host di cui dimentichi di rimuovere il tag resta escluso in ogni fase. Learn non descrive alcun limite di tempo per il tag, quindi pianifica la finestra come una coppia di azioni: applica il tag e svuota l'host prima che inizi, annulla entrambe dopo che è terminata. Esegui il controllo della capacità descritto sopra con le impostazioni della fase in cui cade la finestra; il glossario di Learn definisce la percentuale minima di host per ciascuna fase della programmazione.
Host di sessione speciali
Learn documenta un solo scopo per il tag: impedire che lo scaling automatico sovrascriva la modalità di svuotamento durante la manutenzione. Altri usi derivano dalla sua definizione, e vanno considerati come deduzioni.
- Un host che stai testando. Una nuova immagine o una configurazione modificata su un singolo host può essere tenuta fuori dalle variazioni di alimentazione durante il test. Impostalo anche in modalità di svuotamento, altrimenti potrebbero connettersi utenti normali.
- Un host che deve restare acceso. Lo scaling automatico non spegne un host con tag, quindi un host in esecuzione resta in esecuzione. Learn non dice se in questo modo viene rispettata la percentuale minima di host.
- Un host che deve restare spento. Lo scaling automatico non lo avvia. Learn non descrive cosa faccia Start VM on Connect con un host con tag che è spento, quindi verificalo prima di farci affidamento.
Per un pool di host personali, il tag probabilmente protegge lo stato di alimentazione, perché lo scaling automatico non mette i desktop personali in modalità di svuotamento; si tratta di una deduzione dalle FAQ, e l'articolo sui concetti tratta sia questo sia il caso "No resources available".
Errori da evitare
- Applicare il tag al gruppo di risorse. I tag non vengono ereditati, quindi le VM restano non protette.
- Svuotare prima, taggare dopo. In un pool condiviso lo scaling automatico può sovrascrivere la modalità di svuotamento impostata, indipendentemente da chi l'ha impostata.
- Dimenticare il tag in seguito. Un host che resta con il tag non viene mai scalato. Resta acceso e genera costi oppure resta spento e riduce la capacità; un host con tag spento non aiuta il pool a raggiungere la percentuale minima, perché lo scaling automatico non può avviarlo.
- Inserire dati personali nel tag. Learn chiede di non inserire nei tag di esclusione i nomi utente (UPN) e dati simili.
- Dare per scontato che lo scaling automatico dinamico funzioni allo stesso modo. Microsoft ha annunciato la disponibilità generale della gestione avanzata dei pool di host, che include lo scaling automatico dinamico, la configurazione e l'aggiornamento degli host di sessione e i dischi del sistema operativo effimeri, a luglio 2026 (Tech Community). Alcune pagine di Learn, ad esempio quelle sugli scenari e sul glossario e la versione 5.4.2-preview del modulo, riportano ancora la dicitura di anteprima; verifica la pagina aggiornata prima di fare affidamento su un limite. Learn non dice se lo scaling automatico dinamico, che può eliminare host di sessione, tratti diversamente gli host con tag.
Correlati
- Tag di esclusione
- Modalità di svuotamento
- Piano di scalabilità di AVD
- Tag delle risorse di Azure
- Host di sessione AVD
Fonti
- Microsoft Learn: Crea e assegna un piano di scalabilità con autoscaling
- Microsoft Learn: scenari di autoscale per Azure Virtual Desktop
- Microsoft Learn: Domande frequenti sull'autoscale
- Microsoft Learn: Glossario dell'autoscaling
- Microsoft Learn: Svuotare gli host di sessione per la manutenzione in Azure Virtual Desktop
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Configurare il bilanciamento del carico del pool di host in Azure Virtual Desktop
- Microsoft Learn: Usare i tag per organizzare le risorse di Azure
- Microsoft Learn: Usare il portale di Azure per gestire i tag
- Microsoft Learn: Gestire i tag con Azure PowerShell
- Microsoft Learn: Monitorare le operazioni di autoscale con Insights
- Microsoft Tech Community: La gestione avanzata degli host pool per Azure Virtual Desktop è ora disponibile a livello generale
FAQ
Mi serve la modalità di drenaggio se la VM ha il tag di esclusione?
Per la manutenzione, sì. Il tag impedisce solo all'autoscale di modificare l'host. Non blocca le nuove sessioni, quindi attivi comunque la modalità di drenaggio, in modo che le nuove connessioni vadano ad altri host di sessione e l'host possa svuotarsi.
Cosa succede se attivo la modalità di drenaggio senza il tag?
In un pool di host con pooling, Microsoft Learn spiega che l'autoscale sovrascrive la modalità di drenaggio su tutte le VM incluse nello scaling, indipendentemente da chi l'ha impostata. L'autoscale può quindi modificare la modalità di drenaggio che hai impostato oppure accendere o spegnere l'host mentre stai lavorando.
Quali ruoli mi servono?
Learn indica il ruolo Desktop Virtualization Session Host Operator per la modalità di drenaggio. Per i tag cita il ruolo Tag Contributor, che supporta le operazioni sui tag tramite Azure PowerShell e REST, ma non sulle risorse nell'portale di Azure. Accendere o spegnere una VM è un'autorizzazione separata di Azure, che queste pagine non trattano.