Citrix Virtual Apps and Desktops

Instalar mediante la línea de comandos

March 18, 2026

Contribución de:

Importante:

Si estás actualizando y tu versión actual usa o tiene instalado el software Personal vDisk o AppDisks, consulta Eliminar PvD, AppDisks y hosts no compatibles.

Citrix recopila datos básicos de licencias según sea necesario para sus intereses legítimos, incluido el cumplimiento de las licencias. Para obtener más información, consulta Datos de licencias de Citrix.

Introducción

Este artículo se aplica a la instalación de componentes en máquinas con sistemas operativos Windows. Para obtener información sobre los VDA para sistemas operativos Linux, consulta Agentes de entrega virtual de Linux.

Este artículo describe cómo emitir comandos de instalación de productos. Antes de comenzar cualquier instalación, revisa Prepararse para la instalación. Ese artículo incluye descripciones de los instaladores disponibles.

Para ver el progreso de la ejecución de comandos y los valores de retorno, debes ser el administrador original o usar Ejecutar como administrador. Para obtener más información, consulta la documentación de comandos de Microsoft.

Como complemento al uso directo de los comandos de instalación, se proporcionan scripts de ejemplo en la ISO del producto que instalan, actualizan o quitan VDA en máquinas de Active Directory. Para obtener más detalles, consulta Instalar VDA mediante scripts.

Si intentas instalar o actualizar en una versión del sistema operativo Windows que no es compatible con esta versión de Citrix Virtual Apps and Desktops, un mensaje te guiará a la información sobre tus opciones. Consulta Sistemas operativos anteriores.

Para obtener información sobre cómo Citrix informa los resultados de las instalaciones de componentes, consulta Códigos de retorno de la instalación de Citrix.

Usar el instalador completo del producto

Para acceder a la interfaz de línea de comandos del instalador completo del producto:

Descarga el paquete del producto de Citrix. Se requieren credenciales de cuenta de Citrix para acceder al sitio de descarga.
Descomprime el archivo. Opcionalmente, graba un DVD del archivo ISO.
Inicia sesión en el servidor donde estás instalando los componentes, usando una cuenta de administrador local.
Inserta el DVD en la unidad o monta el archivo ISO.
Desde el directorio \x64\XenDesktop Setup del medio, ejecuta el comando apropiado.

Para instalar componentes principales: Ejecuta XenDesktopServerSetup.exe, con las opciones enumeradas en Opciones de línea de comandos para instalar componentes principales.

Para instalar un VDA: Ejecuta XenDesktopVDASetup.exe con las opciones enumeradas en Opciones de línea de comandos para instalar un VDA.

Para instalar StoreFront: Ejecuta CitrixStoreFront-x64.exe en la carpeta x64 > StoreFront del medio de instalación.

Para instalar Universal Print Server: Sigue las indicaciones en Opciones de línea de comandos para instalar Universal Print Server.

Para instalar Federated Authentication Service: Citrix recomienda usar la interfaz gráfica.

Para instalar Session Recording: Sigue las indicaciones en Session Recording.

Para instalar Workspace Environment Management: Sigue las indicaciones en Workspace Environment Management.

Para instalar Secure Private Access: Ejecuta XenDesktopSPASetup.exe en la carpeta x64 > XenDesktop Setup del medio de instalación. Sigue las indicaciones en Opciones de línea de comandos para instalar Secure Private Access.

Opciones de línea de comandos para instalar componentes principales

Las siguientes opciones de parámetros son válidas al instalar componentes principales con el comando XenDesktopServerSetup.exe. Para obtener más detalles sobre las opciones, consulta Instalar componentes principales.

Nota:

No uses /exclude al usar opciones de línea de comandos para instalar componentes principales.

Si actualizas un componente usando /components, es posible que otros componentes también se actualicen. Esto es para evitar posibles problemas de compatibilidad entre diferentes componentes.

Si quieres actualizar solo un componente, usa el instalador individual de ese componente. Consulta Actualizar una implementación.

/ceipoptin ceipoptin [,ceipoptin] …

Habilita la recopilación de datos de Call Home y del Programa de mejora de la experiencia del cliente (CEIP). Los valores válidos son:
- DIAGNOSTIC: Elige este valor para permitir que Citrix Licensing recopile datos de Call Home.
- ANONYMOUS: Elige este valor para permitir que Citrix Licensing recopile datos CEIP no identificados (que no identifican a los usuarios).
- NONE: Elige este valor para deshabilitar la recopilación de datos CEIP por parte de Citrix Licensing.
Para obtener más información sobre la recopilación de datos de Call Home, consulta Citrix Licensing Call Home.

Para obtener más detalles sobre la recopilación de datos CEIP, consulta Programa de mejora de la experiencia del cliente de Citrix Licensing.

Para obtener más detalles sobre los elementos de datos CEIP, consulta Elementos de datos CEIP de Citrix Licensing.

Para obtener más detalles sobre los datos de licencias de License Server, consulta Datos de licencias de Citrix.
/components componente [,componente] …

Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:
- CONTROLLER: Controller
- DESKTOPSTUDIO: Studio
- WEBSTUDIO: Web Studio
- DESKTOPDIRECTOR: Director
- LICENSESERVER: Citrix License Server
- SECUREPRIVATEACCESS: Secure Private Access

Para instalar solo el VDA y excluir la instalación de otros componentes de Citrix, especifica /components vda.

Esta opción no es válida al usar el instalador VDAWorkstationCoreSetup_xxxx.exe. Ese instalador no puede instalar la aplicación Citrix Workspace ni otros componentes de Citrix.

Si se omite esta opción, se instalan todos los componentes (o se quitan, si también se especifica la opción /remove).

(En versiones anteriores a 2003, los valores válidos incluían STOREFRONT™. Para la versión 2003 y posteriores, usa el comando de instalación de StoreFront dedicado mencionado en Usar el instalador completo del producto).

/onlyprereqs

Solo se instalarán los requisitos previos para los componentes seleccionados. No se instalarán componentes del producto Citrix.
/configure_firewall

Abre todos los puertos del firewall de Windows utilizados por los componentes que se están instalando, si el servicio de Firewall de Windows está en ejecución, incluso si el firewall no está habilitado. Si usas un firewall de terceros o ningún firewall, debes abrir los puertos manualmente.
/disableexperiencemetrics

Evita la carga automática a Citrix de los análisis recopilados durante la instalación, actualización o eliminación.
/help o /h

Muestra la ayuda del comando.
/ignore_hw_check_failure

Permite que la instalación o actualización de Delivery Controller continúe, incluso si las comprobaciones de hardware fallan (por ejemplo, debido a RAM insuficiente). Para obtener más información, consulta Comprobación de hardware.
/ignore_site_test_failure

Válido solo durante la actualización del Controller. Normalmente, cualquier fallo en la prueba del sitio se ignora y la actualización continúa. Si se omite (o se establece en false), cualquier fallo en la prueba del sitio hace que el instalador falle, sin realizar la actualización. Predeterminado = false

Durante una actualización, esta opción se ignora si se detecta una versión de SQL Server no compatible. Para obtener más detalles, consulta Comprobación de la versión de SQL Server.
/installdir directorio

Directorio vacío existente donde se instalarán los componentes. Predeterminado = c:\Program Files\Citrix.
/logpath ruta

Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no la crea. Predeterminado = TEMP%\Citrix\XenDesktop Installer
/no_remote_assistance

Válido solo al instalar Director. Deshabilita la función de seguimiento de usuarios que usa Asistencia remota de Windows.
/noreboot

Evita un reinicio después de la instalación. (Para la mayoría de los componentes principales, un reinicio no está habilitado de forma predeterminada).
/noresume

De forma predeterminada, cuando se necesita un reinicio de la máquina durante una instalación, el instalador se reanuda automáticamente después de que se completa el reinicio. Para anular el valor predeterminado, especifica /noresume. Esto puede ser útil si debes volver a montar el medio o quieres capturar información durante una instalación automatizada.
/nosql

Evita la instalación de Microsoft SQL Server Express en el servidor donde estás instalando el Controller. Si se omite esta opción, se instala SQL Server Express para usarlo como base de datos del sitio.

Esta opción no afecta a la instalación de SQL Server Express LocalDB utilizado para Local Host Cache.
/quiet o /passive

No aparece ninguna interfaz de usuario durante la instalación. La única evidencia del proceso de instalación se encuentra en el Administrador de tareas de Windows. Si se omite esta opción, se inicia la interfaz gráfica.
/remove

Quita los componentes principales especificados con la opción /components.
/removeall

Quita todos los componentes principales instalados.
/sendexperiencemetrics

Envía automáticamente a Citrix los análisis recopilados durante la instalación, actualización o eliminación. Si se omite esta opción (o se especifica /disableexperiencemetrics), los análisis se recopilan localmente, pero no se envían automáticamente.
/tempdir directorio

Directorio que contiene archivos temporales durante la instalación. Predeterminado = c:\Windows\Temp.
/xenapp

Instala Citrix Virtual Apps. Si se omite esta opción, se instala Citrix Virtual Apps and Desktops™.

Ejemplos de instalación de componentes principales

El siguiente comando instala un Delivery Controller™, Studio, Citrix Licensing y SQL Server Express en un servidor. Los puertos del firewall necesarios para las comunicaciones de los componentes se abren automáticamente.

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
<!--NeedCopy-->

El siguiente comando instala un Controller de Citrix Virtual Apps™, Studio y SQL Server Express en el servidor. Los puertos del firewall necesarios para la comunicación de los componentes se abren automáticamente.

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
<!--NeedCopy-->

El siguiente comando instala un Delivery Controller, Secure Private Access y SQL Server Express en un servidor. Los puertos del firewall necesarios para la comunicación de los componentes se abren automáticamente.

\x64\XenDesktop Setup
XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall
<!--NeedCopy-->

Si actualizas de Citrix Virtual Apps and Desktops versión 2407 a 2411 o posterior, o realizas una instalación nueva de la versión 2411 o posterior, actualiza License Server a la última versión (versión 11.2.17 compilación 51000) como primer paso. Luego, actualiza Delivery Controller. No hacerlo resultará en el fallo de las instalaciones y actualizaciones de línea de comandos. Ejecuta los siguientes comandos para actualizar License Server y componentes como Delivery Controller, Web Studio y Citrix Director (asumiendo que estás dentro de la carpeta \x64 en la ISO montada).

Ejecuta lo siguiente:

\x64\Licensing\CitrixLicensing.exe /quiet 
<!--NeedCopy-->

Si has copiado los binarios de Licensing a cualquiera de las unidades locales, ejecuta el siguiente comando:

\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy-->

Ejecuta lo siguiente:

\x64\XenDesktop Setup\XenDesktopServerSetup.exe  /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL
<!--NeedCopy-->

Usar un instalador de VDA independiente

Se requieren credenciales de cuenta de Citrix para acceder al sitio de descarga. Debes tener privilegios administrativos elevados antes de iniciar la instalación o usar Ejecutar como administrador.

Descarga el paquete apropiado de Citrix:
- Agente de entrega virtual de SO multisesión: VDAServerSetup_xxxx.exe
- Agente de entrega virtual de SO de sesión única: VDAWorkstationSetup_xxxx.exe
- Agente de entrega virtual de servicios principales de SO de sesión única: VDAWorkstationCoreSetup_xxxx.exe
Extrae los archivos del paquete a un directorio existente primero y luego ejecuta el comando de instalación, o simplemente ejecuta el paquete.

Para extraer los archivos antes de instalarlos, usa /extract con la ruta absoluta, por ejemplo, C:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. El directorio debe existir. De lo contrario, la extracción fallará. Luego, en un comando separado, ejecuta el comando apropiado, usando las opciones válidas que se enumeran en este artículo.
- Para VDAServerSetup_XXXX.exe, ejecuta <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
- Para VDAWorkstationCoreSetup_XXXX.exe, ejecuta <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe
- Para VDAWorkstationSetup_XXXX.exe, ejecuta <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
Para ejecutar el paquete descargado, ejecuta su nombre: VDAServerSetup.exe, VDAWorkstationSetup.exe o VDAWorkstationCoreSetup.exe. Usa las opciones válidas que se enumeran en este artículo.

Si estás familiarizado con el instalador completo del producto:

Ejecuta el instalador independiente VDAServerSetup.exe o VDAWorkstationSetup.exe como si fuera el comando XenDesktopVdaSetup.exe en todo excepto en su nombre.
El instalador VDAWorkstationCoreSetup.exe es diferente, porque admite un subconjunto de las opciones disponibles para los otros instaladores.

Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:

VDA: Agente de entrega virtual
CSA: Cliente de Citrix Secure Access™
PLUGINS: Aplicación Citrix Workspace™ para Windows
UPL: Capa de personalización de usuario de Citrix (solo para VDA de WS)
SRAGENT: Agente de grabación de sesiones
ASSISTANTAPP: Aplicación Citrix Assistant (solo para VDA de WS)
CEAL: Citrix Elastic App Layering (solo para VDA de TS)

Para instalar el VDA y la aplicación Citrix Workspace para Windows, especifica /components vda,plugins o no especifiques ningún componente.

A partir de esta versión, Citrix Device Trust, Citrix uberAgent y Citrix Workspace Environment Management™ (WEM) Agent están integrados en la instalación predeterminada del VDA. Estos componentes se instalan silenciosamente como parte de la configuración del VDA y ya no se administran como componentes separados.

Nota:

Si se detecta una versión independiente existente de Citrix uberAgent® en el entorno, el instalador no la instalará, actualizará ni desinstalará.

Para instalar solo el VDA y excluir la instalación de otros componentes de Citrix, especifica /components vda.

Esta opción no es válida cuando se usa el instalador VDAWorkstationCoreSetup_xxxx.exe. Ese instalador no puede instalar la aplicación Citrix Workspace ni otros componentes de Citrix.

Opciones de línea de comandos para instalar un VDA

Las siguientes opciones son válidas con uno o más de los siguientes comandos (instaladores): VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe y VDAWorkstationCoreSetup_xxxx.exe.

Para obtener más detalles sobre las opciones, consulta Instalar VDA.

/components componente[,componente]

Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:
- VDA: Agente de entrega virtual
- PLUGINS: Aplicación Citrix Workspace para Windows
- CSA: Cliente de Citrix Secure Access
- UPL: Capa de personalización de usuario de Citrix (solo para VDA de WS)
- SRAGENT: Agente de grabación de sesiones
- ASSISTANTAPP: Aplicación Citrix Assistant (solo para VDA de WS)
- CEAL: Citrix Elastic App Layering (solo para VDA de TS)

Para instalar el VDA y la aplicación Citrix Workspace para Windows, especifica /components vda, plugins, CSA, UPL o no especifiques ningún componente. Si no se especifica ningún componente, solo se instalarán el VDA, SRAGENT y ASSISTANTAPP de forma predeterminada.

Para instalar solo el VDA y excluir la instalación de la aplicación Citrix Workspace y otros componentes, especifica /components vda.

Esta opción no es válida cuando se usa el instalador VDAWorkstationCoreSetup_xxxx.exe. Ese instalador no puede instalar la aplicación Citrix Workspace.

/onlyprereqs

Solo se instalarán los requisitos previos para los componentes seleccionados. No se instalará ningún componente del producto Citrix.
/controllers “controlador [controlador]”

Nombres de dominio completos (FQDN) de los Controllers separados por espacios con los que el VDA puede comunicarse, encerrados entre comillas rectas. No especifiques las opciones /site_guid y /controllers a la vez.
/disableexperiencemetrics

Evita la carga automática de los análisis recopilados durante la instalación, actualización o eliminación a Citrix.
/enable_hdx_ports

Abre los puertos en el firewall de Windows requeridos por el VDA y las funciones habilitadas (excepto la Asistencia remota de Windows), si se detecta el Servicio de firewall de Windows, incluso si el firewall no está habilitado. Si usas un firewall diferente o ningún firewall, debes configurar el firewall manualmente. Para obtener información sobre los puertos, consulta Puertos de red.

Para abrir los puertos UDP que usa el transporte adaptativo de HDX, especifica la opción /enable_hdx_udp_ports, además de esta opción /enable_hdx_ports.
/enable_hdx_udp_ports

Abre los puertos UDP en el firewall de Windows que usa el transporte adaptativo de HDX, si se detecta el Servicio de firewall de Windows, incluso si el firewall no está habilitado. Si usas un firewall diferente o ningún firewall, debes configurar el firewall manualmente. Para obtener información sobre los puertos, consulta Puertos de red.

Para abrir puertos adicionales que usa el VDA, especifica la opción /enable_hdx_ports, además de esta opción /enable_hdx_udp_ports.
/enable_hdx_tls_dtls

Abre los puertos TCP y UDP 443 para HDX™ Direct V1.
/enable_real_time_transport

Habilita o deshabilita el uso de UDP para paquetes de audio (transporte de audio en tiempo real para audio). Habilitar esta función puede mejorar el rendimiento del audio. Incluye la opción /enable_hdx_ports si quieres que los puertos UDP se abran automáticamente cuando se detecte el Servicio de firewall de Windows.
/enable_remote_assistance

Habilita la función de observación en la Asistencia remota de Windows para usarla con Director. Si especificas esta opción, la Asistencia remota de Windows abre los puertos dinámicos en el firewall.
/enablerestore o /enablerestorecleanup

(Válido solo para VDA de sesión única) Habilita la vuelta automática al punto de restauración, si la instalación o actualización del VDA falla.

Si la instalación/actualización se completa correctamente:
- /enablerestorecleanup indica al instalador que quite el punto de restauración.
- /enablerestore indica al instalador que conserve el punto de restauración, aunque no se haya usado.
Para obtener más detalles, consulta Restaurar en caso de error de instalación o actualización.
/ENABLE_SECURE_DEFAULTS

Cambia la configuración predeterminada de varias funciones de habilitada a deshabilitada para una configuración más segura de fábrica. Las funciones relevantes son: redirección de unidades de cliente, redirección de carpetas especiales, arrastrar y soltar, redirección de dispositivos TWAIN de cliente, redirección de dispositivos USB Plug and Play de cliente, redirección de impresoras de cliente, redirección del portapapeles de cliente y redirección de micrófonos de cliente.
/enable_ss_ports

Abre los puertos en el Firewall de Windows que son necesarios para compartir pantalla, si se detecta el Servicio de firewall de Windows, incluso si el firewall no está habilitado. Si usas un firewall diferente o ningún firewall, debes configurar el firewall manualmente.
/SKIPHDXDRIVERCHECK

Omite la comprobación de los controladores HDX™ en el metainstalador del VDA.

/exclude “componente”[,”componente”]

Evita la instalación de uno o más componentes opcionales separados por comas, cada uno encerrado entre comillas rectas. Por ejemplo, la instalación o actualización de un VDA en una imagen que no está administrada por MCS no requiere el componente Machine Identity Service. Los valores válidos son los siguientes:

SO multisesión	SO de sesión única	Servicios principales de SO de sesión única
`Citrix Authentication Identity Assertion VDA Plug-in`	`Citrix Authentication Identity Assertion VDA Plug-in`	`Citrix Authentication Identity Assertion VDA Plug-in`
`Citrix Backup and Restore`	`Citrix Backup and Restore`	`Citrix Browser Content Redirection`
`Citrix deviceTRUST®`	`Citrix deviceTRUST`	`Citrix deviceTRUST`
`uberAgent®`	`uberAgent`	`uberAgent`
`Citrix Secure Access Client`	`Citrix Secure Access Client`	`Citrix Secure Access Client`
`Citrix Workspace Environment Management™ Agent`	`Citrix Workspace Environment Management Agent`	`Citrix Workspace Environment Management Agent`
`Citrix Browser Content Redirection`	`Citrix Browser Content Redirection`	`Citrix Personalization for App-V - VDA`
`Citrix MCS IODriver`	`Citrix MCS IODriver`	`Citrix Telemetry Service`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`	`Citrix Universal™ Print Client`
`Citrix Profile Management`	`Citrix Profile Management`	`Citrix Vda Log Capture Service`
`Citrix Profile Management WMI Plug-in`	`Citrix Profile Management WMI Plug-in`	`CSE Component`
`Citrix Rendezvous V2`	`Citrix Rendezvous V2`	`Director VDA Plug-in`
`Citrix Telemetry Service`	`Citrix Telemetry Service`	`Machine Management Provider`
`Citrix Universal Print Client`	`Citrix Universal Print Client`	`VDA Monitor Plug-in`
`Citrix Vda Log Capture Service`	`Citrix Vda Log Capture Service`	`VDA WMI Proxy Plug-in`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`CSE Component`	`CSE Component`
`Director VDA Plug-in`	`Director VDA Plug-in`
`Machine Identity Service`	`Machine Identity Service`
`Machine Management Provider`	`Machine Management Provider`
`VDA Monitor Plug-in`	`User Personalization Layer`
`VDA WMI Proxy Plug-in`	`VDA Monitor Plug-in`
	`VDA WMI Proxy Plug-in`
`Citrix App Protection Component`	`Citrix App Protection Component`	`Citrix App Protection Component`
`Citrix HyperV Filter Driver`	`Citrix HyperV Filter Driver`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`
`Session Recording Agent`	`Session Recording Agent`
`Elastic App Layering`	`Citrix Assistant App`

Excluir Citrix Profile Management de la instalación (/exclude "Citrix Profile Management") afecta la supervisión y la solución de problemas de los VDA con Citrix Director. En las páginas Detalles del usuario y EndPoint, el panel Personalización y el panel Duración de inicio de sesión fallan. En las páginas Panel y Tendencias, el panel Duración media de inicio de sesión solo muestra datos para las máquinas que tienen Profile Management instalado.

Incluso si usas una solución de administración de perfiles de usuario de terceros, Citrix recomienda que instales y ejecutes el Servicio de administración de perfiles de Citrix. No es necesario habilitar el Servicio de administración de perfiles de Citrix.

Si especificas /exclude y /includeadditional con el mismo nombre de componente, ese componente no se instalará.

Esta opción no es válida cuando se usa el instalador VDAWorkstationCoreSetup.exe. Ese instalador excluye automáticamente muchos de estos elementos.

/h o /help

Muestra la ayuda del comando.

/includeadditional “componente”[,”componente”]

Incluye la instalación de uno o más componentes opcionales separados por comas, cada uno encerrado entre comillas rectas. Esta opción puede ser útil cuando creas una implementación de Acceso con PC remoto y quieres instalar otros componentes que no se incluyen de forma predeterminada. Los valores válidos son los siguientes:

SO multisesión	SO de sesión única
`Citrix Backup and Restore`	`Citrix Backup and Restore`
`Citrix MCS IODriver`	`Citrix MCS IODriver`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`
`Citrix Profile Management`	`Citrix Profile Management`
`Citrix Profile Management WMI Plug-in`	`Citrix Profile Management WMI Plug-in`
`Citrix Rendezvous V2`	`Citrix Rendezvous V2`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`Citrix Web Socket Vda Registration Tool`	`Citrix Web Socket Vda Registration Tool`
`Machine Identity Service`	`Machine Identity Service`
	`User Personalization Layer`

Si especificas /exclude y /includeadditional con el mismo nombre de componente, ese componente no se instalará.

/installdir directorio

Directorio existente vacío donde se instalarán los componentes. Predeterminado = c:\Archivos de programa\Citrix.
/install_mcsio_driver

No usar. En su lugar, usa /includeadditional "Citrix MCS IODriver" o /exclude "Citrix MCS IODriver".
/logpath ruta

Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no la crea. Predeterminado = “%TEMP%\Citrix\XenDesktop Installer”

Esta opción no está disponible en la interfaz gráfica.
/masterimage

Válido solo al instalar un VDA en una VM. Configura el VDA como una imagen para usarla en la creación de otras máquinas. Esta opción es equivalente a /mastermcsimage.

Esta opción no es válida cuando se usa el instalador VDAWorkstationCoreSetup_xxxx.exe.
/mastermcsimage

Especifica que esta máquina se usará como imagen con Machine Creation Services. Esta opción es equivalente a /masterimage.
/masterpvsimage

Especifica que esta máquina se usará como imagen con Citrix Provisioning™ o una herramienta de aprovisionamiento de terceros (como Microsoft System Center Configuration Manager) para aprovisionar VM.
/websockettoken WebSocketToken

Crea un VDA de WebSocket. El WebSocketToken es para el token que se requiere.
/websockettokenfile ArchivoQueContieneElTokenDeWebSocket

Crea un VDA de WebSocket. El ArchivoQueContieneElTokenDeWebSocket es para el archivo que contiene el token que se requiere.
/websockettokenstdin <WebSocketToken

Crea un VDA de WebSocket. El <WebSocketToken es para el token que se requiere que se pasa por STDIN.
/no_mediafoundation_ack

Reconoce que Microsoft Media Foundation no está instalado y que varias funciones multimedia de HDX no se instalarán ni funcionarán. Si se omite esta opción y Media Foundation no está instalado, la instalación del VDA finaliza porque no se cumplen las condiciones previas. La mayoría de las ediciones de Windows compatibles ya tienen Media Foundation instalado, excepto las ediciones N. Si habilitas las funciones de Windows > Funciones multimedia manualmente, es posible que la clave de registro que busca el instalador de Citrix Meta no tenga un valor establecido. Comprueba la clave de registro SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion antes de iniciar el proceso de instalación para confirmar que el valor existe y no está vacío.
/nodesktopexperience

La función Experiencia de escritorio mejorada ya no está disponible. Esta opción (y la configuración de directiva) se ignora, si se especifica.

Válida solo al instalar un VDA para SO multisesión. Impide la habilitación de la función Experiencia de escritorio mejorada. Esta función también se controla con la configuración de directiva de Citrix Experiencia de escritorio mejorada.
/noreboot

Impide un reinicio después de la instalación. El VDA no se puede usar hasta después de un reinicio.
/noresume

Por defecto, cuando se necesita reiniciar una máquina durante una instalación, el instalador se reanuda automáticamente después de que finaliza el reinicio. Para anular el valor predeterminado, especifica /noresume. Esto puede ser útil si necesitas volver a montar el medio o quieres capturar información durante una instalación automatizada.
/physicalmachine

Usa este argumento junto con /remotepc para la instalación de RemotePC. De lo contrario, el VDA podría no comportarse como se espera en ciertos escenarios de usuario.
/portnumber port

Válido solo cuando se especifica la opción /reconfig. Número de puerto que se habilitará para las comunicaciones entre el VDA y el Controller. El puerto configurado previamente se deshabilita, a menos que sea el puerto 80.
/proxyconfig “address or PAC file path”

Si planeas usar el protocolo Rendezvous V2 con servicios como Gateway Service en tu entorno y tienes un proxy no transparente en tu red para conexiones salientes, especifica el proxy aquí. Solo se admiten proxies HTTP. La dirección o la ruta del archivo PAC del proxy para usar con el protocolo Rendezvous. Esta línea de comandos instala automáticamente Citrix Rendezvous V2 como si se hubiera usado /includeadditional “Citrix Rendezvous V2”. Para obtener detalles sobre las funciones, consulta Protocolo Rendezvous.
- Formato de dirección de proxy: http://<url-or-ip>:<port>
- Formato de archivo PAC: http://<url-or-ip>:<port>/<path>/<filename>.pac
/quiet o /passive

No aparece ninguna interfaz de usuario durante la instalación. La única evidencia del proceso de instalación y configuración está en el Administrador de tareas de Windows. Si se omite esta opción, se inicia la interfaz gráfica.
/reconfigure

Personaliza la configuración del VDA configurada previamente cuando se usa con las opciones /portnumber, /controllers o /enable_hdx_ports. Si especificas esta opción sin especificar también la opción /quiet, se inicia la interfaz gráfica para personalizar el VDA.
/remotepc

Válido solo para implementaciones de Acceso con PC remoto (SO de sesión única) o conexiones intermediadas (SO multisesión). Excluye la instalación de cualquier componente adicional (consulta las listas de componentes con las opciones /exclude y /includeadditional).

Esta opción no es válida cuando se usa el instalador VDAWorkstationCoreSetup.exe. Ese instalador excluye automáticamente la instalación de estos componentes.

/remotepc no es compatible con la opción /servervdi.
/remove

Quita los componentes especificados con la opción /components.
/remove_appdisk_ack

Autoriza al instalador del VDA a desinstalar el complemento AppDisks™ VDA si está instalado.
/remove_pvd_ack

Autoriza al instalador del VDA a desinstalar Personal vDisk si está instalado.
/removeall

Quita el VDA. No quita la aplicación Citrix Workspace (si está instalada).
/REMOVEALLWITHCWA

Quita CWA junto con el VDA.
/sendexperiencemetrics

Envía automáticamente a Citrix los análisis recopilados durante la instalación, actualización o eliminación. Si se omite esta opción (o se especifica la opción /disableexperiencemetrics), los análisis se recopilan localmente, pero no se envían automáticamente.
/servervdi

Instala un VDA para SO de sesión única en una máquina Windows multisesión compatible. Omite esta opción al instalar un VDA para SO multisesión en una máquina Windows multisesión.

Antes de usar esta opción, consulta Server VDI.

Usa esta opción solo con el instalador de VDA de producto completo.
/site_guid guid

Identificador único global de la unidad organizativa (OU) de Active Directory del sitio. Esto asocia un escritorio virtual con un sitio cuando usas Active Directory para el descubrimiento (la actualización automática es el método de descubrimiento recomendado y predeterminado). El GUID del sitio es una propiedad del sitio que se muestra en Studio. No especifiques las opciones /site_guid y /controllers a la vez.
/tempdir directory

Directorio para almacenar archivos temporales durante la instalación. Predeterminado = c:\Windows\Temp.

Esta opción no está disponible en la interfaz gráfica.
/virtualmachine

Válido solo al instalar un VDA en una VM. Anula la detección por parte del instalador de una máquina física, donde la información del BIOS pasada a las VM las hace aparecer como máquinas físicas.

Esta opción no está disponible en la interfaz gráfica.
/xendesktopcloud

Indica que el VDA está instalado en una implementación de Citrix DaaS (Citrix Cloud™).

Ejemplos de instalación de un VDA

Instalar un VDA con el instalador de producto completo:

El siguiente comando instala un VDA para SO de sesión única y la aplicación Citrix Workspace en la ubicación predeterminada de una VM. Este VDA se usará como imagen y utilizará MCS para aprovisionar VM. El VDA se registrará inicialmente con el Controller en el servidor llamado Contr-Main en el dominio mydomain. El VDA usará la capa de personalización de usuario y la Asistencia remota de Windows.

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance

Instalar un VDA de SO de sesión única con el instalador independiente VDAWorkstationCoreSetup:

El siguiente comando instala un VDA de servicios principales en un SO de sesión única para usarlo en una implementación de Acceso con PC remoto o VDI. La aplicación Citrix Workspace y otros servicios no principales no se instalan. Se especifica la dirección de un Controller y los puertos del Servicio de Firewall de Windows se abrirán automáticamente. El administrador gestionará los reinicios.

VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

Personalizar un VDA

Después de instalar un VDA, puedes personalizar varias configuraciones. Desde el directorio \x64\XenDesktop Setup del medio del producto, ejecuta XenDesktopVdaSetup.exe, usando una o varias de las siguientes opciones, que se describen en Opciones de línea de comandos para instalar un VDA.

/reconfigure (obligatorio al personalizar un VDA)
/h o /help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports

Solucionar problemas de VDA

En la vista de Studio de un grupo de entrega, la entrada Installed VDA version en el panel Details podría no ser la versión instalada en las máquinas. La vista de Programas y características de Windows de la máquina muestra la versión real del VDA.
Después de instalar un VDA, no puede entregar aplicaciones o un escritorio a los usuarios hasta que se registre con un Delivery Controller.

Para obtener información sobre los métodos de registro de VDA y cómo solucionar problemas de registro, consulta Registro de VDA.

Opciones de línea de comandos para instalar un Universal Print Server

La siguiente opción es válida con el comando XenDesktopPrintServerSetup.exe.

/enable_upsserver_port

Cuando no se especifica esta opción, el instalador muestra la página Firewall de la interfaz gráfica. Selecciona Automáticamente para que el instalador agregue automáticamente las reglas del firewall de Windows, o Manualmente para que el administrador configure el firewall manualmente.

Después de instalar el software en tus servidores de impresión, configura el Universal Print Server siguiendo las instrucciones de Citrix Universal Print Server (UPS).

Opciones de línea de comandos para instalar un Secure Private Access

Las siguientes opciones son válidas con ambos:

Instalador de CVAD: XenDesktopSPASetup.exe
Instalador local de SPA: SecurePrivateAccessSetup_XXXX.exe

/enable_spa_ports

Abre los puertos del firewall de Windows requeridos por Secure Private Access, si se detecta el Servicio de Firewall de Windows, incluso si el firewall no está habilitado. Si usas un firewall diferente o ningún firewall, debes configurar el firewall manualmente. Para obtener información sobre los puertos, consulta Puertos de red.
/nosql

Impide la instalación de Microsoft SQL Server Express en el servidor donde estás instalando Secure Private Access. Si se omite esta opción, se instala SQL Server Express para usarlo como base de datos del sitio.
/help o /h o /?

Muestra la ayuda del comando
/noreboot

Impide un reinicio después de la instalación. Secure Private Access no se puede usar hasta después de un reinicio.
/quiet o /passive

No aparece ninguna interfaz de usuario durante la instalación. La única evidencia del proceso de instalación y configuración está en el Administrador de tareas de Windows. Si se omite esta opción, se inicia la interfaz gráfica.
/remove

Quita Secure Private Access.

Para obtener más detalles sobre las opciones, consulta Instalador de Secure Private Access.

Más información

Para obtener información sobre cómo Citrix informa del resultado de las instalaciones de componentes, consulta Códigos de retorno de la instalación de Citrix.

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

¿Le ha resultado útil?

Instalar mediante la línea de comandos

March 18, 2026

Contribución de:

March 18, 2026

Contribución de:

En este artículo

Introducción
Usar el instalador completo del producto
Opciones de línea de comandos para instalar componentes principales
Ejemplos de instalación de componentes principales
Usar un instalador de VDA independiente
Opciones de línea de comandos para instalar un VDA
Ejemplos de instalación de un VDA
Personalizar un VDA
Solucionar problemas de VDA
Opciones de línea de comandos para instalar un Universal Print Server
Opciones de línea de comandos para instalar un Secure Private Access
Más información

¿Le ha resultado útil?