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 izquierdo, 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 Virtual Delivery Agent de SO multisesión, ejecute
VDAServerSetup.exe -
Para el Virtual Delivery Agent de SO de sesión única, ejecute
VDAWorkstationSetup.exe -
Para el Virtual Delivery Agent de Servicios principales de 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). (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
Son válidas las siguientes opciones con uno o varios comandos: VDAServerSetup.exe, VDAWorkstationSetup.exe y VDAWorkstationCoreSetup.exe.
-
/components component[,component]
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 (no la aplicación Citrix Workspace).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 las opciones
/site_guidni/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 el transporte adaptable HDX usa, 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 usa 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 mantenga el punto de restauración, aunque no se haya usado.
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.
-
/excluir “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 MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
La exclusión de 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 de 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, el 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 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, utilice
/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”
Solo es válido 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 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 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 las opciones
/site_guidni/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 de 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 con una o más 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.