Instalar VDA mediante la línea de comandos
Introducción
Este artículo se aplica a la instalación, actualización y personalización de Virtual Delivery Agents (VDA) en máquinas con sistemas operativos Windows.
Este artículo describe cómo emitir comandos de instalación de VDA. Antes de iniciar una instalación, revisa Instalar VDA para obtener información sobre las consideraciones de instalación, los instaladores y lo que debes especificar durante la instalación.
Instalar un VDA desde la línea de comandos
Para instalar un VDA (y ver el progreso de la ejecución del comando y los valores de retorno), debes tener permisos administrativos elevados o usar Ejecutar como administrador.
- En la máquina donde vas a instalar el VDA, inicia sesión en Citrix Cloud.
- En el menú superior izquierdo, selecciona Soluciones > DaaS.
- En la parte superior derecha, haz clic en Descargas y selecciona Descargar VDA. Se te redirigirá a la página de descarga de VDA. Busca el instalador de VDA que quieras y haz clic en Descargar archivo.
-
Una vez completada la descarga, ejecuta su nombre. Usa las opciones descritas en este artículo.
-
Para el Virtual Delivery Agent de SO multisesión, ejecuta
VDAServerSetup.exe -
Para el Virtual Delivery Agent de SO de sesión única, ejecuta
VDAWorkstationSetup.exe -
Para el Virtual Delivery Agent de servicios principales de SO de sesión única, ejecuta
VDAWorkstationCoreSetup.exe
-
Para extraer los archivos antes de instalarlos, usa /extract con la ruta absoluta, por ejemplo .\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
Opciones de línea de comandos para instalar un VDA
Las siguientes opciones son válidas con uno o más de los comandos: VDAServerSetup.exe, VDAWorkstationSetup.exe y VDAWorkstationCoreSetup.exe.
-
/components componente[,componente]
Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:
-
VDA: Virtual Delivery Agent
-
PLUGINS: aplicación Citrix Workspace™ para Windows
Para instalar el VDA y la aplicación Citrix Workspace, especifica
/components vda,plugins.Si se omite la opción
plugins, solo se instala el VDA (no la aplicación Citrix Workspace).Esta opción no es válida cuando se usa el instalador
VDAWorkstationCoreSetup.exe. Ese instalador no puede instalar la aplicación Citrix Workspace. -
-
/controllers “controlador [controlador]…”
FQDN de Citrix Cloud Connectors separados por espacios con los que el VDA puede comunicarse, entre comillas rectas. No especifiques las opciones
/site_guidy/controllersa 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 del firewall de Windows que el VDA y las funciones habilitadas requieren (excepto 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 configurarlo manualmente. Para obtener información sobre los puertos, consulta Puertos de red.
Para abrir los puertos UDP que el transporte adaptativo HDX, especifica la opción
/enable_hdx_udp_ports, además de la opción/enable_hdx_ports. -
/enable_hdx_udp_ports
Abre los puertos UDP del firewall de Windows que el transporte adaptativo HDX requiere, 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 configurarlo manualmente. Para obtener información sobre los puertos, consulta Puertos de red.
Para abrir los puertos que usa el VDA, especifica la opción
/enable_hdx_ports, además de la opción/enable_hdx_udp_ports. -
/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_portssi 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 duplicación en Asistencia remota de Windows para usarla con las funciones de Monitor. Si especificas esta opción, Asistencia remota de Windows abre los puertos dinámicos en el firewall.
-
/enablerestore o /enablerestorecleanup
(Válido solo para VDA de sesión única) Permite volver automáticamente al punto de restauración si la instalación o actualización del VDA falla.
Si la instalación/actualización se completa correctamente:
-
/enablerestorecleanupindica al instalador que quite el punto de restauración. -
/enablerestoreindica al instalador que mantenga 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_ss_ports
Abre los puertos del firewall de Windows necesarios para compartir la 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 configurarlo manualmente.
-
/exclude “componente”[,”componente”]
Impide la instalación de uno o varios componentes opcionales separados por comas, cada uno entre comillas rectas. Por ejemplo, la instalación o actualización de un VDA en una imagen administrada por MCS necesita el componente Machine Identity Service. Los valores válidos son:
- Machine Identity Service
- Citrix Profile Management
- Citrix Profile Management WMI Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
Excluir Citrix Profile Management de la instalación (
/exclude "Citrix Profile Management") afecta a la supervisión y la solución de problemas de los VDA desde la consola Monitor. En las páginas Detalles de usuario y Punto final, 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 muestra datos solo para las máquinas que tienen Profile Management instalado.Aunque utilices una solución de Profile Management de terceros, Citrix te recomienda que instales y ejecutes el servicio Citrix Profile Management. No es necesario habilitar el servicio Citrix Profile Management.
Si tienes previsto usar MCS para aprovisionar máquinas virtuales, no excluyas Machine Identity Service.
Si especificas
/excludey/includeadditionalcon el mismo nombre de componente, el componente no se instala.Esta opción no es válida cuando se utiliza 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 varios componentes opcionales separados por comas, cada uno entre comillas rectas. Los nombres de los componentes distinguen entre mayúsculas y minúsculas.
Esta opción puede ser útil cuando creas una implementación de Acceso con PC remoto y quieres instalar componentes que no se incluyen de forma predeterminada. Los valores válidos son:
- Citrix Profile Management
- Citrix Profile Management WMI Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
- User personalization layer
- Citrix Web Socket VDA Registration Tool
Si especificas
/excludey/includeadditionalcon el mismo nombre de componente, ese componente no se instala. -
/installdir directorio
Directorio vacío existente donde se instalarán los componentes. Predeterminado = c:\Program Files\Citrix.
-
/install_mcsio_driver
No lo uses. 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 cuando se instala un VDA en una máquina virtual. Configura el VDA como una imagen. Esta opción es equivalente a
/mastermcsimage.Esta opción no es válida cuando se utiliza el instalador
VDAWorkstationCoreSetup.exe. -
/mastermcsimage
Especifica que esta máquina se utilizará como imagen con Machine Creation Services. Esta opción es equivalente a
/masterimage. -
/masterpvsimage
Especifica que esta máquina se utilizará como imagen con Citrix Provisioning™ o con una herramienta de aprovisionamiento de terceros (como Microsoft System Center Configuration Manager).
-
/no_mediafoundation_ack
Reconoce que Microsoft Media Foundation no está instalado y que varias funciones multimedia de HDX™ no están instaladas y no funcionan. Si se omite esta opción y Media Foundation no está instalado, la instalación del VDA falla. La mayoría de las ediciones de Windows compatibles vienen con Media Foundation ya instalado, excepto las ediciones N.
-
/nodesktopexperience
Válido solo cuando se instala un VDA de SO multisesión. Impide la habilitación de la función Enhanced Desktop Experience. Esta función también se controla con la configuración de directiva de Citrix Enhanced Desktop Experience.
-
/noreboot
Impide un reinicio después de la instalación. El VDA no se puede usar hasta después de un reinicio.
-
/noresume
De forma predeterminada, cuando se necesita reiniciar una máquina durante una instalación, el instalador se reanuda automáticamente una vez completado 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. -
/portnumber puerto
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 anteriormente se deshabilita, a menos que sea el puerto 80. -
/proxyconfig “dirección o ruta de archivo PAC”
Válido solo si el comando contiene
/includeadditional "Citrix Rendezvous V2". La dirección o la ruta del archivo PAC del proxy que se utilizará con el protocolo Rendezvous. Para obtener más información sobre las funciones, consulta Protocolo Rendezvous.- Formato de dirección de proxy:
http://<url-o-ip>:<puerto> - Formato de archivo PAC:
http://<url-o-ip>:<puerto>/<ruta>/<nombre_de_archivo>.pac
- Formato de dirección de proxy:
-
/quiet o /passive
No aparece ninguna interfaz de usuario durante la instalación. La única evidencia del proceso de instalación y configuración se encuentra 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,/controllerso/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 de varias sesiones).
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. -
/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.
-
/remove
Quita los componentes especificados con la opción
/components. -
/removeall
Quita el VDA. No quita la aplicación Citrix Workspace (si está instalada).
-
/sendexperiencemetrics
Envía automáticamente los análisis recopilados durante la instalación, actualización o eliminación a Citrix. 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 de SO de sesión única en un servidor Windows compatible. Omite esta opción al instalar un VDA de varias sesiones en un servidor Windows. Antes de usar esta opción, consulta Server VDI.
-
/site_guid guid
Identificador único global del sitio de la unidad organizativa (OU) de Active Directory. 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_guidy/controllersa 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 máquina virtual. Anula la detección por parte del instalador de una máquina física, donde la información del BIOS pasada a las máquinas virtuales 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: Instalar un VDA
-
Instalar un VDA en un SO de varias sesiones. El siguiente comando instala un VDA en un SO de varias sesiones.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimageEl VDA se usará como una imagen.
-
Instalar un VDA de SO de varias sesiones o un VDA de SO de sesión única. El siguiente comando instala un VDA de SO de varias sesiones o un VDA de SO de sesión única.
VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /norebootSepara cada FQDN de delivery controller™ con una coma. Ten en cuenta que
XXXXrepresenta la versión del VDA. -
Instalar un VDA de servicios principales en un SO de sesión única. 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 VDA.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /norebootLa aplicación Citrix Workspace y otros servicios no principales no están instalados. Se especifica la dirección de un Cloud Connector y los puertos del servicio Firewall de Windows se abren automáticamente. El administrador gestiona los reinicios.
Personalizar un VDA mediante la línea de comandos
Después de instalar un VDA, puedes personalizar varias configuraciones. Ejecuta XenDesktopVDASetup.exe usando una o varias de las siguientes opciones.
-
/reconfigure(obligatorio al personalizar un VDA) -
/ho/help /quiet/noreboot/controllers/portnumber port/enable_hdx_ports
Pasos siguientes
-
Para revisar todo el proceso de configuración, consulta Planificar y crear una implementación.