Actualización de hosts de sesión mediante la actualización del host de sesión en Azure Virtual Desktop (versión preliminar)

A continuación se muestra cómo programar una nueva actualización para los hosts de sesión mediante el Azure Portal.

1. Inicie sesión en el portal de Azure.

2. En la barra de búsqueda, escriba Azure Virtual Desktop y seleccione la entrada de servicio coincidente.

3. Seleccione Grupos de hosts y, a continuación, seleccione el grupo de hosts con una configuración de host de sesión que quiera actualizar.

4. Seleccione Hosts de sesión.

5. Si desea revisar la configuración del host de sesión antes de programar una actualización, seleccione Administrar configuración de host de sesión y, a continuación, Ver. Una vez que revise la configuración del host de sesión, seleccione Cancelar.

6. Para programar una nueva actualización, seleccione Administrar actualización del host de sesión y, a continuación, seleccione Nueva actualización. Como alternativa, seleccione Administrar configuración de host de sesión y, a continuación, Editar.

7. En la pestaña Aspectos básicos , complete la siguiente información:

   Parámetro	Valor/descripción
   Tamaño actual del grupo de hosts (solo lectura)	Número de hosts de sesión en el grupo de hosts.
   Tamaño de lote de máquina virtual autorizado para quitarse del grupo de hosts durante la actualización	Número máximo de hosts de sesión que se actualizan a la vez. Cuando se inicia la actualización, solo se actualiza primero un host de sesión, conocido como inicial, para comprobar el proceso de actualización antes de actualizar los hosts de sesión restantes en lotes. Si la actualización de la inicial no se realiza correctamente, la actualización se detiene.
   Hosts de sesión disponibles durante la actualización (solo lectura)	Número mínimo de hosts de sesión que están disponibles para las sesiones de usuario durante la actualización.

   Una vez completada esta pestaña, seleccione Siguiente: Hosts de sesión.

8. En la pestaña Hosts de sesión , puede actualizar opcionalmente los parámetros siguientes en la configuración del host de sesión:

   Parámetro	Valor/descripción
   Tipo de seguridad	Seleccione entre Standard, Máquinas virtuales de inicio de confianza o Máquinas virtuales confidenciales. - Si selecciona Máquinas virtuales de inicio de confianza, las opciones de arranque seguro y vTPM se seleccionan automáticamente. - Si selecciona Máquinas virtuales confidenciales, las opciones de arranque seguro, vTPM y supervisión de la integridad se seleccionan automáticamente. No se puede excluir de vTPM cuando se usa una máquina virtual confidencial.
   Imagen	Seleccione la imagen del sistema operativo que desea usar en la lista o seleccione Ver todas las imágenes para ver más, incluidas las imágenes personalizadas que creó y almacenó como una imagen compartida de Azure Compute Gallery o una imagen administrada.
   Tamaño de la máquina virtual	Seleccione una SKU recomendada en la lista. Si desea usar una SKU diferente, seleccione Ver todos los tamaños y, a continuación, seleccione en la lista.
   Tipo de disco del SO	Seleccione el tipo de disco que se va a usar para los hosts de sesión. Se recomienda usar SSD Premium para cargas de trabajo de producción. El tipo de disco debe admitirse en la familia de máquinas virtuales y el tamaño seleccionados. Asegúrese de que está seleccionando una combinación compatible con Azure Compute. El nombre del disco del sistema operativo de los hosts de sesión actualizados tiene un nuevo nombre en el formato SessionHostName-DateTime_Hash.
   Dominio al que quiere unirse
   Seleccione el directorio al que desea unirse	Seleccione Microsoft Entra o Active Directory. Si usa Active Directory, seleccione el almacén de claves que contiene los secretos del nombre de usuario y la contraseña de la cuenta de unión al dominio. Opcionalmente, puede especificar un nombre de dominio y una ruta de acceso de unidad organizativa.
   Cuenta de administrador de máquina virtual	Complete los parámetros pertinentes seleccionando el almacén de claves y el secreto para el nombre de usuario y la contraseña de la cuenta de administrador local de las máquinas virtuales del host de sesión actualizadas. El nombre de usuario y la contraseña deben cumplir los requisitos de las máquinas virtuales Windows en Azure.
   Configuración personalizada
   Dirección URL del script de configuración personalizada	Si desea ejecutar un script de PowerShell durante la implementación, puede escribir la dirección URL aquí.

   Una vez que revise o termine de realizar cambios en la configuración del host de sesión, seleccione Siguiente: Programación.

9. En la pestaña Programación , active la casilla Programar actualización ahora o seleccione una fecha, hora y zona horaria que desee que se inicie la actualización, hasta un máximo de dos semanas a partir de la hora actual.

   Una vez establecida la programación, seleccione Siguiente: Notificaciones.

10. En la pestaña Notificaciones , complete la siguiente información:

    Parámetro	Valor/descripción
    Minutos antes de que se agote la sesión de los usuarios	Cantidad de tiempo que se debe esperar después de la hora de inicio de la actualización para que se notifique a los usuarios que cierren sesión. Este valor se puede configurar entre 0 y 60 minutos. Los usuarios se cerrarán automáticamente después de este tiempo transcurrido.
    Mensaje de cierre de sesión	Un mensaje que puede especificar para informar a los usuarios de que el host de sesión que usan está a punto de empezar a actualizarse.

    Una vez completada esta pestaña, seleccione Siguiente: Revisar.

11. En la pestaña Revisar , asegúrese de que la validación pasa y revise la información que se usa durante la actualización.

12. Seleccione Actualizar para programar la actualización. Al ver la lista de hosts de sesión, la columna Versión actual muestra la marca de tiempo de la versión de la configuración del host de sesión que usa el host de sesión. Si la columna Versión actual tiene un icono de advertencia, significa que la marca de tiempo de la versión de la columna Versión de destino es posterior y el host de sesión debe actualizarse.

A continuación se muestra cómo programar una nueva actualización para los hosts de sesión mediante el módulo Az.DesktopVirtualization de PowerShell. Al programar una actualización, se usa la configuración del host de sesión para el grupo de hosts. Debe realizar cambios en la configuración del host de sesión antes de programar una actualización.

Puede actualizar la directiva de administración del host de sesión antes de programar una actualización, donde los cambios persisten para su uso futuro. Como alternativa, puede invalidar los valores de la directiva de administración del host de sesión al programar una actualización, pero solo se aplican a esa actualización.

1. Abra Azure Cloud Shell en el Azure Portal con el tipo de terminal de PowerShell o ejecute PowerShell en el dispositivo local.

   • Si usa Cloud Shell, asegúrese de que el contexto de Azure está establecido en la suscripción que desea usar.

   • Si usa PowerShell localmente, inicie sesión primero con Azure PowerShell y, a continuación, asegúrese de que el contexto de Azure está establecido en la suscripción que desea usar.

2. Use el Update-AzWvdSessionHostConfiguration cmdlet para actualizar la configuración del host de sesión, donde solo necesita especificar los parámetros que desea cambiar. Estos son algunos comandos de ejemplo:

   • Para especificar una imagen personalizada diferente para que los hosts de sesión usen, ejecute el siguiente comando. Para obtener información sobre cómo buscar los valores de la imagen de Marketplace, consulte Búsqueda y uso de imágenes de máquina virtual de Azure Marketplace con Azure PowerShell.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ImageInfoType = 'Custom'
          CustomInfoResourceID  = '/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Compute/galleries/<GalleryName>/images/<ImageName>/versions/<ImageVersion>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Para cambiar el almacén de claves y el secreto que almacena la contraseña de la cuenta de administrador local, ejecute el siguiente comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMAdminCredentialsUsernameKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
          VMAdminCredentialsPasswordKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Para cambiar el tamaño de la máquina virtual a D8s_v5 y al tipo de disco del sistema operativo a SSD Premium, ejecute el siguiente comando. El nombre del disco del sistema operativo de los hosts de sesión actualizados tiene un nuevo nombre en el formato SessionHostName-DateTime_Hash.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMSizeId = 'Standard_D8s_v5'
          DiskInfoType = 'Premium_LRS'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   Vea la configuración del host de sesión para comprobar los cambios mediante la ejecución del siguiente comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostConfiguration @parameters | FL *
   

3. Opcional: si desea actualizar la directiva de administración del host de sesión antes de programar una actualización, ejecute el siguiente comando mediante el Update-AzWvdSessionHostManagement cmdlet . Como alternativa, puede invalidar valores específicos al programar una actualización, que solo se usan para esa actualización. Para ver los valores de zona horaria válidos, vea Get-TimeZone PowerShell reference (Get-TimeZone PowerShell reference ) y use el valor de la StandardName propiedad . Se recomienda establecer UpdateDeleteOriginalVM = $true para que no sea necesario limpiar los recursos del host de sesión después de una actualización.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       ScheduledDateTimeZone = '<TimeZoneID>'
       UpdateDeleteOriginalVM = <$true or $false>
       UpdateMaxVmsRemoved = '<Quantity>'
       UpdateLogOffDelayMinute = '<Minutes>'
       UpdateLogOffMessage = '<Message>'
   }
   
   Update-AzWvdSessionHostManagement @parameters
   

   Para ver las propiedades de la directiva de administración de host de sesión actualizada, ejecute el siguiente comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagement @parameters
   

4. Para programar una actualización, use el Invoke-AzWvdInitiateSessionHostUpdate cmdlet con los ejemplos siguientes. Puede programar una actualización para que se inicie inmediatamente o especificar una hora en la que desee que se inicie la actualización, hasta un máximo de dos semanas. Estos son algunos comandos de ejemplo:

   • Para programar que una actualización se inicie inmediatamente y use los valores de la directiva de administración del host de sesión, ejecute el siguiente comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Para programar una actualización en una fecha y hora especificadas (con el formato AAAA-MM-DD HH:mm) y usar los valores de la directiva de administración del host de sesión, ejecute el siguiente comando.

     $dateTime = Get-Date -Date "2024-03-15 01:30"
     
     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ScheduledDateTime = $dateTime
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Para iniciar una actualización programada, ejecute el siguiente comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = Start
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

5. Para ver las propiedades de la actualización programada, ejecute el siguiente comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
   

A continuación se muestra cómo supervisar el progreso de una actualización mediante el Azure Portal.

1. En la información general de Azure Virtual Desktop, seleccione Grupos de hosts y, a continuación, seleccione el grupo de hosts para el que programó una actualización.

2. Seleccione Hosts de sesión.

3. Un banner azul proporciona el estado de la actualización. Solo muestra un momento dado, por lo que debe seleccionar Actualizar para comprobar el progreso más reciente.

Si seleccionó iniciar la actualización inmediatamente, el mensaje indicará que la actualización está programada mientras comienza, pero este mensaje se actualiza una vez que se actualiza. Durante una actualización, verá el número de hosts de sesión de tamaño por lotes que se quitan del grupo de hosts durante la actualización.

Aquí se muestra cómo supervisar el progreso de una actualización mediante el módulo Az.DesktopVirtualization de PowerShell.

Desde la sesión de PowerShell existente, use el Get-AzWvdSessionHostManagementsUpdateStatus cmdlet con los ejemplos siguientes para obtener los detalles de la actualización actual.

• Para ver el progreso de la actualización más reciente, ejecute los siguientes comandos:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters |
       FL PercentComplete,
       ProgressExecutionStartTime,
       ProgressSessionHostsCompleted,
       ProgressSessionHostsInProgress,
       ProgressSessionHostsRollbackFailed,
       ProgressTotalSessionHost,
       EndTime
  
  $updateProgress
  

• Para ver todos los parámetros de la actualización más reciente, ejecute el siguiente comando:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
  
  $updateProgress
  

Aquí se muestra cómo pausar, reanudar, cancelar o reintentar una actualización mediante el Azure Portal.

1. En la información general de Azure Virtual Desktop, seleccione Grupos de hosts y, a continuación, seleccione el grupo de hosts para el que programó una actualización.

2. Seleccione Hosts de sesión y, a continuación, seleccione Administrar actualización del host de sesión.

3. Seleccione Pausar, Reanudar, Cancelar o Reintentar según el estado actual de la actualización.

4. Seleccione Actualizar para actualizar el mensaje de estado en el banner azul. Puede tardar aproximadamente 20 segundos en mostrar el estado correcto.

A continuación se muestra cómo pausar, reanudar, cancelar o reintentar una actualización mediante el módulo Az.DesktopVirtualization de PowerShell.

Desde la sesión de PowerShell existente, use el Invoke-AzWvdControlSessionHostUpdate cmdlet con los ejemplos siguientes para pausar o reanudar la actualización actual.

1. En primer lugar, compruebe el estado de actualización ejecutando el siguiente comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Status
   

2. En función de la acción que quiera realizar, use uno de los ejemplos siguientes.

   • Para pausar una actualización, ejecute el siguiente comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Pause'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Para reanudar la actualización, ejecute el siguiente comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Resume'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Para cancelar una actualización e incluir un mensaje, ejecute el siguiente comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Cancel'
          CancelMessage = '<Message>'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Para volver a intentar una actualización, ejecute el siguiente comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Retry'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

3. Compruebe la acción de actualización y el estado después de realizar una acción ejecutando el siguiente comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Action, Status