Instalar mediante la línea de comandos
Lo descrito en este artículo se aplica en caso de instalar componentes en máquinas con sistemas operativos Windows. Para obtener información acerca de los agentes VDA para sistemas operativos Linux, consulte la documentación de Linux Virtual Delivery Agent.
Importante:
En este artículo, se describe cómo emitir comandos de instalación de producto. Antes de comenzar cualquier instalación, consulte el artículo Antes de instalar. Este artículo contiene las descripciones de los instaladores disponibles.
Para ver el progreso de ejecución del comando y los valores de retorno, debe ser el administrador original o debe utilizar la opción Ejecutar como administrador. Para obtener más información, consulte la documentación de comandos de Microsoft.
Para complementar el uso de los comandos de instalación directamente, se proporcionan scripts de ejemplo en la imagen ISO del producto. Puede usarlos para instalar, actualizar o quitar máquinas VDA de Active Directory. Para obtener más información, consulte Instalar agentes VDA mediante scripts.
Usar el instalador de producto completo
Para acceder a la interfaz de línea de comandos del instalador de producto completo:
- Descargue el paquete de productos de Citrix. Se necesitan credenciales de cuenta de Citrix para tener acceso al sitio de descargas.
- Descomprima el archivo. Si lo prefiere, puede grabar un DVD del archivo ISO.
- Inicie una sesión con una cuenta de administrador local en el servidor donde quiera instalar los componentes.
- Introduzca el DVD en la unidad o monte el archivo ISO.
- Desde el directorio
\x64\XenDesktop Setupde los medios de instalación, ejecute el comando apropiado.
Para instalar los componentes principales
Ejecute el comando XenDesktopServerSetup.exe con las opciones que aparecen en Opciones de línea de comandos para instalar componentes principales.
Para instalar un VDA
Ejecute el comando XenDesktopVDASetup.exe con las opciones que aparecen en Opciones de línea de comandos para instalar un VDA.
Para instalar Universal Print Server
Siga las instrucciones indicadas en Instalar Universal Print Server mediante línea de comandos.
Para instalar el Servicio de autenticación federada
Citrix recomienda usar la interfaz gráfica.
Para instalar el Autoservicio de restablecimiento de contraseñas
Siga las instrucciones indicadas en la documentación del Autoservicio de restablecimiento de contraseñas.
Usar el instalador independiente de VDA
Se necesitan credenciales de cuenta de Citrix para tener acceso al sitio de descargas. Debe tener privilegios administrativos elevados antes de iniciar la instalación o debe usar la opción Ejecutar como administrador.
- Descargue el paquete correspondiente de Citrix:
| Nombre del componente en la página de descarga | Nombre del archivo del instalador |
|---|---|
| Virtual Delivery Agent de SO de servidor <versión> | VDAServerSetup.exe |
| Virtual Delivery Agent de SO de escritorio <versión> | VDAWorkstationSetup.exe |
| Virtual Delivery Agent de SO de escritorio con los servicios principales <versión> | VDAWorkstationCoreSetup.exe |
- Extraiga primero los archivos del paquete a un directorio existente y ejecute el comando de instalación, o bien ejecute el paquete directamente.
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 XenDesktopVdaSetup.exe desde el directorio que contiene el contenido extraído (en el ejemplo anterior, CitrixVDAInstallMedia). Utilice las opciones válidas que aparecen en Opciones de línea de comandos para instalar un VDA.
Para ejecutar el paquete descargado, ejecute su nombre: VDAServerSetup.exe, VDAWorkstationSetup.exe o VDAWorkstationCoreSetup.exe. Utilice las opciones válidas que aparecen en Opciones de línea de comandos para instalar un VDA.
Si conoce el instalador de producto completo:
-
Ejecute el paquete independiente
VDAServerSetup.exeoVDAWorkstationSetup.execomo si fuera el comandoXenDesktopVdaSetup.exeen todo excepto el nombre. -
El instalador
VDAWorkstationCoreSetup.exees diferente, porque solo admite un subconjunto de las opciones disponibles para los demás.
Opciones de línea de comandos para instalar componentes principales
Las siguientes opciones son válidas para instalar los componentes principales con el comando XenDesktopServerSetup.exe. Para obtener más información acerca de las opciones, consulte Instalar componentes principales.
/components <componente> [,<componente>]…
Lista de los componentes, separados por comas, para instalar o quitar. Los valores válidos son:
CONTROLLER: Controller
DESKTOPSTUDIO: Studio
DESKTOPDIRECTOR: Director
LICENSESERVER: Citrix License Server
Si se omite esta opción, se instalarán todos los componentes o se quitarán si también se especifica la opción /remove.
(en versiones anteriores a 7.15 LTSR CU6, los valores válidos incluían StoreFront; a partir de la versión 7.15 LTSR CU6, utilice el comando de instalación dedicado de StoreFront que se indica en Instalar StoreFront).
/configure_firewall
Si el servicio Firewall de Windows se está ejecutando, abre todos los puertos del Firewall de Windows que necesitan los componentes que se están instalando, incluso aunque el firewall no esté habilitado. Si se utiliza un firewall de terceros o no se utiliza ninguno, es necesario abrir esos puertos manualmente.
/disableexperiencemetrics
Impide que los análisis recopilados durante la instalación, la actualización o la eliminación se carguen automáticamente en Citrix.
/exclude
Impide la instalación de una o varias funciones o tecnologías, separadas por comas y escritas entre comillas rectas (no tipográficas). Los valores válidos son:
Local Host Cache Storage (LocalDB): Impide la instalación de la base de datos utilizada para la Caché de host local. Esta opción no afecta a la instalación de SQL Server Express para usarlo como la base de datos del sitio.
Smart Tools Agent: Impide la instalación del agente de Citrix Smart Tools.
Nota:
A partir de CU4, Smart Tools ya se incluirá en el instalador. Las instancias de Smart Tools presentes en instalaciones anteriores permanecen intactas.
/help o /h
Muestra la ayuda del comando.
/installdir <directory>
Directorio vacío existente donde se instalarán los componentes. Predeterminado = c:\Program Files\Citrix.
/logpath <path>
Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no puede crearla. Valor predeterminado = "%TEMP%\Citrix\XenDesktop Installer"
/no_remote_assistance
Válido solamente cuando se instala Director. Inhabilita la funcionalidad de remedo de usuarios que utiliza la Asistencia remota de Windows.
/noreboot
Impide que se reinicie el sistema después de la instalación. (para la mayoría de los componentes principales, el reinicio no está habilitado de forma predeterminada).
/nosql
Impide la instalación de Microsoft SQL Server Express en el servidor donde se instala Controller. Si se omite esta opción, se instalará SQL Server Express como la base de datos del sitio. (esta opción no afecta a la instalación de la LocalDB de SQL Server Express, que se puede utilizar para la Memoria caché del host local).
/quiet o /passive
No aparece ninguna interfaz de usuario durante la instalación. La única evidencia de que está teniendo lugar el proceso de instalación aparece en el Administrador de tareas de Windows. Si se omite esta opción, se abre la interfaz gráfica.
/remove
Quita los componentes principales especificados con la opción /components.
/removeall
Quita todos los componentes principales 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.
/tempdir <directorio>
Directorio que contiene los archivos temporales durante la instalación. Valor predeterminado = c:\Windows\Temp.
/xenapp
Instala el componente XenApp. Si se omite esta opción, se instala XenDesktop.
Ejemplos: Instalar componentes principales
El siguiente comando instala el controlador de XenDesktop, Studio, Citrix Licensing y SQL Server Express en un servidor. Los puertos de firewall necesarios para la comunicación entre componentes se abrirán automáticamente.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
El siguiente comando instala el Controller de XenApp, Studio, y SQL Server Express en el servidor. Los puertos de firewall necesarios para la comunicación entre componentes se abrirán automáticamente.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
Opciones de línea de comandos para instalar un VDA
Las siguientes opciones son válidas con uno o más de los comandos: XenDesktopVDASetup.exe, VDAServerSetup.exe, VDAWorkstationSetup.exe o VDAWorkstationCoreSetup.exe.
/baseimage
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. Para obtener más información, consulte Personal vDisk.
Esta opción no es válida cuando se utiliza 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: Citrix Receiver para Windows (CitrixReceiver.exe)
Por ejemplo, para instalar el VDA y no Citrix Receiver, especifique /components vda.
Si se omite esta opción, se instalan todos los componentes.
Esta opción no es válida cuando se utiliza el instalador VDAWorkstationCoreSetup.exe. Ese instalador no puede instalar Citrix Receiver.
/controllers “<controller> [<controller>] […]”
Lista de nombres de dominio completos (FQDN) de Controllers, separados por espacios y 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_framehawk_port
Abre los puertos UDP que usa Framehawk. De forma predeterminada, False.
/enable_hdx_3d_pro
Instala el VDA en el modo HDX 3D Pro.
/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 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 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 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 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, escritos entre comillas rectas. Por ejemplo, instalar o actualizar un VDA en una imagen que no se administrará mediante Machine Creation Services no requiere los componentes Personal vDisk ni Machine Identity Service. Los valores válidos son:
Personal vDiskMachine Identity ServiceCitrix User Profile ManagerCitrix User Profile Manager WMI PluginCitrix Universal Print ClientCitrix Telemetry ServiceCitrix Personalization for App-V - VDA
Excluir Citrix Profile Management de la instalación (con la opción /exclude "Citrix User Profile Manager") afecta a la supervisión y la solución de problemas de los agentes VDA a través de Citrix Director. 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 de usuario, Citrix recomienda instalar y ejecutar el servicio Citrix Profile Management. No es necesario habilitar el servicio Citrix Profile Management.
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.
/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.
/installdir <directory>
Directorio vacío existente donde se instalarán los componentes. Predeterminado = c:\Program Files\Citrix.
/logpath <path>
Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no puede crearla. Valor 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 no es válida cuando se utiliza el instalador VDAWorkstationCoreSetup.exe.
/no_mediafoundation_ack
Comprueba que Microsoft Media Foundation no está instalado, y algunas funciones multimedia de HDX 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.
/nocitrixwddm
Válido solamente en máquinas Windows 7 que no incluyen un controlador WDDM. Inhabilita la instalación del controlador WDDM de Citrix.
Esta opción no está disponible en la interfaz gráfica.
/nodesktopexperience
Válido solamente cuando se instala un VDA para SO de servidor. 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.
/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 CTX224676.
/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 solamente para implementaciones de acceso con Remote PC. Excluye la instalación de los componentes siguientes en un sistema operativo de escritorio:
- Citrix Personalization for App-V
- Citrix User Profile Manager
- Citrix User Profile Manager WMI Plugin
- Machine Identity Service
- Personal vDisk
Esta opción no es válida cuando se utiliza 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 compatible. 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.
Utilice esta opción solo con el instalador de VDA completo. 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 la detección (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 ambas opciones, /site_guid y /controllers.
/tempdir <directorio>
Directorio que contiene los archivos temporales durante la instalación. 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.
Ejemplos: Instalar un agente VDA
Instalar un VDA con el instalador de producto completo
El siguiente comando instala un VDA para SO de escritorio y Citrix Receiver en la ubicación predeterminada en una VM. Este VDA se usará como una imagen maestra. El VDA se registrará inicialmente en el Controller en el servidor denominado “Contr-Main” en el dominio “mydomain”. Asimismo, el VDA usará discos Personal vDisk, la función de optimización y la Asistencia remota de Windows.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /optimize /masterimage /baseimage /enable_remote_assistance
Instalar un VDA de SO de escritorio con el instalador independiente VDAWorkstationCoreSetup
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. Citrix Receiver y otros servicios no principales no se instalan. Se especifica la dirección de un Controller, 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. Desde el directorio \x64\XenDesktop Setup de los medios del producto, ejecute el comando XenDesktopVdaSetup.exe, mediante una o varias de las siguientes opciones, descritas en Opciones de línea de comandos para instalar un VDA.
-
/reconfigure(opción necesaria para personalizar un VDA) -
/ho/help /quiet/noreboot/controllers- Puerto
/portnumber /enable_hdx_ports
Instalar Universal Print Server mediante línea de comandos
Ejecute alguno de los siguientes comandos en cada servidor de impresión:
- En un sistema operativo de 32 bits compatible: desde el directorio
\x86\Universal Print Server\de los medios de instalación de Citrix, ejecuteUpsServer_x86.msi. - En un sistema operativo de 64 bits compatible: desde el directorio
\x64\Universal Print Server\de los medios de instalación de Citrix, ejecuteUpsServer_x64.msi.
Después de instalar el componente Universal Print Server en los servidores de impresión, configúrelo siguiendo las instrucciones de Aprovisionar impresoras.
En este artículo
- Usar el instalador de producto completo
- Usar el instalador independiente de VDA
- Opciones de línea de comandos para instalar componentes principales
- Ejemplos: Instalar componentes principales
- Opciones de línea de comandos para instalar un VDA
- Ejemplos: Instalar un agente VDA
- Personalizar un VDA mediante línea de comandos
- Instalar Universal Print Server mediante línea de comandos