Cómo usar la etiqueta de exclusión para ventanas de mantenimiento y hosts de sesión especiales
Socio · Socio neutral: Nerdio
Por Mirko Peters ·
Para aplicar parches a un host de sesión de Azure Virtual Desktop sin que el escalado automático interfiera, define la etiqueta de exclusión del plan de escalado, activa el modo de drenaje, espera a que terminen las sesiones, realiza el trabajo y deshaz ambos pasos.
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
Para sacar de servicio un host de sesión agrupado de Azure Virtual Desktop sin que el escalado automático interfiera, etiqueta primero la VM con la etiqueta de exclusión del plan de escalado, luego activa el modo de drenaje, espera a que terminen las sesiones, realiza el mantenimiento y deshaz ambos pasos. El orden importa, porque el escalado automático sobrescribe el modo de drenaje en cualquier VM que gestiona. Qué es la etiqueta y dónde Learn deja preguntas abiertas se explica en "Exclusion tags in AVD autoscale: keeping individual VMs out of scaling". El lado del modo de drenaje de un parche de un solo host, incluido cómo avisar y finalizar sesiones, está en el runbook "How to use drain mode for patching and maintenance of session hosts". Este artículo cubre la mecánica de la etiqueta y las comprobaciones que la rodean.
Puntos clave
- Etiqueta la VM antes de activar el modo de drenaje. El escalado automático anula el modo de drenaje en cada VM que escala, así que el modo de drenaje por sí solo no protege un host en un grupo de hosts agrupado.
- Etiqueta en el portal o con Update-AzTag -Operation Merge, y elimínala después con Delete. El rol Colaborador de etiquetas solo puede etiquetar mediante PowerShell o REST, no desde el portal.
- Comprueba primero la capacidad de los hosts sin etiquetar. Los hosts etiquetados siguen contando para el porcentaje mínimo de hosts, pero el escalado automático no puede iniciarlos, así que el grupo podría no alcanzar su mínimo.
- La etiqueta se aplica en todas las fases de la programación y Learn no describe un límite de tiempo para ella, así que retirarla tras el trabajo es un paso que te corresponde a ti.
- Learn documenta la etiqueta para mantenimiento. Usarla en hosts de prueba o de funcionamiento continuo se deduce de su definición, pero no se describe como caso de uso.
Antes de empezar
Necesitas tres cosas preparadas.
- Un nombre de etiqueta de exclusión en el plan de escalado. En el portal de Azure abre Azure Virtual Desktop, selecciona Planes de escalado, abre el plan y revisa la pestaña Propiedades. Si el campo está vacío, introduce un nombre ahí. El ejemplo de Learn's es
excludeFromScaling. Los cambios en un plan asignado se aplican de inmediato. - Permisos. Learn indica el rol Operador de host de sesión de Desktop Virtualization para el modo de drenaje. Para las etiquetas, Learn indica asignar el rol Colaborador de etiquetas a un usuario que no tenga permiso para añadirlas. La página de etiquetado de Learn añade una limitación: ese rol no puede aplicar etiquetas a recursos desde el portal de Azure, pero admite todas las operaciones de etiquetado mediante Azure PowerShell y la API REST. Si solo tienes ese rol, usa los comandos de PowerShell del paso 1. Encender o apagar la VM es un permiso aparte de Azure que estas páginas no cubren.
- Capacidad libre. Calcúlala antes de etiquetar; el ejemplo siguiente muestra cómo.
Comprueba primero la capacidad
Learn indica que los hosts etiquetados siguen considerándose en el cálculo del porcentaje mínimo de hosts, pero el escalado automático no puede encenderlos, y su escenario de seis hosts señala que no poder volver a encender VM significa que el grupo no puede cumplir el porcentaje mínimo. Si etiquetas demasiados, el escalado automático no puede añadir capacidad. Las consecuencias, incluido el escenario de seis hosts de Learn, se explican en el artículo conceptual; aquí tienes la comprobación que haces antes de una ventana de mantenimiento.
Un ejemplo práctico con cifras inventadas: un grupo de ocho hosts tiene un límite máximo de sesiones de 10 y un umbral de capacidad del 75 por ciento, y la carga máxima es de 50 sesiones. Learn define la capacidad disponible del grupo de hosts como el límite máximo de sesiones multiplicado por el número de hosts de sesión disponibles, y dice que autoscale activa o crea más hosts de sesión cuando la capacidad utilizada supera el umbral de capacidad. El glosario de Learn define un host de sesión disponible como aquel que ha superado las comprobaciones de estado del agente y está encendido, y no menciona el modo de drenaje. El esquema de Insights describe ActiveSessionHostCount como el número de hosts de sesión que aceptan conexiones de usuario, lo que excluiría a un host en modo de drenaje. Learn no indica qué definición usa autoscale para su cálculo de capacidad. El cálculo siguiente es el modelo prudente del propio artículo, no un comportamiento documentado: cuenta los hosts en mantenimiento como capacidad cero. Con esa suposición, si sacas dos hosts para aplicarles parches y los seis restantes están en ejecución, soportan 6 x 10 x 0.75 = 45 sesiones antes de superar el umbral, y autoscale necesitaría otro host. Con 50 sesiones lo necesitaría y no podría iniciar un host etiquetado. Con un host fuera, 7 x 10 x 0.75 = 52.5 sesiones, lo que cubre el pico de 50. Así que en este grupo, aplica los parches a un host cada vez durante las horas punta, o a ambos fuera de ese periodo.
La misma comprobación se aplica al porcentaje mínimo de hosts. Con ocho hosts y un mínimo del 25 por ciento, autoscale mantiene dos en ejecución, y Learn redondea las fracciones hacia arriba. Asegúrate de que queden suficientes hosts sin etiquetar para que autoscale pueda iniciar hosts. Learn no indica si un host etiquetado en ejecución cuenta como uno de los hosts que cumplen el mínimo, así que no lo des por hecho.
Manual de mantenimiento
- Etiqueta la VM. En Azure Portal, abre la VM, selecciona Agregar etiquetas (si la VM ya tiene etiquetas, la sección de edición de Learn indica que selecciones cambiar), introduce el nombre de etiqueta del plan y un valor, y selecciona Guardar. Las páginas de autoscale definen la coincidencia por nombre de etiqueta y no indican si se compara el valor. Si son varias VM, selecciónalas en una lista de recursos y usa Asignar etiquetas. Las etiquetas no se heredan del grupo de recursos, así que cada VM necesita la suya. Learn no indica con qué rapidez autoscale detecta una etiqueta recién añadida, así que no asumas que la protección está activa en cuanto guardas; usa la comprobación del paso 7 como verificación de plausibilidad antes de confiar en ella. En PowerShell, combina la etiqueta con las existentes:
$vm = Get-AzResource -Name "avd-host-03" -ResourceGroup "rg-avd"
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation MergeLearn indica que Update-AzTag necesita el módulo Az.Resources, versión 1.12.0 o posterior. Los nombres avd-host-03 y rg-avd son ejemplos; Get-AzResource puede devolver varios recursos con el mismo nombre, así que comprueba el resultado.
- Activa el modo de drenaje. En el portal, selecciona Azure Virtual Desktop, después Grupos de hosts, el grupo de hosts y luego Hosts de sesión. Marca el host y selecciona Activar modo de drenaje. En PowerShell,
Update-AzWvdSessionHostdel móduloAz.DesktopVirtualizationhace lo mismo:
Update-AzWvdSessionHost -ResourceGroupName "rg-avd" -HostPoolName "hp-pooled-01" `
-Name "avd-host-03.contoso.com" -AllowNewSession:$falseLos nombres del ejemplo son marcadores de posición; usa el nombre del host de sesión de tu propio host. Si actualizas el portal justo después de cambiar el modo de drenaje, el estado puede parecer desincronizado. Learn indica que esperes al menos 60 segundos.
- Deja que el host se vacíe. Learn indica que un host en modo de drenaje no acepta nuevas sesiones de usuario, y que las nuevas conexiones pasan al siguiente host disponible, mientras que las conexiones existentes siguen activas hasta que el usuario cierra sesión o un administrador finaliza la sesión. Si un usuario ya tiene una sesión activa o desconectada en el grupo y vuelve a iniciar sesión, el equilibrador de carga lo redirige al host con esa sesión, incluso con el modo de drenaje activado, así que las sesiones desconectadas pueden mantener ocupado un host. Los comandos para listar sesiones, enviar un aviso y finalizar las que queden están en el manual de modo de drenaje enlazado arriba.
- Realiza el mantenimiento. Learn indica que los administradores siguen pudiendo conectarse directamente al servidor, sin pasar por el servicio Azure Virtual Desktop. Inicia tú la VM si está apagada; autoscale no lo hará para un host etiquetado.
- Desactiva el modo de drenaje. Selecciona el host y Desactiva el modo de drenaje, o ejecuta el mismo cmdlet con
-AllowNewSession:$true. La página de modo de drenaje de Learn muestra ambas direcciones con el mismo cmdlet:AllowNewSession = $Falseactiva el modo de drenaje y$Truelo desactiva.
- Quita la etiqueta. Elimina la etiqueta en el portal o usa la operación Delete con el mismo par de nombre y valor que añadiste:
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation DeleteUna vez quitada la etiqueta, el escalado automático puede volver a actuar sobre el host; Learn no indica con qué rapidez detecta el cambio. Si la fase requiere consolidación, puede poner el host en modo de drenaje y apagarlo, así que no quites la etiqueta de un host que quieras mantener en ejecución hasta que estés preparado para ello.
- Verifica. La página de información sobre el escalado automático (solo para grupos de hosts agrupados) documenta la tabla de Log Analytics
WVDAutoscaleEvaluationPooled, cuya columnaExcludedSessionHostCountse describe como el número de hosts de sesión excluidos de la administración del escalado automático. El requisito previo de Learn es una configuración de diagnóstico en el grupo de hosts agrupado que incluya Autoscale logs for pooled host pools y envíe los datos a un área de trabajo de Log Analytics. Consulta esa área de trabajo, por ejemplo conWVDAutoscaleEvaluationPooled | take 10. Learn no vincula la columna a la etiqueta de exclusión, así que un recuento coincidente es una comprobación de plausibilidad, no una prueba.
Planificación según la programación
La etiqueta se aplica en todas las fases de la programación: aumento, pico, reducción y fuera de pico. Por tanto, un host que etiquetes por la tarde quedará sin cambios durante la reducción de la tarde y la fase nocturna fuera de pico, y un host al que olvides quitar la etiqueta quedará excluido en todas las fases. Learn no describe un límite de tiempo para la etiqueta, así que planifica la ventana como un par de acciones: etiqueta y drena antes de que empiece, y deshaz ambas después de que termine. Ejecuta la comprobación de capacidad anterior con la configuración de la fase en la que cae tu ventana; el glosario de Learn define el porcentaje mínimo de hosts para cada fase de la programación.
Hosts de sesión especiales
Learn documenta un único propósito para la etiqueta: evitar que el escalado automático anule el modo de drenaje durante el mantenimiento. Los demás usos se derivan de su definición, y debes tratarlos como inferencias.
- Un host que estás probando. Una nueva imagen o una configuración modificada en un host puede mantenerse fuera de los cambios de energía mientras lo pruebas. Ponlo también en modo de drenaje, o los usuarios habituales podrían conectarse a él.
- Un host que debe seguir encendido. El escalado automático no apagará un host etiquetado, así que un host en ejecución seguirá en ejecución. Learn no indica si cumple el porcentaje mínimo de hosts.
- Un host que debe seguir apagado. El escalado automático no lo iniciará. Learn no describe qué hace Start VM on Connect con un host etiquetado que está apagado, así que pruébalo antes de depender de ello.
En un grupo de hosts personal, la etiqueta probablemente protege el estado de energía, porque el escalado automático no pone los escritorios personales en modo de drenaje; esto es una inferencia a partir de las preguntas frecuentes. El artículo conceptual lo cubre, así como el caso de «No resources available».
Errores que debes evitar
- Etiquetar el grupo de recursos. Las etiquetas no se heredan, así que las máquinas virtuales quedarán desprotegidas.
- Drenar primero, etiquetar después. En un grupo agrupado, el escalado automático puede anular el modo de drenaje que hayas establecido, sin importar quién lo haya configurado.
- Olvidar la etiqueta después. Un host que sigue etiquetado nunca se escala. Si permanece encendido, genera costes; si permanece apagado, reduce la capacidad, y un host etiquetado que está apagado no ayuda al grupo a cumplir su porcentaje mínimo, porque el escalado automático no puede iniciarlo.
- Poner datos personales en la etiqueta. Learn pide que no incluyas nombres de entidad de usuario ni datos similares en las etiquetas de exclusión.
- Suponer que el escalado automático dinámico se comporta igual. Microsoft anunció la disponibilidad general de la administración mejorada de grupos de hosts, que incluye el escalado automático dinámico, la configuración y actualización de hosts de sesión y los discos del sistema operativo efímeros, en julio de 2026 (Tech Community). Algunas páginas de Learn, por ejemplo las de escenarios y glosario, y la versión 5.4.2-preview del módulo, todavía contienen texto de versión preliminar; revisa la página actual antes de confiar en un límite. Learn no indica si el escalado automático dinámico, que puede eliminar hosts de sesión, trata de forma diferente a los hosts etiquetados.
Relacionado
- Etiqueta de exclusión
- Modo de drenaje
- Plan de escalado de AVD
- etiquetas de recursos de Azure
- host de sesión de AVD
Fuentes
- Microsoft Learn: Crear y asignar un plan de escalado de autoescalado
- Microsoft Learn: Escenarios de Autoscale para Azure Virtual Desktop
- Microsoft Learn: Preguntas frecuentes sobre el escalado automático
- Microsoft Learn: Glosario de autoescalado
- Microsoft Learn: Drenar hosts de sesión para el mantenimiento en Azure Virtual Desktop
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Configurar el equilibrio de carga de grupos de hosts en Azure Virtual Desktop
- Microsoft Learn: Usar etiquetas para organizar los recursos de Azure
- Microsoft Learn: Usar Azure Portal para administrar etiquetas
- Microsoft Learn: Administrar etiquetas con Azure PowerShell
- Microsoft Learn: Supervisar las operaciones de autoscale con Insights
- Microsoft Tech Community: La administración mejorada de grupos de hosts para Azure Virtual Desktop ya está disponible con carácter general
Preguntas frecuentes
¿Necesito el modo de drenaje si la VM tiene la etiqueta de exclusión?
Para mantenimiento, sí. La etiqueta solo evita que el escalado automático cambie el host. No impide nuevas sesiones, así que aun así activas el modo de drenaje para que las nuevas conexiones vayan a otros hosts de sesión y el host pueda vaciarse.
¿Qué pasa si activo el modo de drenaje sin la etiqueta?
En un grupo de hosts agrupado, Microsoft Learn indica que el escalado automático anula el modo de drenaje en todas las VM incluidas en el escalado, independientemente de quién lo haya configurado. Por tanto, el escalado automático puede cambiar el modo de drenaje que configuraste o encender y apagar el host mientras trabajas.
¿Qué roles necesito?
Learn indica el rol Operador de host de sesión de Desktop Virtualization para el modo de drenaje. Para las etiquetas menciona el rol Colaborador de etiquetas, que admite las operaciones de etiquetado mediante Azure PowerShell y REST, pero no en recursos del portal de Azure. Encender o apagar una VM es un permiso aparte de Azure que estas páginas no cubren.