Product Documentation

Instalación mediante línea de comandos

Jul 12, 2016

Introducción

Importante: Antes de iniciar cualquier instalación, consulte el artículo Antes de la instalación. En él, se describen los programas de instalación y los aspectos que debe conocer antes de iniciar una instalación. También le guiará a través de las opciones que se pueden incluir con un comando. Este artículo describe cómo iniciar la interfaz de línea de comandos en un instalador del producto.

Puede usar una 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, y usarlos para instalar y quitar agentes VDA 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.
  • Actualizar componentes; para obtener más información, consulte el artículo Actualización de una implementación.

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

Para ver el progreso de ejecución del comando y devolver valores, 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.

Tanto el programa de instalación de producto completo como el programa de instalación independiente de VDA tienen una interfaz de línea de comandos.

Si usa los scripts de ejemplo suministrados para instalar, actualizar o quitar los VDA de las máquinas en Active Directory, puede especificar las opciones de configuración de VDA que se ofrecen a continuación, en la sección Opciones de línea de comandos para instalar un VDA. Para obtener más información acerca de los scripts de ejemplo, consulte el artículo Instalación de agentes VDA mediante scripts.

Uso del programa de instalación de producto completo

Puede instalar componentes principales y agentes VDA a partir del programa de instalación 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 desea, puede grabar un DVD del archivo ISO.
  • Inicie una sesión en el servidor donde desea instalar los componentes, usando una cuenta de administrador local.
  • Introduzca el DVD en la unidad o monte el ISO archivo.
  • Desde el directorio \x64\XenDesktop Setup de los medios de instalación:

Para instalar los componentes principales, ejecute el comando XenDesktopServerSetup.exe. Utilice las opciones que aparecen en la sección Opciones de línea de comandos para instalar componentes principales.

Para instalar un VDA, ejecute el comando XenDesktopVDASetup.exe. Utilice las opciones que aparecen en la sección Opciones de línea de comandos para instalar un VDA.

Ejemplos de instalación de componentes principales con el programa de instalación de producto completo

Ejemplo 1. El siguiente comando instala el controlador de XenDesktop, Studio, Citrix Licensing y SQL Server Express en el servidor. Los puertos necesarios para la comunicación entre componentes se abrirán automáticamente.

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

Ejemplo 2. El siguiente comando instala el Controller de XenApp, Studio, y SQL Server Express en el servidor. Los puertos necesarios para la comunicación entre componentes se abrirán automáticamente.

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components  controller,desktopstudio /configure_firewall

Ejemplos de instalación de un VDA con el programa de instalación de producto completo

Ejemplo 1. 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

Ejemplo 2. 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 

Uso del programa de instalación independiente de VDA

Importante: En el artículo Antes de la instalación, se ofrece una guía acerca de la información que verá y deberá especificar en el asistente durante la instalación, especialmente en lo referente a la gestión de reinicios y al espacio de extracción cuando se use el programa de instalación 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 bien debe usar la opción Ejecutar como administrador.

  1. Descargue el paquete correspondiente de Citrix: VDAServerSetup.exe (para máquinas de SO de servidor) o VDAWorkstationSetup.exe (para máquinas de SO de escritorio). Para entornos de SO de usuario único y servidor único (por ejemplo, la entrega de Windows Server 2012 a un único usuario para tareas de desarrollo Web), use el paquete VDAWorkstationSetup.exe. Para obtener más información, consulte el artículo VDI de servidor.
  2. Extraiga primero los archivos del paquete 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 absoluta, por ejemplo: .\VDAWorkstationSetup.exe /extract %temp%\CitrixVDAInstallMedia. A continuación, en un comando aparte, ejecute el comando XenDesktopVdaSetup.exe desde el directorio que contiene el contenido extraído (en el ejemplo anterior, CitrixVDAInstallMedia). Utilice las opciones que aparecen en la sección siguiente Opciones de línea de comandos para instalar un VDA.

Para solo ejecutar el paquete descargado, ejecute su nombre: VDAServerSetup.exe o VDAWorkstationSetup.exe. Utilice las opciones que aparecen en la sección siguiente Opciones de línea de comandos para instalar un VDA. (Si está familiarizado con el programa de instalación de producto completo, ejecute el paquete independiente descargado como si fuera el comando VdaSetup.exe de XenDesktop en todo excepto el nombre.)

Ejemplo de instalación de un agente VDA con el programa de instalación independiente de VDA

El siguiente comando de instalación se suele usar para el acceso con Remote PC. Instala un VDA en un equipo físico de oficina sin instalar Citrix Receiver ni Citrix Profile Manager. La máquina no se reiniciará automáticamente después de instalar el VDA; no obstante, antes de usar el VDA es necesario reiniciar el sistema. El VDA se registrará inicialmente con el Controller de un servidor llamado 'Contr-East'. Los puertos se abrirán si se detecta el servicio de Firewall de Windows.

VDAWorkstationSetup.exe /quiet /components vda /exclude "Citrix User Profile Manager" /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

Nota

Excluir Citrix User Profile Manager de la instalación afectará a la supervisión y solución de problemas de los agentes VDA con Citrix Director. En las páginas Detalles del usuario y Punto final, el panel de Personalización y el panel Duración de inicio de sesión fallan. En las páginas Panel de mandos y Tendencias, el panel de Duración media de inicios de sesión solo mostrará datos para máquinas que tengan Profile Management instalado.

Personalización de un agente 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, que se describen en la sección anterior Opciones de línea de comandos para instalar un VDA.

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

Opciones de línea de comandos para instalar componentes principales

En la siguiente tabla, se ofrece una lista de las opciones válidas para el comando XenDesktopServerSetup.exe.

Opción

Descripción

/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 - Servidor de licencias de Citrix
  • 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).

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

/help o /h

Muestra la ayuda del comando.

/installdir directorio

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

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

/no_remote_assistance

(Válido solamente cuando se instala Director.) Inhabilita la función 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.

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

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

Opciones de línea de comandos para instalar un VDA

En la siguiente tabla, se ofrece una lista de las opciones válidas para el comando  XenDesktopVDASetup.exe .

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.

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.

Important

En XenApp y XenDesktop 7.9, use la línea de comandos solo para implementaciones de acceso con Remote PC y no cambie el orden de la sintaxis de /components y /remotepc. Por ejemplo:

VDAWorkstationSetup.exe /components vda /controllers "example.delivery.controller.net" /remotepc /EXCLUDE "AppDisks VDA Plug-in" /enable_hdx_ports /noreboot /quiet

Si se utiliza /remotepc antes de /components, se ignora la opción /remotepc. 

 

Opción

Descripción

/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 los artículos Discos Personal vDisk.

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

Por ejemplo, para instalar el VDA y no Citrix Receiver, especifique /components vda.

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

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

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

/enable_hdx_3d_pro

Instala VDA para HDX 3D Pro. Para obtener más información, consulte el artículo HDX 3D Pro.

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

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

/enable_remote_assistance

Habilita la función de remedo en 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.

/exclude "component"[,"component"]

Impide la instalación de uno o varios componentes opcionales separados por comas, escritos entre comillas. Por ejemplo, instalar o actualizar un VDA en una imagen no administrada por Machine Creation Services no requiere componentes de Personal vDisk ni Machine Identity Service. Los valores válidos son:

  • Personal vDisk
  • Machine Identity Service
  • Citrix User Profile Manager

Excluir Citrix User Profile Manager de la instalación de VDA afectará a la supervisión y solución de problemas de los agentes VDA con Citrix Director. En las páginas Detalles del usuario y Punto final, el panel de Personalización y el panel Duración de inicio de sesión fallan. En las páginas Panel de mandos y Tendencias, el panel de Duración media de inicios de sesión solo mostrará datos para máquinas que tengan Profile Management instalado.

/h o /help

Muestra la ayuda del comando.

/installdir directorio

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

/logpath ruta

Ubicación del archivo de registro. La carpeta especificada debe existir ya; el programa de instalación no puede crearla.  (Esta opción no está disponible en la interfaz gráfica.) Valor predeterminado = "%TEMP%\Citrix\XenDesktop Installer".

/masterimage

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

/no_appvImpide la instalación de los componentes de App-V desarrollados por Citrix. Para obtener más información, consulte el artículo App-V

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

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

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

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

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

/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 y configuración aparece en el Administrador de tareas de Windows. Si se omite esta opción, se abre la interfaz gráfica.

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

/remotepc

Impide la instalación de los componentes siguientes en un sistema operativo de escritorio (estación de trabajo):

  • App V Component - Citrix Personalization for App-V - VDA
  • UpmComponent - Citrix User Profile Manager
  • UpmVdaPlugin Component - Citrix User Profile Manager WMI Plugin
  • Mps Component - Machine Identity Service
  • VDisk Component - Personal vDisk

Durante la actualización, si alguno de los componentes indicados arriba está instalado, el programa de instalación lo detecta y lo actualiza.

/remove

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

/removeall

Quita todos los componentes de VDA instalados.

/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 el artículo 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 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.

/virtualmachine

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

/xa_server_location URL

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

 

Instalación de Universal Print Server mediante línea de comandos

Nota: Si desea instalar el componente UpsServer en un servidor Windows 2008 de 32 bits, siga los pasos indicados en Antes de instalar Universal Print Server en Windows 2008 de 32 bits.

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 un sistema operativo de 64 bits compatible: desde el directorio \x64\Universal Print Server\ de los medios de instalación de Citrix, ejecute UpsServer_x64.msi.

Después de instalar el componente Universal Print Server en los servidores de impresión, configúrelo siguiendo las instrucciones del artículo Aprovisionamiento de impresoras.

Antes de instalar Universal Print Server en un servidor Windows 2008 de 32 bits

Antes de implementar UpsServer_x86.msi en una máquina Windows 2008 de 32 bits, debe ajustar la versión mínima de Windows Installer a cdf_x86.msi y UpsServer_x86.msi. Para ello, puede utilizar scripts de Visual Basic o una herramienta como Orca.

  1. Copie las versiones de 32 bits de los archivos MSI de CDF y UPS (cdf_x86.msi y UpsServer_x86.msi) a una carpeta temporal.
  2. Instale el script WiSumInf.vbs o la herramienta Orca, ambos disponibles en el paquete Windows SDK Components for Windows Installer Developers. Para obtener más información acerca del script, consulte el artículo de MSDN Manage Summary Information.
  3. Modifique la versión mínima de Windows Installer mediante uno de los métodos siguientes:

Mediante el script WiSumInf.vbs. Copie WiSumInf.vbs a la misma carpeta temporal que los dos archivos MSI de Citrix. A continuación, ejecute el script para cada paquete con los parámetros WiSumInf.vbs cdf_x86.msi Pages=405 y WiSumInf.vbs UpsServer_x86.msi Pages=405.

Mediante Orca. Abra los paquetes cdf_x86.msi y UpsServer_x86.msi, vaya al menú Ver > Información de resumen, y cambie el valor del cuadro de texto Esquema a 405.

Después de completar el procedimiento anterior, instale Universal Print Server en el servidor de impresión.