Instalar los VDA mediante la línea de comandos
Introducción
Este artículo se aplica en caso de instalar, actualizar y personalizar los agentes de Virtual Delivery Agent (VDA) en máquinas con sistemas operativos Windows.
En este artículo, se describe cómo emitir comandos de instalación del VDA. Antes de comenzar una instalación, revise la sección Instalar los VDA para conocer aspectos a tener en cuenta durante la instalación, cuáles son los programas de instalación, y qué información debe especificarse durante el proceso.
Instalar un VDA desde la línea de comandos
Para instalar un VDA (y ver el progreso de ejecución del comando y los valores de retorno), debe tener permisos administrativos elevados, o bien, debe usar la opción Ejecutar como administrador.
- En la máquina donde va a instalar el VDA, inicie sesión en Citrix Cloud.
- En el menú superior de la izquierda, seleccione Mis servicios > DaaS.
- En la parte superior derecha, haga clic en Descargas y seleccione Descargar VDA. Se le redirigirá a la página de descargas de VDA. Busque el instalador de VDA que quiera utilizar y haga clic en Descargar archivo.
-
Una vez completada la descarga, ejecútelo. Use las opciones descritas en este artículo.
-
Para el componente Virtual Delivery Agent para SO multisesión, ejecute
VDAServerSetup.exe -
Para el componente Virtual Delivery Agent para SO de sesión única, ejecute
VDAWorkstationSetup.exe -
Para el componente de servicios principales de Virtual Delivery Agent para SO de sesión única, ejecute
VDAWorkstationCoreSetup.exe.
-
Para extraer los archivos antes de la instalación, use la opción /extract con la ruta de acceso absoluta, por ejemplo: .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia (el directorio debe existir; de lo contrario, la extracción falla). A continuación, en un comando aparte, ejecute el comando correspondiente con las opciones válidas que se indican en este artículo.
-
Para
VDAServerSetup_XXXX.exe, ejecute<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe -
Para
VDAWorkstationCoreSetup_XXXX.exe, ejecute<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe -
Para
VDAWorkstationSetup_XXXX.exe, ejecute<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 los 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, especifique
/components vda,plugins.Si se omite la opción
plugins, solo se instala el VDA (la aplicación Citrix Workspace no).Esta opción no es válida cuando se utiliza el instalador
VDAWorkstationCoreSetup.exe. Ese instalador no puede instalar la aplicación Citrix Workspace. -
-
/controllers “controller [*controller*]…”
Lista de nombres de dominio completos (FQDN) de Citrix Cloud Connectors, escritos entre comillas rectas, con los que se puede comunicar el VDA. No especifique ambas opciones,
/site_guidy/controllers. -
/disableexperiencemetrics
Impide que los análisis recopilados durante la instalación, la actualización o la eliminación se carguen automáticamente en Citrix.
-
/enable_hdx_ports
Abre los puertos del Firewall de Windows requeridos por el VDA y por las funciones especificadas (excepto la Asistencia remota de Windows) si se detecta el servicio del Firewall de Windows, incluso aunque el firewall no esté habilitado. Si se utiliza un firewall distinto o no se utiliza ninguno, es necesario configurar el firewall manualmente. Para obtener información acerca de los puertos, consulte Puertos de red.
Para abrir los puertos UDP que usa el transporte adaptable HDX, especifique la opción
/enable_hdx_udp_ports, además de la opción/enable_hdx_ports. -
/enable_hdx_udp_ports
Abre los puertos UDP en el firewall de Windows que requiere el transporte adaptable HDX, si se detecta el servicio Firewall de Windows (incluso aunque el firewall no esté habilitado). Si se utiliza un firewall distinto o no se utiliza ninguno, es necesario configurar el firewall manualmente. Para obtener información acerca de los puertos, consulte Puertos de red.
Para abrir los puertos que utiliza el VDA, especifique la opción
/enable_hdx_ports, además de la opción/enable_hdx_udp_ports. -
/enable_real_time_transport
Habilita o inhabilita el uso de UDP para los paquetes de audio (Transferencia de audio RealTime para audio). Habilitar esta función puede mejorar el rendimiento del audio. Incluya la opción
/enable_hdx_portssi quiere que los puertos UDP se abran automáticamente si se detecta el servicio de Firewall de Windows. -
/enable_remote_assistance
Habilita la función de remedo en la Asistencia remota de Windows para utilizarla con las funciones de Supervisar. Si especifica esta opción, la Asistencia remota de Windows abrirá los puertos dinámicos en el firewall.
-
/enablerestore o /enablerestorecleanup
(Válido solo para VDA de sesión única) Habilita el retorno automático al punto de restauración si falla la instalación o actualización del VDA.
Si la instalación/actualización se completa correctamente:
-
/enablerestorecleanupindica al instalador que quite el punto de restauración. -
/enablerestoreindica al instalador que conserve el punto de restauración, aunque no se haya utilizado.
Para obtener información más detallada, consulte Restaurar en caso de error al instalar o actualizar.
-
-
/enable_ss_ports
Abre los puertos del firewall de Windows que se requieren para compartir la pantalla, si se detecta el servicio Firewall de Windows, incluso si el firewall no está habilitado. Si se utiliza un firewall distinto o no se utiliza ninguno, es necesario configurar el firewall manualmente.
-
/exclude “componente”[,”componente”]
Impide la instalación de uno o varios componentes opcionales, separados por comas y escritos entre comillas rectas. Por ejemplo, para instalar o actualizar un VDA en una imagen que se administra mediante Machine Creation Services, se 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 Supportability Tools
- 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 agentes VDA en la ficha Supervisar. En las páginas Detalles del usuario y Punto final, el panel “Personalización” y el panel “Duración de inicio de sesión” fallan. En las páginas Panel de mandos y Tendencias, el panel Duración media de inicios de sesión solo mostrará datos para máquinas que tengan Profile Management instalado.Aunque use una solución de terceros para la administración de perfiles, Citrix recomienda instalar y ejecutar el servicio Citrix Profile Management. No es necesario habilitar el servicio Citrix Profile Management.
Si va a usar MCS para aprovisionar máquinas virtuales, no excluya Machine Identity Service.
Si especifica
/excludee/includeadditionalcon el mismo nombre de componente adicional, ese componente no se instala.Esta opción no es válida cuando se utiliza el instalador
VDAWorkstationCoreSetup.exe. El instalador excluye automáticamente muchos de los 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 y escritos entre comillas. Los nombres de los componentes distinguen entre mayúsculas y minúsculas.
Esta opción puede ser útil cuando está creando una implementación de acceso con Remote PC y quiere instalar componentes que no están incluidos de manera predeterminada. Los valores válidos son:
- Citrix Profile Management
- Citrix Profile Management WMI Plug-in
- Citrix Personalization for App-V - VDA
- Citrix Supportability Tools
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
- Capa de personalización de usuarios
- Citrix Web Socket VDA Registration Tool
Si especifica
/excludee/includeadditionalcon el mismo nombre de componente, ese componente no se instala. -
/installdir directorio
Directorio vacío existente donde se instalarán los componentes. Valor predeterminado = C:\Archivos de programa\Citrix.
-
/install_mcsio_driver
No usar. En su lugar, use
/includeadditional "Citrix MCS IODriver"o/exclude "Citrix MCS IODriver" -
/logpath path
Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no puede crearla. Predeterminado = “%TEMP%\Citrix\XenDesktop Installer”
Esta opción no está disponible en la interfaz gráfica.
-
/masterimage
Válido solamente cuando se instala un VDA en una VM. Establece el VDA como imagen. Esta opción equivale 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 equivale a
/masterimage. -
/masterpvsimage
Especifica que esta máquina se utilizará como imagen con Citrix Provisioning o una herramienta de aprovisionamiento de terceros (como Microsoft System Center Configuration Manager).
-
/no_mediafoundation_ack
Comprueba que Microsoft Media Foundation no está instalado, y algunas funciones multimedia de HDX no se instalan ni funcionan. Si se omite esta opción y Media Foundation no está instalado, falla la instalación de VDA. La mayoría de las ediciones Windows admitidas vienen con Media Foundation ya instalado, a excepción de las ediciones N.
-
/nodesktopexperience
Válido solo cuando se instala un VDA para 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 que se reinicie el sistema después de la instalación. El VDA no se puede usar hasta después de reiniciarse.
-
/noresume
De forma predeterminada, cuando se necesita reiniciar la máquina durante una instalación, el instalador se reanuda automáticamente después de que se complete el reinicio. Para anular el valor predeterminado, especifique
/noresume. Puede ser útil si debe volver a montar el medio o quiere capturar información durante una instalación automatizada. -
/portnumber puerto
Válido solamente si se especifica la opción
/reconfig. Número de puerto para habilitar las comunicaciones entre VDA y Controller. El puerto previamente configurado queda inhabilitado a menos que sea el puerto 80. -
/proxyconfig “dirección o ruta del archivo PAC”
Válido solo si el comando contiene
/includeadditional "Citrix Rendezvous V2". La dirección o la ruta del archivo PAC del proxy para uso con el protocolo Rendezvous. Para obtener más información sobre la funcionalidad, consulte 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
- Formato de dirección de proxy:
-
/quiet o /passive
No aparece ninguna interfaz de usuario durante la instalación. La única prueba de que está teniendo lugar el proceso de instalación y configuración aparece en el Administrador de tareas de Windows. Si se omite esta opción, se abre la interfaz gráfica.
-
/reconfigure
Personaliza los parámetros de VDA configurados anteriormente cuando se usa con las opciones
/portnumber,/controllerso/enable_hdx_ports. Si se especifica esta opción sin especificar también la opción/quiet, se abrirá la interfaz gráfica para personalizar VDA. -
/remotepc
Válido solo para implementaciones de acceso con Remote PC (SO de sesión única) o conexiones intermediadas (SO multisesión).
Esta opción no es válida cuando se utiliza el instalador
VDAWorkstationCoreSetup.exe. El instalador excluye la instalación de estos componentes. -
/remove_appdisk_ack
Autoriza al instalador de VDA a desinstalar el plug-in de VDA para AppDisks si está instalado.
-
/remove_pvd_ack
Autoriza al instalador de VDA a desinstalar el disco 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 a Citrix los análisis recopilados durante la instalación, la actualización o la eliminación. Si se omite esta opción (o se indica 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 un servidor Windows compatible. Omita esta opción cuando instale un VDA multisesión en un servidor Windows. Antes de usar esta opción, consulte VDI de servidor.
-
/site_guid guid
Identificador único global de la unidad organizativa (OU) de Active Directory para el sitio. Esto asocia un escritorio virtual con un sitio cuando se usa Active Directory para la detección (el método de detección predeterminado y recomendado es la actualización automática). El GUID del sitio es una de las propiedades del sitio que se muestra en Studio. No especifique ambas opciones,
/site_guidy/controllers. -
/tempdir directorio
Directorio que contiene los archivos temporales durante la instalación. Valor predeterminado = c:\Windows\Temp.
Esta opción no está disponible en la interfaz gráfica.
-
/virtualmachine
Válido solamente cuando se instala un VDA en una VM. Invalida la detección de un equipo físico por parte del instalador, donde la información de BIOS que se pasa a las VM las hace aparecer como equipos físicos.
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 agente VDA
-
Instale un VDA en un SO multisesión. El siguiente comando instala un VDA en un sistema operativo multisesión.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimageEl VDA se usará como imagen.
-
Instale un VDA con SO multisesión o un VDA con SO de sesión única. Este comando instala un VDA con SO multisesión o un VDA con 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 /norebootSepare cada FQDN del Delivery Controller con una coma. Tenga en cuenta que
XXXXrepresenta la versión del VDA. -
Instale un VDA de los servicios principales en un SO de sesión única. El siguiente comando instala un VDA con los servicios principales en un SO de sesión única para utilizarlo en una implementación de VDA o de acceso con Remote PC.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /norebootLa aplicación Citrix Workspace y otros servicios no principales no se instalan. Se especifica la dirección de un Cloud Connector, y los puertos del Firewall de Windows se abren automáticamente. El administrador gestiona los reinicios.
Personalizar un VDA mediante línea de comandos
Después de instalar un VDA, puede personalizar varios parámetros. Ejecute XenDesktopVDASetup.exe mediante una o varias de las siguientes opciones.
-
/reconfigure(opción necesaria para personalizar un VDA) -
/ho/help /quiet/noreboot/controllers/portnumber port/enable_hdx_ports
Qué hacer a continuación
-
Para revisar todo el proceso de configuración, consulte Planificar y crear una implementación.