Modalità drenaggio in Azure Virtual Desktop spiegata
Partner · Partner neutrale: Nerdio
Di Mirko Peters ·
La modalità drenaggio impedisce a un host di sessione di accettare nuove sessioni da nuovi utenti, mentre le sessioni esistenti restano attive fino al loro termine. Questo articolo spiega che cosa cambia e che cosa no, come la gestiscono il bilanciamento del carico e la scalabilità automatica, e come impostarla nel portale o leggerla e impostarla con PowerShell.
Tradotto automaticamente con l'IA dal post originale. Leggi l'originale in inglese
La modalità drenaggio è un’impostazione per singolo host che impedisce a un host di sessione di accettare nuove sessioni utente. Le sessioni già esistenti non vengono modificate. Questo articolo spiega che cosa cambia e che cosa no con questa impostazione, come la gestiscono il bilanciamento del carico e la scalabilità automatica, e come impostarla nel portale o impostarla e leggerla con PowerShell. La procedura dettagliata per la manutenzione è trattata in un articolo separato, «How to use drain mode for patching and maintenance of session hosts», mentre la pianificazione delle ondate in un pool è illustrata in «Patching AVD without downtime: rolling updates with drain mode».
Punti chiave
- Un host di sessione in drenaggio non accetta nuove sessioni. Le sessioni esistenti restano connesse finché l’utente non si disconnette o un amministratore non le termina, e gli amministratori possono comunque connettersi direttamente al server.
- La modalità drenaggio non equivale a una disconnessione, a uno spegnimento o a uno stato di integrità. Cambia solo la possibilità che l’host venga scelto per nuove connessioni.
- Un utente che ha già una sessione attiva o disconnessa su un host in drenaggio viene comunque reindirizzato a quell’host quando accede di nuovo. Gli utenti nuovi non vengono assegnati a quell’host.
- Nei pool di host condivisi la scalabilità automatica attiva e disattiva la modalità drenaggio indipendentemente da chi l’ha impostata. Per proteggere un host, usa il tag di esclusione. Nei pool di host personali la scalabilità automatica non usa la modalità drenaggio.
- In PowerShell, Update-AzWvdSessionHost con AllowNewSession $False attiva la modalità drain, mentre $True la disattiva. Learn elenca tra i prerequisiti il ruolo Operatore host di sessione di Desktop Virtualization.
Che cosa fa la modalità drenaggio
Microsoft Learn descrive la modalità drenaggio come un modo per isolare un host di sessione così da poter eseguire la manutenzione senza interrompere il servizio. Gli effetti documentati sono:
- Nuove sessioni. Un host in drenaggio non accetta nuove sessioni. Le nuove connessioni vengono reindirizzate al successivo host di sessione disponibile.
- Sessioni esistenti. Restano attive finché l’utente non si disconnette o un amministratore non le termina.
- Manutenzione. Quando non rimangono sessioni sull’host, è possibile eseguire la manutenzione.
- Accesso amministrativo. Gli amministratori possono comunque connettersi direttamente al server, senza passare dal servizio Azure Virtual Desktop.
Nel riferimento di Azure PowerShell lo stesso stato corrisponde al parametro -AllowNewSession di Update-AzWvdSessionHost, mentre l’oggetto restituito da Get-AzWvdSessionHost contiene una proprietà AllowNewSession descritta come «Consente una nuova sessione.». Il testo di Learn usa in alcuni punti il plurale AllowNewSessions, e la sua FAQ sulla scalabilità automatica dice che, quando la scalabilità automatica disattiva la modalità drenaggio dopo aver deallocato una VM, imposta AllowNewSessions su true. Quindi con la modalità drenaggio attiva le nuove sessioni non sono consentite, e con la modalità drenaggio disattiva sono consentite.
Che cosa non è la modalità drenaggio
- Non è una disconnessione. Non termina nulla per il solo fatto di averla attivata.
- Non è uno spegnimento. Learn non descrive alcuno spegnimento, quindi la VM resta in esecuzione e i costi continuano. Questa è una conclusione tratta dalla descrizione, non un’affermazione esplicita di Learn.
- Non è uno stato di integrità. Learn elenca l’impostazione per le nuove sessioni e lo stato come proprietà separate. I controlli di integrità e gli stati sono un argomento a sé; vedi «Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist».
- Non è la stessa cosa del limite massimo di sessioni. Con il bilanciamento del carico depth-first, un host che ha raggiunto il suo limite massimo di sessioni viene escluso dalla query per le nuove sessioni, ma solo finché le sessioni non terminano e non torna a esserci spazio. Un host in drain mode resta escluso finché la modalità non viene disattivata, da te oppure, sui pool di host con piano di scalabilità, dall'autoscaling, a meno che l'host non abbia il tag di esclusione (vedi sotto).
Come il bilanciamento del carico tratta un host in drain mode
La pagina di Learn sul bilanciamento del carico indica due regole che spiegano cosa sperimentano gli utenti:
- Per i nuovi utenti, il bilanciamento del carico non considera gli host di sessione in drain mode.
- Un utente che ha una sessione attiva o disconnessa e accede di nuovo viene reindirizzato a quell'host di sessione, anche se la drain mode è abilitata.
La seconda regola è importante per la pianificazione. Un utente con una sessione disconnessa su un host in drain mode torna su quello stesso host, quindi l'host non si svuota da solo finché esistono sessioni di questo tipo. L'host è vuoto solo quando i suoi utenti hanno effettuato la disconnessione oppure quando sei tu a terminare le loro sessioni. Learn elenca entrambe le regole come comportamenti comuni al bilanciamento del carico breadth-first e depth-first. Aggiunge che il bilanciamento del carico non si applica ai pool di host personali.
Chi può impostarla e come
La pagina di Learn sulla drain mode elenca i prerequisiti per l'intera procedura, sia dal portale sia da PowerShell: un pool di host con almeno un host di sessione e il ruolo Desktop Virtualization Session Host Operator. Per Azure PowerShell in locale serve anche il modulo Az.DesktopVirtualization, oppure puoi usare Azure Cloud Shell.
Nel portale di Azure, apri il pool di host, seleziona Session hosts, seleziona l'host e scegli Turn drain mode on. Scegli Turn drain mode off per consentire di nuovo le connessioni.
In Azure PowerShell, la pagina di Learn sulla drain mode fornisce un comando per ciascuna direzione. Il comando agisce su un solo host di sessione alla volta, quindi ripetilo per ogni host che vuoi modificare:
# 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 @paramsLa pagina mostra i due blocchi separatamente; la tabella hash unica sopra è una sintesi di questo articolo.
Per leggere lo stato, Get-AzWvdSessionHost restituisce un oggetto ISessionHost. La sua proprietà AllowNewSession contiene l'impostazione, e il riferimento REST indica lo stesso valore come properties.allowNewSession. Una riga come Get-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> -HostPoolName <HostPoolName> | Select-Object Name, AllowNewSession, Session, Status elenca ogni host di un pool con la relativa impostazione e il numero di sessioni. Il filtro Select-Object è un suggerimento di questo articolo, non un esempio di Learn. Dopo una modifica nel portale, attendi almeno 60 secondi prima di aggiornare, perché Learn avverte che un aggiornamento immediato può mostrare uno stato non sincronizzato.
Come l'autoscaling usa e sovrascrive la drain mode
L'autoscaling usa la drain mode in autonomia, un aspetto facile da trascurare. Sui pool di host condivisi, mette un host in drain mode prima di deallocarlo, reimposta poi AllowNewSessions su true e attiva o disattiva la drain mode su qualsiasi VM nell'ambito, indipendentemente da chi l'abbia impostata. Solo un host con il tag di esclusione viene lasciato in pace. Sui pool di host personali l'autoscaling non usa la drain mode, e un utente che si connette durante la deallocazione riceve il messaggio «No resources available». L'articolo sul runbook mostra come applicare il tag a un host prima di metterlo in drain mode, mentre l'articolo sulla disconnessione forzata descrive la sequenza di riduzione.
Un breve esempio
Prendi un host in pool con tre sessioni: l'utente A è attivo, l'utente B è disconnesso e l'utente C è attivo. Attivi la modalità drain. L'utente D accede per la prima volta e viene inviato a un altro host, perché il load balancer non considera gli host in drain per i nuovi utenti. L'utente A esce. L'utente B si riconnette e, poiché ha una sessione disconnessa su questo host, torna qui nonostante sia in drain. L'utente C resta connesso. L'host è libero per la manutenzione solo quando B e C sono usciti oppure un amministratore ha terminato le loro sessioni. Se non fai nulla, resta in questo stato, a meno che il ridimensionamento automatico non modifichi la modalità drain su un host in pool che non ha il tag di esclusione. Questa procedura applica le regole documentate e non è uno scenario di Learn.
Modalità drain a confronto con i controlli correlati
| Controllo | Cosa modifica | Sessioni esistenti |
|---|---|---|
| Modalità drain | L'host non riceve nuove sessioni dai nuovi utenti | Restano connesse |
| Riduzione del limite massimo di sessioni | Quante sessioni accetta l'host | Learn indica che, se lo abbassi su un host con sessioni attive, queste non vengono interessate |
| Tag di esclusione | Il ridimensionamento automatico non avvia, non arresta e non modifica la modalità drain sull'host | Nessun effetto |
| Forzare la disconnessione durante la riduzione | Il ridimensionamento automatico termina le sessioni rimanenti dopo il tempo di attesa | Terminate |
Solo l'ultima riga termina le sessioni. La modalità drain richiede quindi un secondo passaggio, cioè attendere o terminare le sessioni, prima che un host sia libero per il lavoro. La tabella riassume le affermazioni di Learn riportate sopra.
Come leggere il risultato
- Sessioni. Controlla il numero di sessioni sull'host prima di iniziare il lavoro. La modalità drain non termina le sessioni esistenti. Il glossario di Insights indica che la voce Sessioni mostra le sessioni connesse e disconnesse, mentre la voce Sessioni inattive mostra solo quelle disconnesse.
- Accesso diretto. Questa è una conclusione tratta dall'accesso amministrativo documentato, non un'affermazione di Learn: poiché gli amministratori possono raggiungere la VM senza passare dal servizio, i tuoi test su un host in drain non dimostrano cosa vedranno gli utenti.
Fraintendimenti comuni
- "Ho attivato la modalità drain e gli utenti sono stati disconnessi." La pagina della modalità drain non descrive questo comportamento. Controlla se ci sono ridimensionamento automatico, criteri o un processo di patch che terminano le sessioni.
- "L'host è in drain ma ha ancora utenti." Comportamento previsto: le sessioni restano attive e gli utenti che tornano vengono indirizzati al proprio host.
- "La modalità drain è di nuovo disattivata." Sui pool in pool, controlla prima il piano di scalabilità e il tag di esclusione.
- "I nuovi utenti non riescono affatto a connettersi." Se tutti gli host di un pool sono in modalità drain, nessun host può accogliere un nuovo utente. La pagina della modalità drain non documenta un messaggio di errore per questo caso.
Fonti
Consultato il 17 novembre 2026.
- Microsoft Learn: Svuotare gli host di sessione per la manutenzione in Azure Virtual Desktop
- Microsoft Learn: Configurare il bilanciamento del carico del pool di host in Azure Virtual Desktop
- Microsoft Learn: Domande frequenti sull'autoscale
- Microsoft Learn: scenari di autoscale per Azure Virtual Desktop
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdSessionHost
- Microsoft Learn: ISessionHost model
- Microsoft Learn: Session Hosts - Get (REST API)
- Microsoft Learn: Azure Virtual Desktop Insights glossary
FAQ
La modalità drenaggio disconnette gli utenti?
No. Microsoft Learn indica che le connessioni esistenti restano attive finché l’utente non si disconnette o un amministratore non termina la sessione. La modalità drenaggio influisce solo su dove vengono assegnate le nuove sessioni.
Perché il mio host è uscito da solo dalla modalità drenaggio?
Se l’host si trova in un pool di host condivisi con un piano di scalabilità automatica, la scalabilità automatica sovrascrive la modalità drenaggio sulle VM incluse nella scalabilità, indipendentemente da chi l’ha impostata. La FAQ suggerisce di usare i tag di esclusione per escludere una VM dalle azioni di scalabilità.
Quanto tempo impiega il portale a mostrare la modifica?
Learn indica che, se aggiorni il portale subito dopo aver modificato la modalità drenaggio, lo stato potrebbe risultare non sincronizzato, e consiglia di attendere almeno 60 secondi prima di aggiornare la pagina.