Citrix Virtual Apps and Desktops Service

Instalar los VDA mediante la línea de comandos

Importante:

Si va a actualizar un VDA que tiene instalado el componente Personal vDisk (PvD), consulte Si el VDA tiene un disco Personal vDisk instalado.

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 Instalar agentes 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

Asegúrese de que la máquina está unida a un dominio antes de instalar el software de 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. 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 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 esta opción, 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.

  • /controllerscontroller [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_guid y /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 sonido (Transferencia de sonido RealTime 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 Supervisar. Si especifica esta opción, la Asistencia remota de Windows abrirá los puertos dinámicos en el firewall.

  • /excludecomponente”[,”componente”]

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

    • Machine Identity Service
    • Citrix Profile Management
    • Plug-in WMI de Citrix Profile Management
    • Citrix Universal Print Client
    • Citrix Telemetry Service
    • Citrix Personalization para App-V - VDA
    • Citrix Supportability Tools
    • Citrix Files para Windows
    • Citrix Files para Outlook
    • Capa de personalización de usuarios
    • Workspace Environment Management

    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 muestra datos de 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 /exclude e /includeadditional con 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
    • Plug-in WMI de Citrix Profile Management
    • Citrix Universal Print Client
    • Citrix Telemetry Service
    • Citrix Personalization para App-V - VDA
    • Citrix Supportability Tools
    • Citrix Files para Windows
    • Citrix Files para Outlook
    • Capa de personalización de usuarios
    • Workspace Environment Management

    Si especifica /exclude e /includeadditional con 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

    Habilita la memoria caché de escritura de E/S de MCS para optimizar el almacenamiento.

  • /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 utiliza el instalador VDAWorkstationCoreSetup.exe.

  • /mastermcsimage

    Especifica que esta máquina se utilizará como imagen maestra con Machine Creation Services. Esta opción equivale a /masterimage.

  • /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).

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

  • /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 sesión única) o conexiones intermediadas (SO multisesión). Excluye la instalación de los componentes siguientes:

    • Citrix Personalization for App-V
    • Citrix Profile Management
    • Plug-in WMI de Citrix Profile Management
    • Machine Identity Service
    • Citrix Supportability Tools
    • Citrix Files para Windows
    • Citrix Files para Outlook
    • Capa de personalización de usuarios
    • Workspace Environment Management

    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 del VDA a desinstalar el plug-in de VDA para AppDisks si está instalado.

  • /remove_pvd_ack

    Autoriza al instalador del 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 utilizar 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_guid y /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.

  • /wem_add_firewall_rules

    Agrega reglas de firewall del agente de WEM.

  • /wem_agent_cache_location

    Ubicación alternativa de caché del agente de WEM.

  • /wem_agent_port

    Puerto que el agente de WEM utiliza para comunicarse con el servidor de infraestructura de WEM.

  • /wem_cached_data_sync_port

    Puerto que el agente de WEM utiliza para sincronizar la memoria caché con el servidor de infraestructura de WEM.

  • /wem_cloud_connectors

    Lista separada por comas de Citrix Cloud Connectors de la ubicación de recursos que contiene la implementación de WEM.

  • /wem_server

    Nombre de dominio completo (FQDN) o dirección IP del servidor de infraestructura de WEM.

Ejemplos: Instalar un agente VDA

El siguiente comando instala un VDA en un sistema operativo multisesión. 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 sesión única 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 mediante una o varias de las siguientes opciones.

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

Qué hacer a continuación

Crear catálogos de máquinas

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

Instalar los VDA mediante la línea de comandos