Instalar mediante la línea de comandos
Este artículo se aplica a la instalación de componentes en máquinas con sistemas operativos Windows. Para obtener información sobre los VDA para sistemas operativos Linux, consulte la documentación de Linux Virtual Delivery Agent.
Importante:
Este artículo describe cómo emitir comandos de instalación del producto. Antes de iniciar cualquier instalación, revise Preparar la instalación. Ese artículo incluye descripciones de los instaladores disponibles.
Para ver el progreso de la ejecución del comando y los valores de retorno, debe ser el administrador original o usar Ejecutar como administrador. Para obtener más información, consulte la documentación de comandos de Microsoft.
Como complemento al uso directo de los comandos de instalación, se proporcionan scripts de ejemplo en la ISO del producto que instalan, actualizan o quitan máquinas VDA en Active Directory. Para obtener más información, consulte Instalar VDA mediante scripts.
Usar el instalador completo del producto
Para acceder a la interfaz de línea de comandos del instalador completo del producto:
- Descargue el paquete del producto de Citrix. Se requieren credenciales de cuenta de Citrix para acceder al sitio de descarga.
- Descomprima el archivo. Opcionalmente, grabe un DVD del archivo ISO.
- Inicie sesión en el servidor donde va a instalar los componentes, con una cuenta de administrador local.
- Inserte el DVD en la unidad o monte el archivo ISO.
- Desde el directorio
\x64\XenDesktop Setupdel medio, ejecute el comando apropiado.
Para instalar componentes principales
Ejecute el comando XenDesktopServerSetup.exe, con las opciones que se enumeran en Opciones de línea de comandos para instalar componentes principales.
Para instalar un VDA
Ejecute el comando XenDesktopVDASetup.exe con las opciones que se enumeran en Opciones de línea de comandos para instalar un VDA.
Para instalar Universal Print Server
Siga las instrucciones de Instalar Universal Print Server mediante la línea de comandos.
Para instalar el Servicio de autenticación federada
Citrix recomienda utilizar la interfaz gráfica.
Para instalar el Servicio de restablecimiento de contraseña de autoservicio
Siga las instrucciones de la documentación del Servicio de restablecimiento de contraseña de autoservicio.
Usar un instalador de VDA independiente
Se requieren credenciales de cuenta de Citrix para acceder al sitio de descarga. Debe tener privilegios administrativos elevados antes de iniciar la instalación o usar Ejecutar como administrador.
- Descargue el paquete adecuado de Citrix:
| Nombre del componente en la página de descarga | Nombre del archivo del instalador |
|---|---|
| Virtual Delivery Agent para SO de servidor <versión> | VDAServerSetup.exe |
| Agente de entrega virtual de SO de escritorio <versión> | VDAWorkstationSetup.exe |
| Agente de entrega virtual de servicios principales de SO de escritorio <versión> | VDAWorkstationCoreSetup.exe |
- Extraiga los archivos del paquete a un directorio existente y, a continuación, ejecute el comando de instalación, o bien, ejecute directamente el paquete.
Para extraer los archivos antes de instalarlos, use /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). Luego, en un comando independiente, ejecute XenDesktopVdaSetup.exe desde el directorio que contiene el contenido extraído (en el ejemplo anterior, CitrixVDAInstallMedia). Utilice las opciones válidas en Opciones de línea de comandos para instalar un VDA.
Para ejecutar el paquete descargado, solo ejecute su nombre: VDAServerSetup.exe, VDAWorkstationSetup.exe o VDAWorkstationCoreSetup.exe. Utilice las opciones válidas en Opciones de línea de comandos para instalar un VDA.
Si está familiarizado con el instalador completo del producto:
-
Ejecute el instalador independiente
VDAServerSetup.exeoVDAWorkstationSetup.execomo si fuera el comandoXenDesktopVdaSetup.exeen todo, excepto en su nombre. -
El instalador
VDAWorkstationCoreSetup.exees diferente, porque admite un subconjunto de las opciones disponibles para los demás instaladores.
Opciones de línea de comandos para instalar componentes principales
Las siguientes opciones son válidas al instalar componentes principales con el comando XenDesktopServerSetup.exe. Para obtener más detalles sobre las opciones, consulte Instalar componentes principales.
/componentes <component> [,<component>] …
Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:
CONTROLLER: Controlador
DESKTOPSTUDIO: Studio
DESKTOPDIRECTOR: Director
LICENSESERVER: Citrix License Server
Si se omite esta opción, se instalan todos los componentes (o se eliminan, si también se especifica la opción /remove).
(En versiones anteriores a 7.15 LTSR CU6, los valores válidos incluían StoreFront. Para la versión 7.15 LTSR CU6 y posteriores, utilice el comando de instalación de StoreFront dedicado que se indica en Instalar StoreFront).
/configure_firewall
Abre todos los puertos del firewall de Windows utilizados por los componentes que se están instalando, si el servicio de Firewall de Windows está en ejecución, incluso si el firewall no está habilitado. Si utiliza un firewall de terceros o ningún firewall, debe abrir los puertos manualmente.
/deshabilitarmetricasdeexperiencia
Impide la carga automática de los análisis recopilados durante la instalación, actualización o eliminación a Citrix.
/excluir
Impide la instalación de una o varias funciones, servicios o tecnologías separados por comas, entre comillas rectas. 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 (Local Host Cache). Esta opción no afecta a si SQL Server Express se instala para su uso como 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 no se incluye en el instalador. Las instancias de Smart Tools presentes en instalaciones anteriores permanecen intactas.
/help o /h
Muestra la ayuda del comando.
/installdir <directorio>
Directorio vacío existente donde se instalarán los componentes. Predeterminado = c:\Program Files\Citrix.
/logpath <ruta>
Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no la crea. Predeterminado = "%TEMP%\Citrix\XenDesktop Installer"
/no_remote_assistance
Válido solo al instalar Director. Deshabilita la función de duplicación de usuario que utiliza Asistencia remota de Windows.
/noreiniciar
Evita un reinicio después de la instalación. (Para la mayoría de los componentes principales, un reinicio no está habilitado de forma predeterminada).
/sinSQL
Evita la instalación de Microsoft SQL Server Express en el servidor donde se está instalando el Controller. Si se omite esta opción, se instala SQL Server Express para usarlo como base de datos del sitio. (Esta opción no tiene ningún efecto en la instalación de SQL Server Express LocalDB utilizado para la caché de host local).
/quiet o /passive
No aparece ninguna interfaz de usuario durante la instalación. La única evidencia del proceso de instalación se encuentra en el Administrador de tareas de Windows. Si se omite esta opción, se inicia la interfaz gráfica.
/quitar
Elimina los componentes principales especificados con la opción /components.
/eliminar_todo
Elimina todos los componentes principales instalados.
/enviar_metricas_experiencia
Envía automáticamente a Citrix los análisis recopilados durante la instalación, actualización o eliminación. Si se omite esta opción (o se especifica /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. Predeterminado = c:\Windows\Temp.
/XenAplicación
Instala XenApp. Si se omite esta opción, se instala XenDesktop®.
Ejemplos: Instalar componentes principales
El siguiente comando instala un Controller de XenDesktop, Studio, Citrix Licensing y SQL Server Express en un servidor. Los puertos del firewall necesarios para las comunicaciones de los componentes se abren automáticamente.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
El siguiente comando instala un Controller de XenApp®, Studio y SQL Server Express en el servidor. Los puertos del firewall necesarios para la comunicación de los componentes se abren 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 siguientes comandos: XenDesktopVDASetup.exe, VDAServerSetup.exe, VDAWorkstationSetup.exe, o VDAWorkstationCoreSetup.exe.
/imagenbase
Válido solo al instalar un VDA para SO de escritorio en una VM. Permite el uso de Personal vDisks 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>[,<component>]
Lista de 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 pero 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 un Citrix Receiver.
/controladores “<controller> [<controller>] […]”
FQDN de los Controllers separados por espacios con los que el VDA puede comunicarse, entre comillas rectas. No especifique las opciones /site_guid y /controllers a la vez.
/deshabilitarmétricasdeexperiencia
Evita la carga automática de los análisis recopilados durante la instalación, actualización o eliminación a Citrix.
/enable_framehawk_port
Abre los puertos UDP utilizados por Framehawk. Predeterminado = false
/enable_hdx_3d_pro
Instala el VDA en modo HDX™ 3D Pro.
/enable_hdx_ports
Abre los puertos en el firewall de Windows requeridos por el VDA y las funciones habilitadas (excepto Asistencia remota de Windows), si se detecta el Servicio de firewall de Windows, incluso si el firewall no está habilitado. Si utiliza un firewall diferente o ningún firewall, debe configurar el firewall manualmente. Para obtener información sobre los puertos, consulte Puertos de red.
Para abrir los puertos UDP que utiliza el transporte adaptativo de HDX, especifique la opción /enable_hdx_udp_ports y la opción /enable_hdx_ports.
/enable_hdx_udp_ports
Abre los puertos UDP en el firewall de Windows que son requeridos por el transporte adaptativo de HDX, si se detecta el Servicio de firewall de Windows, incluso si el firewall no está habilitado. Si utiliza un firewall diferente o ningún firewall, debe configurar el firewall manualmente. Para obtener información sobre los puertos, consulte Puertos de red.
Para abrir otros puertos que utiliza el VDA, especifique la opción /enable_hdx_ports y la opción /enable_hdx_udp_ports.
/enable_real_time_transport
Habilita o deshabilita el uso de UDP para paquetes de audio (transporte de audio en tiempo real para audio). Habilitar esta función puede mejorar el rendimiento del audio. Incluya la opción /enable_hdx_ports si desea que los puertos UDP se abran automáticamente cuando se detecte el Servicio de firewall de Windows.
/enable_remote_assistance
Habilita la función de shadowing en Asistencia remota de Windows para usar con Director. Si especifica esta opción, Asistencia remota de Windows abre los puertos dinámicos en el firewall.
/excluir “<componente>”[,”<component>”]
Impide la instalación de uno o más componentes opcionales separados por comas, entre comillas rectas. Por ejemplo, la instalación o actualización de un VDA en una imagen que no está administrada por MCS no requiere los componentes Personal vDisk o 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 (mediante la opción /exclude "Citrix User Profile Manager") afecta a la supervisión y la solución de problemas de los VDA con Citrix Director. En las páginas de Detalles de usuario y Punto final, el panel de Personalización y el panel de Duración de inicio de sesión fallan. En las páginas de Panel y Tendencias, el panel de Duración media de inicio de sesión solo muestra datos para las máquinas que tienen Profile Management instalado.
Aunque utilice una solución de administración de perfiles de usuario de terceros, 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. Ese instalador excluye automáticamente muchos de estos elementos.
/h o /help
Muestra la ayuda del comando.
/hdxflashv2only
Impide la instalación de los binarios heredados de redirección de Flash, para mejorar la seguridad.
Esta opción no está disponible en la interfaz gráfica.
/installdir <directorio>
Directorio vacío existente donde se instalarán los componentes. Predeterminado = c:\Program Files\Citrix.
/logpath <ruta>
Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no la crea. Predeterminado = "%TEMP%\Citrix\XenDesktop Installer"
Esta opción no está disponible en la interfaz gráfica.
/Imagen maestra
Válido solo al instalar un VDA en una VM. Configura el VDA como una imagen maestra.
Esta opción no es válida cuando se utiliza el instalador VDAWorkstationCoreSetup.exe.
/no_mediafoundation_ack
Reconoce que Microsoft Media Foundation no está instalado y que varias funciones multimedia de HDX no se instalarán ni funcionarán. Si se omite esta opción y Media Foundation no está instalado, la instalación del VDA falla. La mayoría de las ediciones de Windows compatibles vienen con Media Foundation ya instalado, excepto las ediciones N.
/Sin Citrix WDDM
Válido solo en máquinas con Windows 7 que no incluyen un controlador WDDM. Deshabilita la instalación del controlador WDDM de Citrix.
Esta opción no está disponible en la interfaz gráfica.
/sinexperienciadeescritorio
Válido solo al instalar un VDA para SO de servidor. Impide la habilitación de la función Experiencia de escritorio mejorada. Esta función también se controla con la configuración de directiva de Citrix Experiencia de escritorio mejorada.
No reiniciar
Impide un reinicio después de la instalación. El VDA no se puede utilizar hasta después de un reinicio.
No reanudar
De forma predeterminada, cuando se necesita reiniciar una máquina durante una instalación, el instalador se reanuda automáticamente una vez completado el reinicio. Para anular el valor predeterminado, especifique /noresume. Esto puede ser útil si debe volver a montar el medio o desea capturar información durante una instalación automatizada.
Optimizar
Válido solo al instalar un VDA en una VM. Habilita la optimización para los VDA que se ejecutan en una VM en un hipervisor. La optimización de VM incluye la deshabilitación de archivos sin conexión, la deshabilitación de la desfragmentación en segundo plano y la reducción del tamaño del registro de eventos. No especifique esta opción para implementaciones de Remote PC Access. Para obtener más información, consulte CTX224676.
/portnumber <puerto>
Válido solo cuando se especifica la opción /reconfig. Número de puerto que se habilitará para las comunicaciones entre el VDA y el Controller. El puerto configurado anteriormente se deshabilita, a menos que sea el puerto 80.
Silencioso o pasivo
No aparece ninguna interfaz de usuario durante la instalación. La única evidencia del proceso de instalación y configuración se encuentra en el Administrador de tareas de Windows. Si se omite esta opción, se inicia la interfaz gráfica.
Reconfigurar
Personaliza la configuración del VDA configurada previamente cuando se utiliza con las opciones /portnumber, /controllers o /enable_hdx_ports. Si especifica esta opción sin especificar también la opción /quiet, se inicia la interfaz gráfica para personalizar el VDA.
PC remoto
Válido solo para implementaciones de Remote PC Access. Excluye la instalación de los siguientes componentes en un SO de escritorio:
- Personalización de Citrix para App-V
- Administrador de perfiles de usuario de Citrix
- Complemento WMI del Administrador de perfiles de usuario de Citrix
- Servicio de identidad de máquina
- vDisk personal
Esta opción no es válida cuando se utiliza el instalador VDAWorkstationCoreSetup.exe. Ese instalador excluye automáticamente la instalación de estos componentes.
/eliminar
Quita los componentes especificados con la opción /components.
/eliminartodo
Quita todos los componentes VDA instalados.
/enviarmetricasdeexperiencia
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.
/servidorvdi
Instala un VDA para SO de escritorio en un servidor Windows compatible. Omita esta opción al instalar un VDA para SO de servidor en un servidor Windows. Antes de usar esta opción, consulte Server VDI.
Utilice esta opción solo con el instalador VDA del producto 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 del sitio. Esto asocia un escritorio virtual con un sitio cuando se utiliza Active Directory para el descubrimiento (la actualización automática es el método de descubrimiento recomendado y predeterminado). El GUID del sitio es una propiedad del sitio que se muestra en Studio. No especifique las opciones /site_guid y /controllers a la vez.
/tempdir <directorio>
Directorio para almacenar archivos temporales durante la instalación. Predeterminado = c:\Windows\Temp.
Esta opción no está disponible en la interfaz gráfica.
/máquinavirtual
Válido solo al instalar un VDA en una máquina virtual. Anula la detección por parte del instalador de una máquina física, donde la información del BIOS pasada a las máquinas virtuales las hace aparecer como máquinas físicas.
Esta opción no está disponible en la interfaz gráfica.
Ejemplos: Instalar un VDA
Instalar un VDA con el instalador del producto completo
El siguiente comando instala un VDA para SO de escritorio y Citrix Receiver™ en la ubicación predeterminada de una máquina virtual. Este VDA se utilizará como imagen maestra. El VDA se registrará inicialmente con el Controller en el servidor llamado ‘Contr-Main’ en el dominio ‘mydomain’. El VDA utilizará Personal vDisks, la función de optimización y 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 de servicios básicos en un SO de escritorio para su uso en una implementación de Acceso con PC remoto o VDI. Citrix Receiver y otros servicios no básicos no se instalan. Se especifica la dirección de un Controller y los puertos del servicio Firewall de Windows se abrirán automáticamente. El administrador se encargará de los reinicios.
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
Personalizar un VDA mediante la línea de comandos
Después de instalar un VDA, puede personalizar varias configuraciones. Desde el directorio \x64\XenDesktop Setup del medio del producto, ejecute el comando XenDesktopVdaSetup.exe, utilizando una o varias de las siguientes opciones, que se describen en Opciones de línea de comandos para instalar un VDA.
-
/reconfigure(obligatorio al personalizar un VDA) -
/ho/help /quiet/noreboot/controllers- Puerto
/portnumber /enable_hdx_ports
Instalar Universal Print Server mediante la línea de comandos
Ejecute uno 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\del medio de instalación de Citrix, ejecuteUpsServer_x86.msi. - En un sistema operativo de 64 bits compatible: Desde el directorio
\x64\Universal Print Server\del medio 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 completo del producto
- Usar un instalador de VDA independiente
- 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 VDA
- Personalizar un VDA mediante la línea de comandos
- Instalar Universal Print Server mediante la línea de comandos