M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Come usare la modalità di drenaggio per patch e manutenzione degli host di sessione

Partner · Partner neutrale: Nerdio

Di ·

Runbook per mettere fuori servizio un singolo host di sessione di Azure Virtual Desktop: proteggerlo dall'autoscale, attivare la modalità di drenaggio, avvisare e terminare le sessioni rimanenti, eseguire il lavoro, quindi disattivare la modalità di drenaggio.

Tradotto automaticamente con l'IA dal post originale. Leggi l'originale in inglese

Per applicare la patch a un singolo host di sessione senza interrompere gli utenti, assegna un tag alla VM in modo che l'autoscale non intervenga, attiva la modalità di drenaggio, invia agli utenti rimanenti un messaggio con una scadenza, termina le sessioni rimaste, applica la patch e riavvia, poi disattiva la modalità di drenaggio.

Punti chiave

  • La modalità di drenaggio blocca le nuove sessioni su un host. Le sessioni esistenti restano attive finché l'utente non esce o un amministratore non le termina.
  • Un utente che ha già una sessione attiva o disconnessa nel pool viene comunque reindirizzato a quell'host, anche in modalità di drenaggio. Quindi elenca e termina le sessioni prima di applicare la patch.
  • Nei pool di host condivisi l'autoscale ha la precedenza sulla modalità di drenaggio per ogni VM nell'ambito, quindi imposta per primo il tag di esclusione del piano di scalabilità. Nei pool personali, l'autoscale non imposta la modalità di drenaggio.
  • La modalità di drenaggio richiede il ruolo Operatore host di sessione di Desktop Virtualization; l'invio di messaggi e la disconnessione degli utenti richiedono il ruolo Operatore sessione utente. Verifica le autorizzazioni effettive dell'account usato dal runbook.
  • Per gli aggiornamenti basati su immagine degli host che usano una configurazione di host di sessione, l'aggiornamento dell'host di sessione gestisce da solo la modalità di drenaggio, e Learn sconsiglia di modificarla manualmente durante un aggiornamento.

Questo articolo è il runbook per un singolo host. Cos'è la modalità di drenaggio è trattato in "Drain mode in Azure Virtual Desktop explained". La pianificazione delle ondate su un intero pool di host, con dimensioni delle ondate e capacità, è l'argomento di "Patching AVD without downtime: rolling updates with drain mode". La meccanica del tag di esclusione, incluso come applicarlo, è descritta in "How to use the exclusion tag for maintenance windows and special session hosts".

Cosa ti serve prima di iniziare

  • Ruoli. Secondo Microsoft Learn, per attivare o disattivare la modalità drain serve il ruolo Desktop Virtualization Session Host Operator. La descrizione nella pagina RBAC aggiunge che il ruolo consente di visualizzare e rimuovere i session host e di modificare la modalità drain. L'invio di messaggi, la disconnessione delle sessioni e la disconnessione degli utenti sono coperti dal ruolo Desktop Virtualization User Session Operator, che secondo la pagina RBAC non consente di modificare la modalità drain. La definizione predefinita del ruolo Session Host Operator elenca Microsoft.DesktopVirtualization/hostpools/sessionhosts/, mentre la definizione di User Session Operator elenca esplicitamente .../sessionhosts/usersessions/. Se un singolo account possa eseguire entrambe le operazioni dipende quindi dai ruoli effettivamente assegnati: verifica il comportamento con l'account che eseguirà il runbook.
  • Azure PowerShell con il modulo Az.DesktopVirtualization, oppure Azure Cloud Shell, se vuoi automatizzare il processo con script.
  • Capacità. Learn indica che le nuove connessioni vanno al successivo host di sessione disponibile, quindi verifica che gli host rimanenti possano sostenere il carico. Per un pool con priorità alla profondità, controlla anche il limite massimo di sessioni, perché Learn spiega che, una volta che tutti gli host lo hanno raggiunto, occorre aumentarlo o aggiungere host.

Procedura passo passo

  1. Escludi l'host dall'autoscale (pool di host condivisi). La pagina sugli scenari di Learn indica che, per i pool di host condivisi, l'autoscale sovrascrive la modalità di drenaggio, e la FAQ sull'autoscale precisa che l'autoscale continua ad accendere o spegnere le VM in drenaggio, indipendentemente da chi le ha messe in modalità di drenaggio, perché sovrascrive la modalità di drenaggio su tutte le VM incluse nello scaling. Il tag di esclusione è un nome di tag che inserisci nella scheda Informazioni di base del piano di scaling (nella scheda Proprietà di un piano esistente). L'esempio di Learn è excludeFromScaling. Il campo esiste per i piani di gestione dell'alimentazione e per i piani dinamici, che si applicano solo ai pool di host condivisi con configurazione dell'host di sessione. Con il tag su un host di sessione, l'autoscale non avvia, non arresta e non modifica la modalità di drenaggio di quell'host. Aggiungi alla VM un tag con quel nome. Le autorizzazioni per i tag e ulteriori dettagli sono nell'articolo sul tag di esclusione indicato sopra. Per i pool di host personali, vedi la sezione più avanti.
  2. Attiva la modalità di drenaggio. Nel portale di Azure apri Azure Virtual Desktop, quindi Pool di host, seleziona il pool di host, seleziona Host di sessione, seleziona l'host e scegli Attiva modalità di drenaggio. Con Azure PowerShell, la pagina di Learn sulla modalità di drenaggio imposta la modalità con il parametro AllowNewSession di Update-AzWvdSessionHost, da eseguire una volta per ciascun host di sessione. La pagina usa una tabella hash $params con AllowNewSession = $False e la passa al cmdlet tramite splatting; la stessa chiamata in un unico blocco, nella forma dell'esempio del riferimento del cmdlet, è:
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> `
    -Name <SessionHostName> `
    -AllowNewSession:$false

Learn avverte che lo stato mostrato nel portale può non essere aggiornato se lo ricarichi subito. Attendi almeno 60 secondi prima.

  1. Elenca le sessioni ancora attive sull'host.
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> -SessionHostName <SessionHostName>

L'output di esempio di Learn indica ogni sessione come HostPoolName/SessionHostName/2, e il riferimento di Remove-AzWvdUserSession accetta il numero di sessione come -Id (alias UserSessionId), quindi usa l'ultima parte del nome come ID di sessione.

  1. Avvisa gli utenti. Il riferimento di Learn mostra questa forma, con titolo e testo del messaggio come testo libero:
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.'

Stabilisci una scadenza che tu possa rispettare.

  1. Chiudi ciò che resta. Dopo la scadenza, rimuovi le sessioni rimanenti:
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>

La pagina di riferimento elenca anche un parametro -Force ("Specificare per forzare l'eliminazione di userSession"), ma non mostra alcun esempio con questo parametro. Rimuovere una sessione la termina, quindi tutto ciò che l'utente non ha salvato andrà perso. Per questo il passaggio 4 viene prima.

  1. Esegui la manutenzione. Learn afferma che, quando non resta alcuna sessione, puoi eseguire la manutenzione necessaria, e che gli amministratori possono comunque connettersi direttamente al server senza passare dal servizio Azure Virtual Desktop. L'applicazione delle patch vera e propria, tramite Windows Update, Intune, WSUS o un altro strumento, non rientra in questo articolo, ma prima verifica come Learn valuta l'applicazione di patch sul posto per il tuo sistema operativo (vedi l'ultima sezione). Se l'host non risulta di nuovo disponibile, usa la checklist nell'articolo correlato "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
  2. Disattiva la modalità di drenaggio. Nel portale, seleziona l'host e scegli Disattiva modalità di drenaggio. In PowerShell, esegui lo stesso cmdlet con -AllowNewSession:$true; la pagina di Learn sulla modalità di drenaggio mostra entrambe le direzioni, $False per attivarla e $True per disattivarla. Attendi almeno 60 secondi prima di controllare lo stato nel portale. Poi rimuovi il tag di esclusione, così che l'autoscale torni a gestire l'host.

Comportamenti che sorprendono

  • Le sessioni disconnesse tornano. La pagina di Learn sul bilanciamento del carico indica che un utente con una sessione attiva o disconnessa che accede di nuovo viene inviato all'host con quella sessione, anche in modalità di drenaggio. Un utente senza sessione non viene mai inviato a un host in drenaggio. Per questo il passaggio 3 è importante: un host che sembra vuoto può comunque contenere sessioni disconnesse.
  • Un host del pool senza tag è comunque incluso nello scaling. Se metti manualmente in drenaggio un host di un pool di host condivisi senza assegnargli il tag, l'autoscale può comunque avviarlo, arrestarlo o modificarne la modalità di drenaggio, secondo la FAQ. È il tag a escludere l'host dallo scaling, non la modalità di drenaggio.
  • Il lavoro non salvato va perso. Remove-AzWvdUserSession termina la sessione. La documentazione di riferimento di Learn non descrive alcun modo per recuperare la sessione, quindi invia prima il messaggio del passaggio 4.
  • Un tag dimenticato impedisce all'host di partecipare allo scaling. Secondo Learn, gli host con tag fanno comunque parte del calcolo della percentuale minima di host, ma lo scaling automatico non li avvia. Rimuovi il tag nel passaggio 7. Finché resta, lo scaling automatico non avvia l'host, anche quando il pool ha bisogno di capacità. Lo scenario 4 di Learn descrive gli utenti che vedono il messaggio "Nessuna risorsa disponibile" quando tutti gli host del pool sono taggati e spenti.

Un esempio di cronologia per un singolo host

Questi orari sono inventati a scopo illustrativo e non rappresentano una raccomandazione di Microsoft. Un host di pool, avd-host-03, viene aggiornato in una sera feriale.

TempoAzione
17:30Applica il tag alla VM, attiva la modalità drain e elenca le sessioni (passaggi da 1 a 3).
17:35Invia un messaggio a ogni sessione rimasta: salvare il lavoro, disconnettersi, l'host verrà aggiornato alle 18:30 (passaggio 4).
18:30Termina le sessioni rimaste, comprese quelle disconnesse (passaggio 5).
18:35Installa gli aggiornamenti e riavvia (passaggio 6).
19:15Verifica che l'host risulti disponibile, disattiva la modalità drain e rimuovi il tag (passaggio 7).

Prima di iniziare, verifica che gli altri host possano sostenere il carico serale. L'articolo correlato sugli aggiornamenti in sequenza spiega quanti host è opportuno escludere contemporaneamente.

Pool di host personali

La documentazione FAQ di Learn indica che lo scaling automatico non porta un desktop personale in modalità drain prima di deallocarlo, e che un utente che si connette durante la deallocazione vede il messaggio "Nessuna risorsa disponibile". Le FAQ precisano inoltre che, se un host di sessione viene acceso dallo scaling automatico, da Start VM on Connect o da un amministratore e nessuno vi accede, lo scaling automatico lo dealloca dopo un periodo di inattività che la pagina non definisce. Questo ti riguarda se il pool ha un piano di scaling: un host personale che avvii per l'aggiornamento, senza che un utente vi acceda, può essere deallocato mentre lavori. Learn descrive il campo del tag di esclusione per i piani di gestione dell'alimentazione senza limitarlo ai pool di host condivisi, ma non specifica il suo effetto sui pool di host personali. Applicare il tag all'host personale prima di avviare la VM è quindi una precauzione suggerita da questo articolo, non una garanzia documentata; verificalo su un host di test. Avvisa anche l'utente assegnato, perché un host di sessione personale è assegnato a un solo utente.

Quando la modalità drain non è lo strumento giusto

La pagina di Learn sui metodi di aggiornamento per gli host di sessione valuta l'aggiornamento in loco in base al sistema operativo. Per gli host multisessione Windows client indica Windows Update come "Non consigliato" per gli aggiornamenti mensili e di funzionalità, e WSUS come "Non consigliato" per gli aggiornamenti di funzionalità, mentre indica aggiornamento dell'host di sessione e Azure Compute Gallery come "Consigliato". Per Windows Server indica Windows Update come "Supportato" e Azure Update Manager e il patch automatico guest come "Consigliati". Per Windows client Enterprise (sessione singola) indica Windows Update come "Consigliato", ma segna come "Non consigliati" i pool di host condivisi di questo tipo. Il paragrafo della stessa pagina sull'aggiornamento in loco elenca Windows Update tra le tecnologie comuni, quindi leggi le tabelle per singolo sistema e non solo quella frase. Secondo la nostra lettura, questo runbook si adatta agli host Windows Server, agli host personali e alle attività di manutenzione diverse dall'applicazione di patch, come modifiche di configurazione, riavvii, risoluzione dei problemi o dismissione di un host. Per i pool condivisi Windows client multisessione, Learn consiglia la manutenzione basata su immagini.

Se aggiorni sostituendo l'immagine invece di applicare la patch sul posto, la funzionalità di aggiornamento degli host di sessione di Learn fa il lavoro per gli host che usano una configurazione dell'host di sessione. Secondo Learn, la funzionalità porta da sola gli host selezionati in modalità di svuotamento e non devi modificare manualmente tale modalità durante un aggiornamento. La stessa pagina indica di disattivare il ridimensionamento automatico sul pool di host prima dell'aggiornamento, perché un piano di scalabilità attivo può far fallire l'operazione con un errore di runtime. Indica inoltre che le personalizzazioni manuali, come file, chiavi del Registro di sistema e certificati, non sono presenti dopo l'aggiornamento. Microsoft ha annunciato la disponibilità generale della gestione avanzata dei pool di host, che include la configurazione e l'aggiornamento degli host di sessione, nel luglio 2026 (Tech Community). Alcune pagine di Learn riportano ancora indicazioni di anteprima: ad esempio, la pagina sulla configurazione segnala come anteprima i cmdlet di Azure PowerShell per questi pool di host e richiede la versione di anteprima del modulo Az.DesktopVirtualization. Verifica la pagina aggiornata prima di fare affidamento su un limite. Confronta questo approccio con lo svuotamento a rotazione descritto in "Patching AVD without downtime: rolling updates with drain mode".

Fonti

Consultato il 17 novembre 2026.

Segui il podcastApple PodcastsSpotify

FAQ

Cosa succede agli utenti connessi quando attivo la modalità di drenaggio?

Non succede nulla. Microsoft Learn spiega che le connessioni esistenti restano attive finché l'utente non esce oppure un amministratore non termina la sessione. La modalità di drenaggio blocca solo le nuove sessioni. Devi inviare un messaggio agli utenti e terminare tu le sessioni, ad esempio con Send-AzWvdUserSessionMessage e Remove-AzWvdUserSession.

Perché un utente finisce ancora sull'host in drenaggio?

La pagina di Learn sul bilanciamento del carico indica che un utente che ha già una sessione attiva o disconnessa nel pool di host viene reindirizzato all'host che contiene quella sessione, anche con la modalità di drenaggio attiva. Gli utenti senza sessione non vengono inviati a un host in drenaggio. Per verificare le sessioni disconnesse usa Get-AzWvdUserSession.

Durante la manutenzione l'autoscale riaccende il mio host?

In un pool di host condiviso può farlo. Le FAQ di Learn sull'autoscale spiegano che l'autoscale ha la precedenza sulla modalità di drenaggio per tutte le VM incluse nella scalabilità. Per escludere una VM dalle azioni di scalabilità, usa il tag di esclusione impostato nel piano di scalabilità: Learn indica che in tal caso l'autoscale non avvia, non arresta e non modifica la modalità di drenaggio degli host con tag. Per i pool di host personali, le FAQ precisano che l'autoscale non imposta l'host di sessione in modalità di drenaggio, ma può comunque deallocare un host su cui nessuno ha effettuato l'accesso.

Entità in questo articolo

Temi di questo articolo:

Drain mode (Azure Virtual Desktop) – Sottotema di Session host (Azure Virtual Desktop) Session host (Azure Virtual Desktop) – Parte di Azure Virtual Desktop

Articoli correlati

Altri articoli su Session host (Azure Virtual Desktop):

RSS