Instalar los VDA mediante la línea de comandos

Este artículo se aplica en caso de instalar y personalizar los agentes VDA en máquinas con sistemas operativos Windows.

Importante:

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.

Citrix proporciona scripts de ejemplo para instalar, quitar o actualizar los VDA. Para obtener más información, consulte Instalar agentes VDA mediante scripts.

Instalar un VDA

Para instalar un VDA (y ver el progreso de ejecución del comando y los valores de retorno), debe tener privilegios administrativos elevados, o bien, debe usar la opción Ejecutar como administrador.

  1. En la máquina donde va a instalar el VDA, inicie sesión en Citrix Cloud.
  2. En el menú superior izquierdo, seleccione Mis servicios > Virtual Apps and Desktops.
  3. En la parte superior derecha, haga clic en Descargas y seleccione Descargar VDA en el menú desplegable. Se le redirigirá a la página de descargas de VDA. Busque el instalador del VDA que quiera utilizar y haga clic en Descargar archivo.
  4. Una vez completada la descarga, ejecútelo. Use las opciones descritas en este artículo.

    • Para el componente Virtual Delivery Agent para sistema operativo de servidor, ejecute VDAServerSetup.exe

    • Para el componente Virtual Delivery Agent para sistema operativo de escritorio, ejecute VDAWorkstationSetup.exe

    • Para el componente de servicios principales de Virtual Delivery Agent para sistema operativo de escritorio, 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, falla la extracción.) A continuación, en un comando aparte, ejecute VDAWorkstationCoreSetup.exe desde el directorio que contiene el contenido extraído (en el ejemplo anterior, CitrixVDAInstallMedia). Use las opciones válidas que aparecen a continuación.

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.

  • /baseimage

    Esta tecnología está obsoleta. Válido solamente cuando se instala un VDA para SO de escritorio en una VM. Habilita el uso de discos Personal vDisk con una imagen maestra.

    Esta opción no es válida cuando se usa el instalador 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.

    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 “controller[controller] […]”

    Lista de nombres de dominio completos (FQDN) de Cloud Connectors, escritos entre comillas, con los que se puede comunicar el VDA. No especifique las opciones /site_guid y /controllers a la vez.

  • /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_framehawk_port

    Abre los puertos UDP que usa Framehawk. De forma predeterminada, False.

  • /enable_hdx_ports

    Abre los puertos del Firewall de Windows requeridos por Cloud Controller y por las características 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 para comunicarse con el Controller, 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 se requieren para 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 puertos adicionales que use el VDA para comunicarse con el Controller y las funcionalidades habilitadas, 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 sonido (Transferencia de sonido en tiempo real para sonido). Habilitar esta función puede mejorar el rendimiento del sonido. Incluya la opción /enable_hdx_ports si 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 supervisión del componente Citrix Cloud Director. Si especifica esta opción, la Asistencia remota de Windows abrirá los puertos dinámicos en el firewall.

  • /exclude “<component>”[,”<component>”]

    Impide la instalación de uno o varios componentes opcionales, separados por comas y escritos entre comillas. Por ejemplo, instalar o actualizar un VDA en una imagen que no se administra mediante Machine Creation Services no requiere el componente Machine Identity Service. Los valores válidos son:

    • AppDisks VDA Plug-in
    • Personal vDisk
    • Machine Identity Service
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrix Universal Print Client
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Agente de Smart Tools
    • Citrix Files para Windows

    Excluir Citrix Profile Management de la instalación (con la opción /exclude “Citrix User Profile Manager”) afectará a la supervisión y la solución de problemas de los VDA con el componente Citrix Cloud Director. En las páginas “Detalles del usuario” y “Punto final”, fallan los paneles “Personalización” y “Duración de inicio de sesión”. 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.

    Incluso aunque use una solución externa para la administración de perfiles de usuario, 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 /exclude e /includeadditional con el mismo nombre de componente adicional, ese componente no se instala.

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

  • /h o /help

    Muestra la ayuda del comando.

  • /hdxflashv2only

    Impide la instalación de binarios antiguos de redirección de Flash para mejorar la seguridad.

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

  • /includeadditional

    Incluye la instalación de uno o varios componentes opcionales, separados por comas y escritos entre comillas. Esta opción puede ser útil cuando está creando una implementación de acceso con Remote PC y quiere instalar componentes adicionales que no están incluidos de manera predeterminada. Los valores válidos son:

    • Personal vDisk
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Citrix Universal Print Client
    • Citrix Telemetry Service
    • Citrix Personalization for App-V - VDA
    • Citrix Supportability Tools
    • Agente de Smart Tools
    • Citrix Files para Windows

    Si especifica /exclude e /includeadditional con el mismo nombre de componente adicional, ese componente no se instala.

  • /installdir <directory>

    Directorio vacío existente donde se instalarán los componentes. Valor predeterminado = C:\Archivos de programa\Citrix.

  • /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 maestra. Esta opción equivale a /mastermcsimage.

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

  • /mastermcsimage

    Especifica que esta máquina se utilizará como imagen maestra con Machine Creation Services para aprovisionar las máquinas virtuales.

  • /masterpvsimage

    Especifica que esta máquina se utilizará como imagen maestra con Citrix Provisioning o una herramienta de aprovisionamiento de terceros (como Microsoft System Center Configuration Manager) para aprovisionar las máquinas virtuales.

  • /no_mediafoundation_ack

    Comprueba que Microsoft Media Foundation no está instalado, y algunas funciones de HDX multimedia no se instalarán y no funcionarán. 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 Microsoft Media Foundation ya instalado, a excepción de las ediciones N.

  • /nodesktopexperience

    Válido solamente cuando se instala un VDA para SO de servidor. Impide la habilitación de la característica Enhanced Desktop Experience. Esta característica también está controlada por 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.

  • /optimize

    Válido solamente cuando se instala un VDA en una VM. Habilita la optimización de los agentes VDA que se ejecutan en una VM en un hipervisor. La optimización de VM incluye la inhabilitación de archivos sin conexión, la inhabilitación de la desfragmentación de fondo y la reducción del tamaño del registro de sucesos. No especifique esta opción para implementaciones de acceso con Remote PC. Para obtener más información, consulte CTX125874.

  • /portnumber port

    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.

  • /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, /controllers o /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 escritorio) o conexiones con broker (SO de servidor). Excluye la instalación de los componentes siguientes:

    • Citrix Personalization for App-V
    • Citrix User Profile Manager
    • Citrix User Profile Manager WMI Plugin
    • Machine Identity Service
    • Personal vDisk
    • Citrix Supportability Tools
    • Citrix Files para Windows

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

  • /remove

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

  • /removeall

    Quita todos los componentes de VDA instalados.

  • /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 escritorio en un servidor Windows respaldado. Omita esta opción cuando instale un VDA para SO de servidor en un servidor Windows. Antes de usar esta opción, consulte VDI de servidor.

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

  • /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 el descubrimiento (el método de descubrimiento 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_guid y /controllers a la vez.

  • /tempdir directory

    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 hacen aparecer como equipos físicos.

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

Ejemplos: Instalar un agente VDA

El siguiente comando instala un VDA en un SO de servidor. El VDA se usará como una imagen maestra.

VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimge

El siguiente comando instala un VDA con los servicios principales en un SO de escritorio para utilizarlo en una implementación de VDI o de acceso con Remote PC. La 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 abrirán automáticamente. El administrador gestionará los reinicios.

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

Personalizar un VDA mediante línea de comandos

Después de instalar un VDA, puede personalizar varios parámetros. Ejecute XenDesktopVDASetup.exe utilizando una o varias de las siguientes opciones.

  • /reconfigure (opción necesaria para personalizar un VDA)
  • /h o /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber puerto
  • /enable_hdx_ports

Qué hacer a continuación

Crear catálogos de máquinas

Para revisar todo el proceso de configuración, consulte Instalar y configurar.