Instalar VDA

Last published : Oct 24, 2026
Related information
Planificar y crear una implementación
Instalar VDA mediante la línea de comandos

Introducción

Este artículo comienza con una descripción de los VDA de Windows y los instaladores de VDA disponibles. El resto del artículo describe los pasos del asistente de instalación de VDA. Se proporcionan equivalentes de línea de comandos. Para obtener más información, consulte Instalar VDA mediante la línea de comandos.
Para obtener información sobre los VDA de Linux, consulte Linux Virtual Delivery Agent.
Ver una introducción a los VDA.
Vídeo de introducción a los VDA

Consideraciones de instalación

El artículo Citrix DaaS describe qué son los VDA y qué hacen. Aquí tiene más información.
  • Recopilación de análisis: Los análisis se recopilan automáticamente al instalar o actualizar componentes. De forma predeterminada, esos datos se cargan automáticamente a Citrix cuando finaliza la instalación. Además, al instalar componentes, se le inscribe automáticamente en el Citrix Customer Experience Improvement Program (CEIP), que carga datos anónimos. Además, durante una instalación o actualización, se le ofrece la oportunidad de inscribirse en Call Home.
    Si una instalación de VDA falla, un analizador MSI analiza el registro MSI fallido y muestra el código de error exacto. El analizador sugiere un artículo de CTX, si se trata de un problema conocido. El analizador también recopila datos anonimizados sobre el código de error del fallo. Estos datos se incluyen con otros datos recopilados por CEIP. Si finaliza la inscripción en CEIP, los datos recopilados por el analizador MSI ya no se envían a Citrix.
    Para obtener información sobre estos programas, consulte Citrix Insight Services.
  • Aplicación Citrix Workspace™: La aplicación Citrix Workspace para Windows no se instala de forma predeterminada al instalar un VDA. Puede descargar e instalar o actualizar la aplicación Citrix Workspace para Windows y otras aplicaciones Citrix Workspace desde el sitio web de Citrix. Alternativamente, puede hacer que esas aplicaciones Citrix Workspace estén disponibles desde Workspace o un servidor StoreFront™.
  • Servicio de cola de impresión: El servicio de cola de impresión de Microsoft debe estar habilitado. No puede instalar un VDA correctamente si ese servicio está deshabilitado.
  • Microsoft Media Foundation: La mayoría de las ediciones de Windows compatibles vienen con Media Foundation ya instalado. Si la máquina en la que está instalando un VDA no tiene Microsoft Media Foundation (como las ediciones N), varias funciones multimedia no se instalarán y no funcionarán.
    • Redirección de Flash
    • Redirección de Windows Media
    • Redirección de vídeo HTML5
    • Redirección de cámara web HDX™ RealTime
    Puede aceptar la limitación o finalizar la instalación del VDA y reiniciarla más tarde, después de instalar Media Foundation. En la interfaz gráfica, esta opción se presenta en un mensaje. En la línea de comandos, puede usar la opción /no_mediafoundation_ack para aceptar la limitación.
  • Grupo de usuarios locales: Al instalar el VDA, se crea automáticamente un nuevo grupo de usuarios locales llamado Direct Access Users. Para un VDA de SO de sesión única, este grupo se aplica solo a las conexiones RDP. Para un VDA de SO multisesión, este grupo se aplica a las conexiones ICA® y RDP.
  • Requisito de dirección de Cloud Connector: El VDA debe tener al menos una dirección de Cloud Connector válida (en la misma ubicación de recursos) con la que comunicarse. De lo contrario, no se pueden establecer sesiones. Las direcciones de Cloud Connector se especifican al instalar el VDA. Para obtener información sobre otras formas de especificar las direcciones de Cloud Connector donde los VDA pueden registrarse, consulte Registro de VDA.
  • Consideraciones sobre el sistema operativo:
    • Consulte los Requisitos del sistema para ver las plataformas, los sistemas operativos y las versiones compatibles.
    • Asegúrese de que cada sistema operativo mantenga las últimas actualizaciones.
    • Asegúrese de que los VDA tengan los relojes del sistema sincronizados. La infraestructura Kerberos que protege la comunicación entre las máquinas requiere sincronización.
    • Hay disponible una guía de optimización para máquinas con Windows 10 en CTX216252.
    • Si intenta instalar (o actualizar a) un VDA de Windows en un SO que no es compatible con esa versión de VDA, un mensaje describe sus opciones. Para obtener más información, consulte Requisitos del sistema y Sistemas operativos anteriores.
  • MSI instalados: Varios MSI se instalan automáticamente al instalar un VDA. Puede evitar la instalación de algunos MSI en la página Componentes adicionales de la interfaz gráfica o con la opción /exclude en la CLI. Para otros, la única forma de evitar su instalación es con la opción de CLI /exclude.
  • Unido a un dominio: Asegúrese de que la máquina esté unida a un dominio antes de instalar el software VDA.

Reinicios durante la instalación del VDA

Se requiere un reinicio al final de la instalación del VDA. Ese reinicio se produce automáticamente de forma predeterminada.
Para minimizar el número de otros reinicios necesarios durante la instalación del VDA:
  • Asegúrese de que haya una versión compatible de Microsoft .NET Framework instalada antes de comenzar la instalación del VDA.
  • Para máquinas con SO multisesión de Windows, instale y habilite los servicios de rol de RDS antes de instalar el VDA.
Si no instala esos requisitos previos antes de instalar el VDA:
  • Si utiliza la interfaz gráfica o la interfaz de línea de comandos sin la opción /noreboot, la máquina se reinicia automáticamente después de instalar el requisito previo.
  • Si utiliza la interfaz de línea de comandos con la opción /noreboot, debe iniciar el reinicio.
Después de cada reinicio, la instalación del VDA continúa. Si está instalando desde la línea de comandos, puede evitar la reanudación automática con la opción /noresume.
Al actualizar un VDA a la versión 7.17 o una versión posterior compatible, se produce un reinicio durante la actualización. Este reinicio no se puede evitar.

Restaurar en caso de error de instalación o actualización

Nota:
Esta función solo está disponible para VDA de sesión única.
Si la instalación o actualización de un VDA de sesión única falla y la función "restaurar en caso de error" está habilitada, la máquina vuelve a un punto de restauración que se estableció antes de que comenzara la instalación o actualización.
Cuando se inicia la instalación o actualización de un VDA de sesión única con esta función habilitada, el instalador crea un punto de restauración del sistema antes de comenzar la instalación o actualización real. Si la instalación o actualización del VDA falla, la máquina vuelve al estado del punto de restauración. La carpeta %temp%/Citrix contiene los registros de implementación y otra información sobre la restauración.
De forma predeterminada, esta función está inhabilitada.
Si planea habilitar esta función, asegúrese de que la restauración del sistema no esté deshabilitada a través de una configuración de GPO (Computer Configuration > Administrative Templates > System > System Restore).
Para habilitar esta función al instalar o actualizar un VDA de sesión única:
  • Cuando utilice la interfaz gráfica de un instalador de VDA (como al usar Autostart o el comando XenDesktopVDASetup.exe sin opciones de restauración o silenciosas), seleccione la casilla de verificación Habilitar restauración automática si la actualización falla en la página Resumen.
    Si la instalación/actualización se completa correctamente, el punto de restauración no se utiliza, pero se conserva.
  • Ejecute un instalador de VDA con la opción /enablerestore o /enablerestorecleanup.
    • Si utiliza la opción /enablerestorecleanup y la instalación/actualización se completa correctamente, el punto de restauración se elimina automáticamente.
    • Si utiliza la opción /enablerestore y la instalación/actualización se completa correctamente, el punto de restauración no se utiliza, pero se conserva.

Instaladores de VDA

Los instaladores de VDA se pueden descargar directamente desde la consola de Citrix Cloud™.
De forma predeterminada, los archivos de los instaladores autoextraíbles se extraen a la carpeta Temp. Los archivos extraídos a la carpeta Temp se eliminan automáticamente una vez finalizada la instalación. Alternativamente, puede usar el comando /extract con una ruta absoluta.
Hay tres instaladores de VDA independientes disponibles para descargar.
VDAServerSetup.exe Instala un VDA de SO multisesión.
VDAWorkstationSetup.exe Instala un VDA de SO de sesión única.
VDAWorkstationCoreSetup.exe Instala un VDA de SO de sesión única optimizado para implementaciones de Acceso con PC remoto o instalaciones VDI principales. El Acceso con PC remoto utiliza máquinas físicas. Las instalaciones VDI principales son máquinas virtuales que no se utilizan como imagen. Este instalador implementa solo los servicios principales necesarios para las conexiones VDA. Por lo tanto, solo admite un subconjunto de las opciones válidas con el instalador VDAWorkstationSetup.
Para obtener más información, consulte Instalar VDA para sus respectivas versiones.

Solución de problemas

En la pantalla de Studio para un grupo de entrega, la entrada Versión de VDA instalada en el panel Detalles podría no ser la versión instalada en las máquinas. La pantalla de Programas y características de Windows de la máquina muestra la versión real del VDA.

Citrix Optimizer

Citrix Optimizer es una herramienta para sistemas operativos Windows que ayuda a los administradores de Citrix a optimizar los VDA eliminando y optimizando varios componentes.
Después de instalar un VDA y completar el reinicio final, descargue e instale Citrix Optimizer. Consulte CTX224676. El artículo de CTX contiene el paquete de descarga, además de instrucciones sobre cómo instalar y usar Citrix Optimizer.

Personalizar un VDA

Más adelante, para personalizar (cambiar información de) un VDA instalado:
  1. Desde la función de Windows para quitar o cambiar programas, seleccione Citrix Virtual Delivery Agent o Citrix Remote PC Access/VDI Core Services VDA. A continuación, haga clic con el botón derecho y seleccione Cambiar.
  2. Seleccione Personalizar la configuración del Virtual Delivery Agent.
Cuando se inicie el instalador, cambie cualquier configuración disponible.

Personalizar el puerto para la comunicación con los Cloud Connectors

Puede personalizar el puerto que utilizan los VDA para comunicarse con los Cloud Connectors según sus requisitos de seguridad específicos. Esta función es útil si su equipo de seguridad no permite que el puerto predeterminado (puerto 80) esté abierto o si el puerto predeterminado ya está en uso.
Nota:
Al cambiar el número de puerto predeterminado, solo se admiten valores dentro del rango 1024–65535.
Para personalizar el puerto, siga estos pasos:
  1. Agregar el número de puerto de VDA en los Citrix Cloud Connectors
  2. Configuración adicional de Citrix Cloud Connector™ al usar Rendezvous V1
  3. Agregar el número de puerto de VDA en los VDA

Agregar el número de puerto de VDA en los Citrix Cloud Connectors

Vaya al Citrix Cloud Connector y ejecute los dos comandos de PowerShell siguientes:
  • PS C:\> & 'C:\Program Files\Citrix\XaXdCloudProxy\XaXdCloudProxy.exe' -VdaPort <port number>
  • PS C:\> & 'C:\Program Files\Citrix\Broker\Service\HighAvailabilityService.exe' -VdaPort <port number> -ConfigureFirewall
Ejemplo:
  • PS C:\> & 'C:\Program Files\Citrix\XaXdCloudProxy\XaXdCloudProxy.exe' -VdaPort 18000
  • PS C:\> & 'C:\Program Files\Citrix\Broker\Service\HighAvailabilityService.exe' -VdaPort 18000 -ConfigureFirewall
Al personalizar el puerto, tenga en cuenta lo siguiente:
  • Debe usar el mismo número de puerto en ambos comandos.
  • Debe ejecutar ambos comandos en todos los Cloud Connectors.
  • Para comunicarse correctamente con los Cloud Connectors, asegúrese de que todos los VDA utilicen el mismo número de puerto.
  • El puerto que configure persiste a través de las actualizaciones del conector.

Configuración adicional de Citrix Cloud Connector al usar Rendezvous V1

Establezca la siguiente clave de registro en cada Citrix Cloud Connector:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist
Nombre: WorkerPortNumber Tipo: REG_DWORD Valor: <port number>

Agregar el número de puerto de VDA en los VDA

Instale el VDA con la configuración predeterminada y configúrelo de la siguiente manera. Si el VDA ya está instalado, continúe con los pasos siguientes.
  1. En el VDA, abra XenDesktopVdaSetup.exe, que se encuentra en C:\Program Files\Citrix\XenDesktopVdaSetup\XenDesktopVdaSetup.exe.
  2. En la página Protocol and Port, agregue el número de puerto personalizado.
    Página de protocolo y puerto
  3. En la página Delivery Controller™, introduzca el FQDN del Controller.
    Delivery Controller page
  4. Haga clic en Next para continuar con el asistente y completar la configuración.
Los números de puerto se reconfiguran correctamente.
Nota:
Es posible que vea el siguiente mensaje de error al probar una conexión de Controller: No running instance of a Controller found on < la dirección de Controller que introdujo >. Si la dirección es correcta, puede ignorar el mensaje.

Solución de problemas

Para comprobar si los puertos personalizados están configurados correctamente, vaya al Cloud Connector y realice los siguientes pasos de solución de problemas:
  1. verificar que existen las dos siguientes claves de registro.
    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist Name: CustomVDAPortNumber Type: REG_DWORD Data: 18000
    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist Name: CustomVDAPortNumberHA Type: REG_DWORD Data: 18000
  2. Ejecute el siguiente comando para crear un archivo .txt.
    • netsh http show urlacl > <filepath>.txt
    Ejemplo:
    • netsh http show urlacl > c:\reservations.txt
  3. Abra el archivo .txt y compruebe las cuatro URL siguientes para verificar que se utiliza el puerto correcto.
    • http://+:18000/Citrix/CdsController/IRegistrar/
    • http://+:18000/Citrix/CdsController/ITicketing/
    • http://+:18000/Citrix/CdsController/IDynamicDataSink/
    • http://+:18000/Citrix/CdsController/INotifyBroker/
  4. verificar que se han creado las dos siguientes reglas de firewall y que los puertos necesarios están abiertos.
    • Citrix XaXdProxy
    • Citrix Broker Service (TCP-In)

Otra información

Pasos siguientes

Crear catálogos de máquinas.
Para revisar todo el proceso de configuración, consulte Planificar y crear una implementación.