Cómo usar el modo de drenaje para aplicar parches y realizar el mantenimiento de los hosts de sesión
Socio · Socio neutral: Nerdio
Por Mirko Peters ·
Runbook para retirar de servicio un host de sesión de Azure Virtual Desktop: protegerlo del escalado automático, activar el modo de drenaje, avisar y cerrar las sesiones restantes, realizar el trabajo y, después, desactivar el modo de drenaje.
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
Para aplicar parches a un host de sesión sin desconectar a los usuarios, etiqueta la máquina virtual para que el escalado automático no la toque, activa el modo de drenaje, envía a los usuarios restantes un mensaje con un plazo, finaliza las sesiones que queden, aplica los parches y reinicia y, por último, desactiva el modo de drenaje.
Puntos clave
- El modo de drenaje impide las sesiones nuevas en un host. Las sesiones existentes se mantienen hasta que el usuario cierra sesión o un administrador las finaliza.
- Un usuario que ya tiene una sesión activa o desconectada en el grupo sigue siendo redirigido a ese host, incluso en modo de drenaje, así que enumera y finaliza las sesiones antes de aplicar los parches.
- En los grupos de hosts agrupados, el escalado automático invalida el modo de drenaje en todas las máquinas virtuales incluidas en el ámbito, así que define primero la etiqueta de exclusión del plan de escalado. En los grupos personales, el escalado automático no establece el modo de drenaje.
- El modo de drenaje requiere el rol Operador de host de sesión de Desktop Virtualization; enviar mensajes y cerrar la sesión de los usuarios requiere el rol Operador de sesiones de usuario. Comprueba los permisos efectivos de la cuenta que ejecuta el runbook.
- Para las actualizaciones basadas en imágenes de hosts que usan una configuración de host de sesión, la actualización del host de sesión gestiona el modo de drenaje por sí misma, y Learn recomienda no cambiarlo manualmente durante una actualización.
Este artículo es el runbook para un único host. Qué es el modo de drenaje se explica en «Modo de drenaje en Azure Virtual Desktop explicado». Planificar oleadas en todo un grupo de hosts, con tamaños de oleada y capacidad, es el tema de «Aplicar parches a AVD sin tiempo de inactividad: actualizaciones progresivas con modo de drenaje». La mecánica de la etiqueta de exclusión, incluida la forma de aplicarla, se explica en «Cómo usar la etiqueta de exclusión para ventanas de mantenimiento y hosts de sesión especiales».
Lo que necesitas antes de empezar
- Roles. Microsoft Learn indica que activar o desactivar el modo de drenaje requiere el rol Desktop Virtualization Session Host Operator. Su descripción en la página de RBAC añade que el rol puede ver y quitar hosts de sesión y cambiar el modo de drenaje. El envío de mensajes, la desconexión de sesiones y el cierre de sesión de los usuarios corresponden al rol Desktop Virtualization User Session Operator, que, según la página de RBAC, no permite cambiar el modo de drenaje. La definición integrada del rol Session Host Operator incluye
Microsoft.DesktopVirtualization/hostpools/sessionhosts/, mientras que la definición de User Session Operator incluye explícitamente.../sessionhosts/usersessions/. Por tanto, que una misma cuenta pueda realizar ambos pasos depende de los roles que tenga asignados en realidad, así que pruébalo con la cuenta que ejecutará el runbook. - Azure PowerShell con el módulo Az.DesktopVirtualization, o Azure Cloud Shell, si quieres automatizarlo con scripts.
- Capacidad. Learn indica que las conexiones nuevas se envían al siguiente host de sesión disponible, así que comprueba que los hosts restantes pueden asumir la carga. En un grupo de profundidad primero, revisa también el límite máximo de sesiones, porque Learn indica que, cuando todos los hosts lo alcanzan, debes aumentarlo o añadir hosts.
Paso a paso
- Mantén el autoscale alejado del host (grupos de hosts agrupados). La página de escenarios de Learn indica que, en los grupos de hosts agrupados, el autoscale sobrescribe el modo de drenaje, y las preguntas frecuentes sobre el autoscale dicen que este sigue activando o desactivando las VM en modo de drenaje, sin importar quién las haya puesto en ese modo, porque anula el modo de drenaje en todas las VM incluidas en el escalado. La etiqueta de exclusión es un nombre de etiqueta que introduces en la pestaña Aspectos básicos del plan de escalado (en la pestaña Propiedades de un plan existente). El ejemplo de Learn es
excludeFromScaling. El campo existe para los planes de administración de energía y para los planes dinámicos, que solo se aplican a los grupos de hosts agrupados con configuración de host de sesión. Con la etiqueta en un host de sesión, el autoscale no inicia, no detiene ni cambia el modo de drenaje de ese host. Añade a la VM una etiqueta con ese nombre. Los permisos para etiquetas y más detalles están en el artículo sobre la etiqueta de exclusión que se menciona arriba. Para los grupos de hosts personales, consulta la sección más abajo. - Activa el modo de drenaje. En Azure Portal, abre Azure Virtual Desktop y, después, Grupos de hosts, selecciona el grupo de hosts, selecciona Hosts de sesión, marca el host y selecciona Activar modo de drenaje. Con Azure PowerShell, la página de modo de drenaje de Learn establece el modo de drenaje con el parámetro
AllowNewSessiondeUpdate-AzWvdSessionHost, que se ejecuta una vez por cada host de sesión. La página usa una tabla hash$paramsconAllowNewSession = $Falsey la pasa al cmdlet mediante splatting; la misma llamada en un solo bloque, con el formato del ejemplo de la referencia del cmdlet, es:
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> `
-Name <SessionHostName> `
-AllowNewSession:$falseLearn advierte de que el estado del portal puede no estar sincronizado si lo actualizas inmediatamente. Espera al menos 60 segundos antes.
- Enumera las sesiones que quedan en el host.
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName>El ejemplo de salida de Learn muestra cada sesión con el formato HostPoolName/SessionHostName/2, y la referencia de Remove-AzWvdUserSession recibe el número de sesión en -Id (alias UserSessionId), así que usa la última parte del nombre como ID de sesión.
- Avisa a los usuarios. La referencia de Learn muestra este formato, con el título y el cuerpo del mensaje como texto libre:
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.'Indica un plazo que puedas cumplir.
- Finaliza lo que quede. Una vez vencido el plazo, elimina las sesiones restantes:
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>La página de referencia también incluye un parámetro -Force ("Specify to force userSession deletion"), pero no muestra ningún ejemplo con él. Eliminar una sesión la termina, así que se pierde todo lo que el usuario no haya guardado. Por eso el paso 4 va primero.
- Realiza el mantenimiento. Learn indica que, cuando ya no quedan sesiones, puedes realizar el mantenimiento necesario, y que los administradores siguen pudiendo conectarse directamente al servidor sin pasar por el servicio de Azure Virtual Desktop. La aplicación de parches en sí, mediante Windows Update, Intune, WSUS u otra herramienta, queda fuera de este artículo, pero antes revisa cómo Learn valora la aplicación de parches in situ para tu sistema operativo (consulta la última sección). Si el host no vuelve a aparecer como disponible después, usa la lista de comprobación del artículo relacionado "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
- Desactiva el modo de drenaje. En el portal, marca el host y selecciona Desactivar modo de drenaje. En PowerShell, ejecuta el mismo cmdlet con
-AllowNewSession:$true; la página de modo de drenaje de Learn muestra ambos sentidos:$Falsepara activar el modo de drenaje y$Truepara desactivarlo. Espera al menos 60 segundos antes de revisar el estado en el portal. Después, elimina la etiqueta de exclusión para que el autoscale vuelva a gestionar el host.
Comportamientos que sorprenden
- Las sesiones desconectadas vuelven. La página de equilibrio de carga de Learn indica que un usuario con una sesión activa o desconectada que vuelve a iniciar sesión se envía al host donde está esa sesión, incluso en modo de drenaje. Un usuario sin sesión nunca se envía a un host en drenaje. Por eso importa el paso 3: un host que parece vacío puede seguir teniendo sesiones desconectadas.
- Un host agrupado sin etiqueta sigue dentro del ámbito. Si pones en drenaje manualmente un host de un grupo de hosts agrupados y no lo etiquetas, el autoscale puede seguir iniciándolo, deteniéndolo o cambiando su modo de drenaje, según las preguntas frecuentes. Lo que saca al host del escalado es la etiqueta, no el modo de drenaje.
- El trabajo sin guardar se pierde.
Remove-AzWvdUserSessionfinaliza la sesión. La referencia de Learn no describe ninguna forma de recuperar la sesión, así que envía primero el mensaje del paso 4. - Una etiqueta olvidada mantiene el host fuera del escalado. Learn indica que los hosts etiquetados siguen formando parte del cálculo del porcentaje mínimo de hosts, pero el escalado automático no los inicia. Quita la etiqueta en el paso 7. Mientras siga puesta, el escalado automático no inicia el host, aunque el grupo necesite la capacidad; el escenario 4 de Learn describe que los usuarios ven "No hay recursos disponibles" cuando todos los hosts del grupo están etiquetados y apagados.
Un ejemplo de cronograma para un host
Estos tiempos son inventados para ilustrar y no son una recomendación de Microsoft. Un host agrupado, avd-host-03, se actualiza un día laborable por la noche.
| Tiempo | Acción |
|---|---|
| 17:30 | Etiqueta la VM, activa el modo de drenaje y enumera las sesiones (pasos 1 a 3). |
| 17:35 | Envía un mensaje a cada sesión restante: guarda el trabajo, cierra la sesión y el host se actualizará a las 18:30 (paso 4). |
| 18:30 | Cierra las sesiones que queden, incluidas las desconectadas (paso 5). |
| 18:35 | Instala las actualizaciones y reinicia (paso 6). |
| 19:15 | Confirma que el host aparece como disponible, desactiva el modo de drenaje y quita la etiqueta (paso 7). |
Antes de empezar, comprueba que los demás hosts pueden soportar la carga de la tarde. El artículo relacionado sobre actualizaciones continuas explica cuántos hosts conviene retirar a la vez.
Grupos de hosts personales
La preguntas frecuentes de Learn indican que el escalado automático no pone un escritorio personal en modo de drenaje antes de desasignarlo, y que un usuario que se conecte durante la desasignación verá "No hay recursos disponibles". Las mismas preguntas también indican que, si un host de sesión lo enciende el escalado automático, Start VM on Connect o un administrador, y nadie inicia sesión en él, el escalado automático lo desasigna tras un periodo de inactividad que la página no define. Esto te afecta si el grupo tiene un plan de escalado: un host personal que enciendes para actualizarlo, sin que ningún usuario inicie sesión, puede ser desasignado mientras trabajas en él. Learn describe el campo de etiqueta de exclusión para los planes de administración de energía sin limitarlo a los grupos de hosts agrupados, pero no detalla su efecto en los grupos de hosts personales. Etiquetar el host personal antes de encender la VM es, por tanto, una precaución que sugiere este artículo, no una garantía documentada; compruébalo en un host de prueba. Avisa también al usuario asignado, porque un host de sesión personal está asignado a un único usuario.
Cuándo el modo de drenaje no es la herramienta adecuada
La página de Learn sobre los métodos de actualización de los hosts de sesión clasifica la aplicación de parches in situ por sistema operativo. Para los hosts multisesión de cliente Windows, marca Windows Update como "No recomendado" para las actualizaciones mensuales y de funciones, y WSUS como "No recomendado" para las actualizaciones de funciones, y marca la actualización de hosts de sesión y Azure Compute Gallery como "Recomendado". Para Windows Server, marca Windows Update como "Compatible" y Azure Update Manager y la aplicación automática de parches de invitado como "Recomendado". Para Windows cliente Enterprise (de sesión única), marca Windows Update como "Recomendado", pero marca como "No recomendado" los grupos de hosts agrupados de ese tipo. El párrafo sobre la aplicación de parches in situ de la misma página enumera Windows Update entre las tecnologías habituales, así que lee las tablas por sistema, no solo esa frase. Nuestra interpretación: este runbook encaja con los hosts de Windows Server, los hosts personales y el mantenimiento que no es de parches, como cambios de configuración, reinicios, resolución de problemas o retirada de un host. Para los grupos agrupados multisesión de cliente Windows, Learn recomienda el mantenimiento basado en imágenes.
Si actualizas reemplazando la imagen en lugar de aplicar parches en el sitio, la función de actualización de hosts de sesión de Learn hace el trabajo por ti en los hosts que usan una configuración de host de sesión. Learn indica que esa función pone los hosts seleccionados en modo de drenaje por sí misma y que no debes cambiar el modo de drenaje manualmente durante una actualización. La página también dice que desactives el escalado automático del grupo de hosts antes de la actualización, porque un plan de escalado habilitado puede hacer que falle con un error de tiempo de ejecución, y que las personalizaciones manuales, como archivos, claves del Registro y certificados, no están presentes después de la actualización. Microsoft anunció la disponibilidad general de la administración mejorada de grupos de hosts, que incluye la configuración y la actualización de hosts de sesión, en julio de 2026 (Tech Community). Algunas páginas de Learn todavía contienen texto de versión preliminar; por ejemplo, la página de configuración marca los cmdlets de Azure PowerShell para estos grupos de hosts como versión preliminar y pide la versión preview del módulo Az.DesktopVirtualization. Revisa la página actual antes de confiar en un límite. Compara este enfoque con el drenaje por fases que se describe en "Patching AVD without downtime: rolling updates with drain mode".
Fuentes
Consultado el 17 de noviembre de 2026.
- Microsoft Learn: Drenar hosts de sesión para el mantenimiento en Azure Virtual Desktop
- Microsoft Learn: Roles de RBAC de Azure para Azure Virtual Desktop (página rbac)
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdUserSession
- Microsoft Learn: Send-AzWvdUserSessionMessage
- Microsoft Learn: Remove-AzWvdUserSession
- Microsoft Learn: Configurar el equilibrio de carga de grupos de hosts
- Microsoft Learn: Preguntas frecuentes sobre el autoescalado de Azure Virtual Desktop
- Microsoft Learn: Crear y asignar un plan de escalado de autoescalado
- Microsoft Learn: Planes de escalado de autoescalado y escenarios de ejemplo
- Microsoft Learn: Metodologías de administración de actualizaciones de Windows para hosts de sesión
- Microsoft Learn: Actualización de hosts de sesión
- Microsoft Learn: Actualizar hosts de sesión con una configuración de host de sesión
- Microsoft Tech Community: La administración mejorada de grupos de hosts para Azure Virtual Desktop ya está disponible con carácter general
Preguntas frecuentes
¿Qué ocurre con los usuarios conectados cuando activo el modo de drenaje?
No les ocurre nada. Microsoft Learn indica que las conexiones existentes siguen activas hasta que el usuario cierra sesión o un administrador finaliza la sesión. El modo de drenaje solo impide las sesiones nuevas. Tú tienes que enviar un mensaje a los usuarios y finalizar las sesiones por tu cuenta, por ejemplo con Send-AzWvdUserSessionMessage y Remove-AzWvdUserSession.
¿Por qué sigue entrando un usuario en el host que puse en modo de drenaje?
La página de equilibrio de carga de Learn indica que un usuario que ya tiene una sesión activa o desconectada en el grupo de hosts se redirige al host que contiene esa sesión, aunque el modo de drenaje esté activado. Los usuarios sin sesión no se envían a un host en drenaje. Busca las sesiones desconectadas con Get-AzWvdUserSession.
¿Volverá el escalado automático a encender mi host durante el mantenimiento?
En un grupo de hosts agrupado, puede hacerlo. La preguntas frecuentes de Learn sobre el escalado automático indican que el escalado automático invalida el modo de drenaje en todas las máquinas virtuales incluidas en el escalado. Para mantener una máquina virtual fuera de las acciones de escalado, usa la etiqueta de exclusión definida en el plan de escalado: Learn indica que, en ese caso, el escalado automático no inicia, detiene ni cambia el modo de drenaje de los hosts etiquetados. En grupos de hosts personales, las preguntas frecuentes indican que el escalado automático no pone el host de sesión en modo de drenaje, pero sí puede desasignar un host en el que nadie inicia sesión.