Product Documentation

Instalación mediante línea de comandos

Nov 18, 2015
Use la interfaz de línea de comandos para:
  • Instalar uno o más componentes principales: Delivery Controller, Citrix Studio, Citrix Director, el servidor de licencias y StoreFront.
  • Instalar un agente Virtual Delivery Agent (VDA) en una imagen maestra o en una máquina física o virtual.

    También puede personalizar los scripts de los medios de instalación y usarlos para instalar y quitar agentes VDA en Active Directory; consulte Instalación o eliminación de Virtual Desktop Agent mediante scripts en Active Directory.

  • Personalizar un VDA previamente instalado.
  • Instalar un servidor de impresión universal (Universal Print Server) para aprovisionar impresoras de red de sesión. (Controller ya contiene la funcionalidad de Universal Print Server; solo necesita instalar Universal Print Server en los servidores de impresión en su entorno).

También puede quitar componentes de esta versión instalados previamente, usando las opciones /remove o /removeall. Para obtener más información, consulte Eliminación de componentes.

Para ver el progreso y los valores de retorno de la ejecución de comandos, 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.

Importante: Antes de comenzar una instalación, consulte y complete las tareas de Antes de la instalación.

Para instalar los componentes principales usando la línea de comandos

Desde el directorio \x64\XenDesktop Setup de los medios de instalación, ejecute XenDesktopServerSetup.exe. La siguiente tabla describe las opciones del comando.
Opción Descripción

/help o /h

Muestra la ayuda del comando.

/quiet

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.

/logpath ruta

Ubicación del archivo de registro. La carpeta especificada debe existir ya; el programa de instalación no puede crearla. Predeterminado = "%TEMP%\Citrix\XenDesktop Installer"

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

/remove

Quita los componentes principales especificados con la opción /components. Para obtener más información sobre cómo quitar componentes, consulte Eliminación de componentes.

/removeall

Quita todos los componentes principales instalados. Para obtener más información sobre cómo quitar componentes, consulte Eliminación de componentes.

/configure_firewall

Abre todos los puertos del Firewall de Windows que necesitan los componentes que se están instalando, si el servicio Firewall de Windows se está ejecutando, 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.

/components componente [,componente] ...

(Requerido.) Lista de los componentes, separados por comas, para instalar o quitar. Los valores válidos son:
  • CONTROLLER - Controller
  • DESKTOPSTUDIO - Studio
  • DESKTOPDIRECTOR - Director
  • LICENSESERVER - Citrix Licensing
  • STOREFRONT - StoreFront

Si se omite esta opción, se instalarán todos los componentes (o se quitarán, si se especifica la opción /remove).

/installdir directorio

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

/tempdir directorio

Directorio que contiene los archivos temporales durante la instalación. Valor predeterminado = C:\Wndows\Temp.

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

/enableremoteassistance

(Válido solamente cuando se instala Director). Habilita la función de Asistencia remota de Windows. La característica Asistencia remota de Windows siempre se instala cuando se instala Director; se puede habilitar o inhabilitar incluyendo u omitiendo esta opción en la línea de comandos.

Por ejemplo, el siguiente comando instala Controller, Studio, Citrix Licensing y SQL Server Express en el servidor. Los puertos del Firewall de Windows que son necesarios para las comunicaciones del Controller y del servidor de licencias se abrirán automáticamente.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

Para instalar VDA usando la línea de comandos

Nota: Para obtener información sobre cómo instalar una versión anterior de Virtual Desktop Agent en sistemas Windows XP o Windows Vista, consulte Instalación de un Virtual Desktop Agent más antiguo en Windows XP o Windows Vista.

Al instalar un VDA para acceso con Remote PC, especifique solo las opciones que son válidas en máquinas físicas (no en máquinas virtuales o imágenes maestras) y en los VDA para SO de escritorio Windows.

Desde el directorio \x64\XenDesktop Setup de los medios de instalación, ejecute XenDesktopVdaSetup.exe. La siguiente tabla describe las opciones del comando. A menos que se indique lo contrario, las opciones son aplicables a máquinas virtuales y equipos físicos, y a VDA para SO de escritorio Windows y VDA para SO de servidor Windows.
Opción Descripción

/h o /help

Muestra la ayuda del comando.

/quiet

No aparece ninguna interfaz de usuario durante la instalación. La única evidencia 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.

/logpath ruta

Ubicación del archivo de registro. La carpeta especificada debe existir ya; el programa de instalación no puede crearla. Predeterminado = "%TEMP%\Citrix\XenDesktop Installer"

/noreboot

Impide que se reinicie el sistema después de la instalación. VDA no estará disponible totalmente hasta después de reiniciar el sistema.

/remove

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

/removeall

Quita todos los componentes de VDA instalados.

/reconfig

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.

/portnumber puerto

(Esta opción es válida solamente si se especifica la opción /reconfig.) Número de puerto a habilitar para las comunicaciones entre VDA y Controller. El puerto previamente configurado queda inhabilitado a menos que sea el puerto 80.

/components componente[,componente]

Lista de los componentes, separados por comas, para instalar o quitar. Los valores válidos son:
  • VDA - instala el agente VDA
  • PLUGINS - instala Citrix Receiver para Windows (CitrixReceiver.exe)

Si se omite esta opción, se instalan todos los componentes.

/installdir directorio

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

/tempdir directorio

Directorio que contiene los archivos temporales durante la instalación. (Esta opción no está disponible en la interfaz gráfica.) Valor predeterminado = C:\Windows\Temp.

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

/controllers "Controller [Controller] [...]"

Lista de nombres de dominio completos (FQDN) de Controllers, separados por espacios, entre comillas, con los que se puede comunicar VDA. No especifique las opciones /site_guid y /controllers a la vez.

/xa_server_location URL

Dirección URL del servidor para aplicaciones de servidor Windows.

/enable_remote_assistance

Habilita la Asistencia remota de Windows para utilizarla con Director. Si especifica esta opción, Windows abre el puerto TCP 3389 en el firewall, incluso aunque se omita la opción /enable_hdx_ports.

/enable_hdx_ports

Abre los puertos de Firewall de Windows requeridos por Controller y por las características especificadas (Asistencia remota de Windows, Transporte de sonido Real-Time y optimización), 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.

/optimize

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 el acceso con Remote PC. Para obtener más información sobre la herramienta de optimización, consulte CTX125874.

/baseimage

(Esta opción es válida solamente cuando se instala un VDA para SO de escritorio Windows en una VM.) Permite el uso de discos Personal vDisk con una imagen maestra. Para obtener más información, consulte Administración de discos Personal vDisk.

/enable_hdx_3d_pro

Instala VDA para HDX 3D Pro. Para obtener más información, consulte la documentación de HDX 3D Pro.

/enable_real_time_transport

Habilita o inhabilita el uso de UDP para los paquetes de sonido (Transferencia de sonido en tiempo real para sonido). La habilitación de esta función puede mejorar el rendimiento del sonido. Recomendado para acceso con Remote PC. (incluya la opción /enable_hdx_ports si desea que los puertos UDP se abran automáticamente si se detecta el servicio de Firewall de Windows).

/masterimage

(Esta opción es válida solamente cuando se instala un VDA en una VM.) Establece el VDA como imagen maestra.

/isvirtual

(Esta opción es válida 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.

/nodesktopexperience

(Esta opción es válida solamente cuando se instala un VDA para SO de servidor Windows.) Impide la habilitación de la función Enhanced Desktop Experience. Esta característica también está controlada por la configuración de directiva de Citrix Enhanced Desktop Experience.

/nocitrixwddm

(Esta opción es válida solamente en máquinas con Windows 7 que no incluyan un controlador WDDM.) Inhabilita la instalación del controlador WDDM de Citrix.

/servervdi

Instala un VDA para SO de escritorio Windows en un servidor Windows respaldado. Omita esta opción cuando instale un VDA para SO de servidor Windows en un servidor Windows. Antes de usar esta opción, consulte VDI de servidor.

/installwithsecurebootenabled

Permite la instalación de VDA cuando está habilitado el arranque seguro. Si se omite esta opción, se muestra una advertencia acerca de que el arranque seguro debe estar inhabilitado para instalar correctamente un VDA.

El siguiente comando instala un VDA para SO de escritorio Windows y Citrix Receiver en la ubicación predeterminada en una VM. Este VDA se usará como una imagen maestra. El VDA se registrará inicialmente con el Controller en el servidor denominado "Contr-Main" en el dominio "mydomain", y se usarán 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
El siguiente comando instala un VDA para SO de escritorio Windows y Citrix Receiver en la ubicación predeterminada en un PC de oficina que se usará para el acceso con Remote PC. La máquina no se reiniciará después de instalar VDA; no obstante, antes de usar VDA es necesario reiniciar el sistema. El VDA se registrará inicialmente con el Controller en el servidor denominado "Contr-East" en el dominio "mydomain" y utilizará el protocolo UDP para los paquetes de sonido. Los puertos HDX se abrirán si se detecta el servicio de Firewall de Windows.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-East.mydomain.local" /enable_hdx_ports /enable_real_time_transport /noreboot 

Para personalizar un VDA usando la 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, usando una o varias de estas opciones, que se describen más arriba.
  • /reconfigure - esta opción es necesaria para personalizar un VDA
  • /h o /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber puerto
  • /enable_hdx_ports

Para instalar Universal Print Server usando la 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, ejecute UpsServer_x86.msi.
  • En sistemas operativos de 64 bits compatibles: desde el directorio \x64\Universal Print Server\ de los medios de instalación de Citrix, ejecute UpsServer_x64.msi.