Instalar mediante la línea de comandos
Importante:
Si vas a actualizar y tu versión actual usa o tiene el software Personal vDisk o AppDisks instalado, consulta Eliminar PvD, AppDisks y hosts no compatibles.
Citrix recopila datos básicos de licencias según sea necesario para sus intereses legítimos, incluido el cumplimiento de las licencias. Para obtener más información, consulta Datos de licencias de Citrix.
Introducción
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, consulta Agentes de entrega virtual de Linux.
Este artículo describe cómo emitir comandos de instalación de productos. Antes de iniciar cualquier instalación, revisa Preparar la instalación. Ese artículo incluye descripciones de los instaladores disponibles.
Para ver el progreso de la ejecución de comandos y los valores de retorno, debes ser el administrador original o usar Ejecutar como administrador. Para obtener más información, consulta 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 VDA en máquinas de Active Directory. Para obtener más detalles, consulta Instalar VDA mediante scripts.
Si intentas instalar o actualizar en una versión de sistema operativo Windows que no es compatible con esta versión de Citrix Virtual Apps and Desktops, un mensaje te guiará a la información sobre tus opciones. Consulta Sistemas operativos anteriores.
Para obtener información sobre cómo Citrix informa los resultados de las instalaciones de componentes, consulta Códigos de retorno de la instalación de Citrix.
Usar el instalador completo del producto
Para acceder a la interfaz de línea de comandos del instalador completo del producto:
- Descarga el paquete del producto de Citrix. Se requieren credenciales de cuenta de Citrix para acceder al sitio de descarga.
- Descomprime el archivo. Opcionalmente, graba un DVD del archivo ISO.
- Inicia sesión en el servidor donde vas a instalar los componentes, usando una cuenta de administrador local.
- Inserta el DVD en la unidad o monta el archivo ISO.
-
Desde el directorio
\x64\XenDesktop Setupdel medio, ejecuta el comando apropiado.Para instalar componentes principales: Ejecuta
XenDesktopServerSetup.exe, con las opciones que se enumeran en Opciones de línea de comandos para instalar componentes principales.Para instalar un VDA: Ejecuta
XenDesktopVDASetup.execon las opciones que se enumeran en Opciones de línea de comandos para instalar un VDA.url-or-ipPara instalar StoreFront: EjecutaCitrixStoreFront-x64.exeen la carpetax64 > StoreFrontdel medio de instalación.- Para instalar Universal Print Server: Sigue las instrucciones de Opciones de línea de comandos para instalar Universal Print Server.
Para instalar Federated Authentication Service: Citrix recomienda usar la interfaz gráfica.
Para instalar Session Recording: Sigue las instrucciones de Session Recording.
-
Para instalar Workspace Environment Management: Sigue las instrucciones de Workspace Environment Management.
-
Para instalar Secure Private Access: Ejecuta
XenDesktopSPASetup.exeen la carpetax64 > XenDesktopSetup del medio de instalación. Sigue las instrucciones de Opciones de línea de comandos para instalar Secure Private Access.
-
Para instalar Secure Private Access: Ejecuta
Opciones de línea de comandos para instalar componentes principales
- Las siguientes opciones de parámetros son válidas al instalar componentes principales con el comando `XenDesktopServerSetup.exe`. Para obtener más detalles sobre las opciones, consulta [Instalar componentes principales](/es-es/citrix-virtual-apps-desktops/install-configure/install-core-components).
Nota:
- No uses `/exclude` al usar las opciones de línea de comandos para instalar componentes principales. - Si actualizas un componente usando `/components`, entonces otros componentes también podrían actualizarse. Esto es para evitar posibles problemas de compatibilidad entre diferentes componentes.
- Si quieres actualizar solo un componente, usa el instalador individual de ese componente. Consulta Actualizar una implementación.
- **/ceipoptin** *ceipoptin* [,*ceipoptin*] ...
- Habilita la recopilación de datos de Call Home y datos del Programa de mejora de la experiencia del cliente (CEIP). Los valores válidos son:
- `DIAGNOSTIC`: Elige este valor para permitir que Citrix Licensing recopile datos de Call Home.
- `ANONYMOUS`: Elige este valor para permitir que Citrix Licensing recopile datos CEIP no identificados (que no identifican a los usuarios).
- `NONE`: Elige este valor para deshabilitar la recopilación de datos CEIP por parte de Citrix Licensing.
- Para obtener más información sobre la recopilación de datos de Call Home, consulta [Citrix Licensing Call Home](/es-es/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-call-home).
Para obtener más detalles sobre la recopilación de datos CEIP, consulta [Programa de mejora de la experiencia del cliente de Citrix Licensing](/es-es/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-customer-experience-improvement-program).
Para obtener más detalles sobre los datos CEIP, consulta [Elementos de datos CEIP de Citrix Licensing](/es-es/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-ceip-data-elements).
Para obtener más detalles sobre los datos de licencias de License Server, consulta [Datos de licencias de Citrix](/es-es/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-compliance).
-
/components component [,component] …
Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:
-
CONTROLLER: Controlador -
DESKTOPSTUDIO: Studio -
WEBSTUDIO: Web Studio -
DESKTOPDIRECTOR: Director -
LICENSESERVER: Citrix License Server -
SECUREPRIVATEACCESS: Secure Private Access
-
Para instalar solo el VDA y excluir la instalación de otros componentes de Citrix, especifica /components vda.
Esta opción no es válida cuando se usa el instalador VDAWorkstationCoreSetup_xxxx.exe. Ese instalador no puede instalar la aplicación Citrix Workspace ni otros componentes de Citrix.
Si se omite esta opción, se instalan todos los componentes (o se quitan, si también se especifica la opción /remove).
(En versiones anteriores a 2003, los valores válidos incluían STOREFRONT™. Para la versión 2003 y posteriores, usa el comando de instalación de StoreFront dedicado mencionado en Usar el instalador completo del producto).
-
/onlyprereqs
Solo se instalarán los requisitos previos para los componentes seleccionados. No se instalarán componentes de productos Citrix.
-
/configure_firewall
Abre todos los puertos del firewall de Windows usados 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 usas un firewall de terceros o ningún firewall, debes abrir los puertos manualmente.
-
/disableexperiencemetrics
Evita la carga automática de los análisis recopilados durante la instalación, actualización o eliminación a Citrix.
-
/help o /h
Muestra la ayuda del comando.
-
/ignore_hw_check_failure
Permite que la instalación o actualización de Delivery Controller continúe, incluso si las comprobaciones de hardware fallan (por ejemplo, debido a RAM insuficiente). Para obtener más información, consulta Comprobación de hardware.
-
/ignore_site_test_failure
Válido solo durante la actualización del Controller. Normalmente, se ignoran los errores de las pruebas del sitio y la actualización continúa. Si se omite (o se establece en falso), cualquier error en la prueba del sitio hace que el instalador falle, sin realizar la actualización. Predeterminado = falso
Durante una actualización, esta opción se ignora si se detecta una versión de SQL Server no compatible. Para obtener más detalles, consulta Comprobación de la versión de SQL Server.
-
/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 la crea. Predeterminado =
TEMP%\Citrix\XenDesktop Installer
- Ubicación del archivo de registro. La carpeta especificada debe existir. El instalador no la crea. Predeterminado =
-
/no_remote_assistance
-
Válido solo al instalar Director. Deshabilita la función de seguimiento de usuario que usa la Asistencia remota de Windows.
-
/noreboot
-
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).
-
/noresume
-
De forma predeterminada, cuando se necesita un reinicio de la máquina durante una instalación, el instalador se reanuda automáticamente después de que se completa el reinicio. Para anular el valor predeterminado, especifica
/noresume. Esto puede ser útil si necesitas volver a montar el medio o quieres capturar información durante una instalación automatizada. -
/nosql
Evita la instalación de Microsoft SQL Server Express en el servidor donde estás 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 afecta a la instalación de SQL Server Express LocalDB usado 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.
-
-
/remove
- Quita los componentes principales especificados con la opción
/components.
- Quita los componentes principales especificados con la opción
-
/removeall
- Quita todos los componentes principales instalados.
-
/sendexperiencemetrics
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 directory
Directorio que contiene archivos temporales durante la instalación. Predeterminado = c:\Windows\Temp.
-
/xenapp
Instala Citrix Virtual Apps. Si se omite esta opción, se instala Citrix Virtual Apps and Desktops™.
-
Ejemplos de instalación de componentes principales
El siguiente comando instala un Delivery Controller™, 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 Citrix Virtual Apps™ Controller, 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
El siguiente comando instala un Delivery Controller, Secure Private Access y SQL Server Express en un 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,secureprivateaccess /configure_firewall`
- Si actualizas de Citrix Virtual Apps and Desktops versión 2407 a 2411 o posterior, o realizas una instalación nueva de la versión 2411 o posterior, actualiza el License Server a la última versión (versión 11.2.17 build 51000) como primer paso. Luego, actualiza el Delivery Controller. No hacerlo resultará en el fallo de las instalaciones y actualizaciones por línea de comandos. Ejecuta los siguientes comandos para actualizar el License Server y componentes como Delivery Controller, Web Studio y Citrix Director (asumiendo que estás dentro de la carpeta \x64 en la ISO montada).
- 1. Ejecuta lo siguiente:
```
\x64\Licensing\CitrixLicensing.exe /quiet
<!--NeedCopy--> ```
Si has copiado los binarios de Licensing a cualquiera de las unidades locales, ejecuta el siguiente comando:
```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy--> ```
-
Ejecuta lo siguiente:
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL <!--NeedCopy-->
Usa un instalador VDA independiente
Se requieren credenciales de cuenta de Citrix para acceder al sitio de descarga. Debes tener privilegios administrativos elevados antes de iniciar la instalación, o usar Ejecutar como administrador.
- Descarga el paquete apropiado de Citrix:
- Agente de entrega virtual de SO multisecuencia:
VDAServerSetup_xxxx.exe - Agente de entrega virtual de SO de sesión única:
VDAWorkstationSetup_xxxx.exe - Agente de entrega virtual de servicios principales de SO de sesión única:
VDAWorkstationCoreSetup_xxxx.exe
- Agente de entrega virtual de SO multisecuencia:
-
Extrae los archivos del paquete a un directorio existente primero y luego ejecuta el comando de instalación, o simplemente ejecuta el paquete.
Para extraer los archivos antes de instalarlos, usa
/extractcon la ruta absoluta, por ejemploC:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. El directorio debe existir. De lo contrario, la extracción fallará. Luego, en un comando separado, ejecuta el comando apropiado, usando las opciones válidas enumeradas en este artículo.-
Para
VDAServerSetup_XXXX.exe, ejecuta<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe -
Para
VDAWorkstationCoreSetup_XXXX.exe, ejecuta<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe -
Para
VDAWorkstationSetup_XXXX.exe, ejecuta<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
Para ejecutar el paquete descargado, ejecuta su nombre:
VDAServerSetup.exe,VDAWorkstationSetup.exeoVDAWorkstationCoreSetup.exe. Usa las opciones válidas enumeradas en este artículo. -
Si estás familiarizado con el instalador completo del producto:
-
Ejecuta 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 otros instaladores.
Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:
-
VDA: Agente de entrega virtual -
CSA: Cliente de Citrix Secure Access™ -
PLUGINS: Aplicación Citrix Workspace™ para Windows -
UPL: Capa de personalización de usuario de Citrix (solo para VDA de WS) -
SRAGENT: Agente de grabación de sesiones -
ASSISTANTAPP: Aplicación Citrix Assistant (solo para VDA de WS)-
CEAL: Capa de aplicaciones elástica de Citrix (solo para VDA de TS)
-
Para instalar el VDA y la aplicación Citrix Workspace para Windows, especifica /components vda,plugins o no especifiques ningún componente.
A partir de esta versión, Citrix Device Trust, Citrix uberAgent y el agente de Citrix Workspace Environment Management™ (WEM) están integrados en la instalación predeterminada del VDA. Estos componentes se instalan silenciosamente como parte de la configuración del VDA y ya no se gestionan como componentes separados.
Nota: - > Si se detecta una versión independiente existente de Citrix uberAgent® en el entorno, el instalador no la instalará, actualizará ni desinstalará.
Para instalar solo el VDA y excluir la instalación de otros componentes de Citrix, especifica /components vda.
- Esta opción no es válida al usar el instalador VDAWorkstationCoreSetup_xxxx.exe. Ese instalador no puede instalar la aplicación Citrix Workspace ni otros componentes de Citrix.
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 (instaladores): VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe y VDAWorkstationCoreSetup_xxxx.exe.
Para obtener más detalles sobre las opciones, consulta Instalar VDA.
-
/components componente[,componente]
Lista de componentes separados por comas para instalar o quitar. Los valores válidos son:
-
VDA: Agente de entrega virtual -
PLUGINS: Aplicación Citrix Workspace para Windows -
CSA: Cliente de Citrix Secure Access -
UPL: Capa de personalización de usuario de Citrix (solo para VDA de WS) -
SRAGENT: Agente de grabación de sesiones -
ASSISTANTAPP: Aplicación Citrix Assistant (solo para VDA de WS) -
CEAL: Capa de aplicaciones elástica de Citrix (solo para VDA de TS)
-
-
Para instalar el VDA y la aplicación Citrix Workspace para Windows, especifica
/components vda, plugins, CSA, UPLo no especifiques ningún componente. Si no se especifica ningún componente, solo se instalarán el VDA, SRAGENT y ASSISTANTAPP de forma predeterminada. -
Para instalar solo el VDA y excluir la instalación de la aplicación Citrix Workspace y otros componentes, especifique
/components vda. -
Esta opción no es válida cuando se usa el instalador
VDAWorkstationCoreSetup_xxxx.exe. Ese instalador no puede instalar la aplicación Citrix Workspace. -
/onlyprereqs
- Solo se instalarán los requisitos previos para los componentes seleccionados. No se instalará ningún componente de producto de Citrix.
-
/controllers “controlador [controlador]”
-
FQDN de los Controladores separados por espacios con los que el VDA puede comunicarse, entre comillas rectas. No especifique las opciones
/site_guidy/controllersa la vez. -
/disableexperiencemetrics
Evita la carga automática de los análisis recopilados durante la instalación, la actualización o la eliminación a Citrix.
-
/enable_hdx_ports
-
Abre los puertos del firewall de Windows que requiere el VDA y las funciones habilitadas (excepto la Asistencia remota de Windows), si se detecta el Servicio de Firewall de Windows, incluso si el firewall no está habilitado. Si usa un firewall diferente o no usa ninguno, debe configurar el firewall manualmente. Para obtener información sobre los puertos, consulte Puertos de red.
-
Para abrir los puertos UDP que usa el transporte adaptativo HDX, especifique la opción
/enable_hdx_udp_ports, además de esta opción/enable_hdx_ports. -
/enable_hdx_udp_ports
-
Abre los puertos UDP del firewall de Windows que usa el transporte adaptativo HDX, si se detecta el Servicio de Firewall de Windows, incluso si el firewall no está habilitado. Si usa un firewall diferente o no usa ninguno, debe configurar el firewall manualmente. Para obtener información sobre los puertos, consulte Puertos de red.
-
Para abrir puertos adicionales que usa el VDA, especifique la opción
/enable_hdx_ports, además de esta opción/enable_hdx_udp_ports. -
/enable_hdx_tls_dtls
Abre los puertos TCP y UDP 443 para HDX™ Direct V1.
-
-
/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_portssi quiere 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 la Asistencia remota de Windows para usarla con Director. Si especifica esta opción, la Asistencia remota de Windows abre los puertos dinámicos en el firewall.
-
/enablerestore o /enablerestorecleanup
(Válido solo para VDA de sesión única) Permite volver automáticamente al punto de restauración si la instalación o actualización del VDA falla.
Si la instalación o actualización se completa correctamente:
-
/enablerestorecleanupindica al instalador que quite el punto de restauración. -
/enablerestoreindica al instalador que conserve el punto de restauración, aunque no se haya usado.
Para obtener más información, consulte Restaurar en caso de error de instalación o actualización.
-
-
/ENABLE_SECURE_DEFAULTS
-
Cambia la configuración predeterminada de varias funciones de habilitada a deshabilitada para una configuración predeterminada más segura. Las funciones relevantes son: redirección de unidades de cliente, redirección de carpetas especiales, arrastrar y soltar, redirección de dispositivos TWAIN de cliente, redirección de dispositivos USB Plug and Play de cliente, redirección de impresoras de cliente, redirección del portapapeles de cliente y redirección de micrófonos de cliente.
-
/enable_ss_ports
-
Abre los puertos del Firewall de Windows que se requieren para compartir pantalla, si se detecta el Servicio de Firewall de Windows, incluso si el firewall no está habilitado. Si usa un firewall diferente o no usa ninguno, debe configurar el firewall manualmente.
-
/SKIPHDXDRIVERCHECK
Omite la comprobación de los controladores HDX™ en el metainstalador del VDA.
-
/exclude “componente”[,”componente”]
Evita la instalación de uno o varios componentes opcionales separados por comas, cada uno 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 el componente Machine Identity Service. Los valores válidos son los siguientes:
SO multisesión SO de sesión única Servicios principales de SO de sesión única Citrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Backup and RestoreCitrix Backup and RestoreCitrix Browser Content Redirection -
Citrix deviceTRUST®Citrix deviceTRUSTCitrix deviceTRUSTuberAgent®uberAgentuberAgent -
Citrix Secure Access ClientCitrix Secure Access ClientCitrix Secure Access ClientCitrix Workspace Environment Management™ AgentCitrix Workspace Environment Management AgentCitrix Workspace Environment Management Agent -
Citrix Browser Content RedirectionCitrix Browser Content RedirectionCitrix Personalization for App-V - VDACitrix MCS IODriverCitrix MCS IODriverCitrix Telemetry Service -
Citrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Universal™ Print ClientCitrix Profile ManagementCitrix Profile ManagementCitrix Vda Log Capture Service -
Citrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCSE ComponentCitrix Rendezvous V2Citrix Rendezvous V2Director VDA Plug-in -
Citrix Telemetry ServiceCitrix Telemetry ServiceMachine Management ProviderCitrix Universal Print ClientCitrix Universal Print ClientVDA Monitor Plug-inCitrix Vda Log Capture ServiceCitrix Vda Log Capture ServiceVDA WMI Proxy Plug-inCitrix VDA Upgrade AgentCitrix VDA Upgrade AgentCSE ComponentCSE ComponentDirector VDA Plug-inDirector VDA Plug-inMachine Identity ServiceMachine Identity ServiceMachine Management ProviderMachine Management ProviderVDA Monitor Plug-inUser Personalization LayerVDA WMI Proxy Plug-inVDA Monitor Plug-inVDA WMI Proxy Plug-inCitrix App Protection ComponentCitrix App Protection ComponentCitrix App Protection ComponentCitrix HyperV Filter DriverCitrix HyperV Filter DriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Personalization for App-V - VDASession Recording AgentSession Recording AgentElastic App LayeringCitrix Assistant AppExcluir Citrix Profile Management de la instalación (
/exclude "Citrix Profile Management") afecta a la supervisión y la solución de problemas de los VDA con Citrix Director. En las páginas Detalles del usuario y Punto final, el panel Personalización y el panel Duración del inicio de sesión fallan. En las páginas Panel y Tendencias, el panel Duración media del inicio de sesión solo muestra datos de las máquinas que tienen Profile Management instalado.Aunque use una solución de administración de perfiles de usuario de terceros, Citrix recomienda que instale y ejecute el servicio Citrix Profile Management. No es necesario habilitar el servicio Citrix Profile Management.
Si especifica
/excludey/includeadditionalcon el mismo nombre de componente, ese componente no se instalará.Esta opción no es válida cuando se usa el instalador
VDAWorkstationCoreSetup.exe. Ese instalador excluye automáticamente muchos de estos elementos. -
/h o /help
Muestra la ayuda del comando.
-
/includeadditional “componente”[,”componente”]
Incluye la instalación de uno o más componentes opcionales separados por comas, cada uno entre comillas rectas. Esta opción puede ser útil cuando creas una implementación de Acceso a PC remoto y quieres instalar otros componentes que no se incluyen de forma predeterminada. Los valores válidos son los siguientes:
SO multisesión SO de sesión única Citrix Backup and RestoreCitrix Backup and RestoreCitrix MCS IODriverCitrix MCS IODriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Profile ManagementCitrix Profile ManagementCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCitrix Rendezvous V2Citrix Rendezvous V2Citrix VDA Upgrade AgentCitrix VDA Upgrade AgentCitrix Web Socket Vda Registration ToolCitrix Web Socket Vda Registration ToolMachine Identity ServiceMachine Identity ServiceUser Personalization LayerSi especificas `/exclude` y `/includeadditional` con el mismo nombre de componente, ese componente no se instalará.
-
/installdir directorio
Directorio vacío existente donde se instalarán los componentes. Predeterminado = c:\Program Files\Citrix.
-
/install_mcsio_driver
No lo uses. En su lugar, usa `/includeadditional “Citrix MCS IODriver”` o `/exclude “Citrix MCS IODriver”`
-
/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.
-
/masterimage
Válido solo al instalar un VDA en una VM. Configura el VDA como una imagen para usarla en la creación de otras máquinas. Esta opción es equivalente a `/mastermcsimage`.
Esta opción no es válida cuando usas el instalador `VDAWorkstationCoreSetup_xxxx.exe`.
-
/mastermcsimage
Especifica que esta máquina se usará como imagen con Machine Creation Services. Esta opción es equivalente a `/masterimage`.
-
/masterpvsimage
Especifica que esta máquina se usará como imagen con Citrix Provisioning™ o con una herramienta de aprovisionamiento de terceros (como Microsoft System Center Configuration Manager) para aprovisionar VM.
-
/websockettoken WebSocketToken
Crea un VDA de Web Socket. El WebSocketToken es para el token que se requiere.
-
/websockettokenfile FileContainingWebSockToken
Crea un VDA de Web Socket. El FileContainingWebSockToken es para el archivo que contiene el token que se requiere.
-
/websockettokenstdin <WebSocketToken
Crea un VDA de Web Socket. El <WebSocketToken es para el token que se requiere y que se pasa por STDIN.
-
/no_mediafoundation_ack
Reconoce que Microsoft Media Foundation no está instalado y que varias funciones multimedia 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 finaliza porque no se cumplen las condiciones previas. La mayoría de las ediciones de Windows compatibles vienen con Media Foundation ya instalado, excepto las ediciones N. Si habilitas las Características de Windows > Características multimedia manualmente, es posible que la clave del registro que busca Citrix Meta Installer no tenga un valor establecido. Comprueba la clave del registro `SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion` antes de iniciar el proceso de instalación para confirmar que el valor existe y no está vacío.
-
/nodesktopexperience
La función Experiencia de escritorio mejorada ya no está disponible. Esta opción (y la configuración de directiva) se ignora si se especifica.
Válido solo al instalar un VDA para SO multisesión. 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.
-
/noreboot
Impide un reinicio después de la instalación. El VDA no se puede usar hasta después de un reinicio.
-
/noresume
De forma predeterminada, cuando se necesita un reinicio de la máquina durante una instalación, el instalador se reanuda automáticamente una vez completado el reinicio. Para anular el valor predeterminado, especifica `/noresume`. Esto puede ser útil si debes volver a montar el medio o quieres capturar información durante una instalación automatizada.
-
/physicalmachine
Usa este argumento junto con `/remotepc` para la instalación de RemotePC. De lo contrario, el VDA podría no comportarse como se espera en ciertos escenarios de usuario.
-
/portnumber puerto
Válido solo cuando se especifica la opción
/reconfig. Número de puerto para habilitar las comunicaciones entre el VDA y el Controller. El puerto configurado previamente se deshabilita, a menos que sea el puerto 80. -
/proxyconfig “dirección o ruta del archivo PAC”
Si planeas usar el protocolo Rendezvous V2 con servicios como Gateway Service en tu entorno y tienes un proxy no transparente en tu red para conexiones salientes, especifica el proxy aquí. Solo se admiten proxies HTTP. La dirección o ruta del archivo PAC del proxy para usar con el protocolo Rendezvous. Esta línea de comandos instala automáticamente Citrix Rendezvous V2 como si se hubiera usado /includeadditional “Citrix Rendezvous V2”. Para obtener más detalles sobre las funciones, consulta Protocolo Rendezvous.
- Formato de dirección del proxy:
http://<url-or-ip>:<port> - Formato del archivo PAC:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- Formato de dirección del proxy:
-
/quiet o /passive
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.
-
/reconfigure
Personaliza la configuración del VDA configurada previamente cuando se usa con las opciones
/portnumber,/controllerso/enable_hdx_ports. Si especificas esta opción sin especificar también la opción/quiet, se inicia la interfaz gráfica para personalizar el VDA. -
/remotepc
Válido solo para implementaciones de Acceso con PC remoto (SO de sesión única) o conexiones intermediadas (SO multisecuencia). Excluye la instalación de cualquier componente adicional (consulta las listas de componentes con las opciones
/excludey/includeadditional).Esta opción no es válida cuando se usa el instalador
VDAWorkstationCoreSetup.exe. Ese instalador excluye automáticamente la instalación de estos componentes./remotepcno es compatible con la opción/servervdi. -
/remove
Quita los componentes especificados con la opción
/components. -
/remove_appdisk_ack
Autoriza al instalador del VDA a desinstalar el complemento AppDisks™ VDA si está instalado.
-
/remove_pvd_ack
Autoriza al instalador del VDA a desinstalar Personal vDisk si está instalado.
-
/removeall
Quita el VDA. No quita la aplicación Citrix Workspace (si está instalada).
-
/REMOVEALLWITHCWA
Quita CWA junto con el VDA.
-
/sendexperiencemetrics
Envía automáticamente los análisis recopilados durante la instalación, actualización o eliminación a Citrix. 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. -
/servervdi
Instala un VDA para SO de sesión única en una máquina Windows multisecuencia compatible. Omite esta opción al instalar un VDA para SO multisecuencia en una máquina Windows multisecuencia.
Antes de usar esta opción, consulta Server VDI.
Usa esta opción solo con el instalador del VDA del producto completo.
-
/site_guid guid
Identificador único global (GUID) de la unidad organizativa (OU) de Active Directory del sitio. Esto asocia un escritorio virtual con un sitio cuando usas 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 especifiques las opciones
/site_guidy/controllersa la vez. -
/tempdir directory
Directorio para almacenar archivos temporales durante la instalación. Predeterminado = c:\Windows\Temp.
Esta opción no está disponible en la interfaz gráfica.
-
/virtualmachine
Válido solo al instalar un VDA en una VM. Anula la detección por parte del instalador de una máquina física, donde la información del BIOS pasada a las VM las hace aparecer como máquinas físicas.
Esta opción no está disponible en la interfaz gráfica.
-
/xendesktopcloud
Indica que el VDA está instalado en una implementación de Citrix DaaS (Citrix Cloud™).
Ejemplos de instalación de un VDA
Instala un VDA con el instalador completo del producto:
El siguiente comando instala un VDA para SO de sesión única y la aplicación Citrix Workspace en la ubicación predeterminada de una VM. Este VDA se utilizará como imagen y utilizará MCS para aprovisionar VM. El VDA se registrará inicialmente con el Controller en el servidor denominado Contr-Main en el dominio mydomain. El VDA utilizará la capa de personalización de usuario y la Asistencia remota de Windows.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance
Instala un VDA de SO de sesión única con el instalador independiente VDAWorkstationCoreSetup:
El siguiente comando instala un VDA de servicios principales en un SO de sesión única para usarlo en una implementación de Acceso con PC remoto o VDI. No se instalan la aplicación Citrix Workspace ni otros servicios no principales. Se especifica la dirección de un Controller y los puertos del servicio 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
Personaliza un VDA
Después de instalar un VDA, puedes personalizar varias configuraciones. Desde el directorio \x64\XenDesktop Setup en el medio del producto, ejecuta 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/portnumber port/enable_hdx_ports
Soluciona problemas de VDA
-
En la vista de Studio de un grupo de entrega, la entrada Versión de VDA instalada en el panel Detalles podría no ser la versión instalada en las máquinas. La vista de Programas y características de Windows de la máquina muestra la versión real del VDA.
-
Después de instalar un VDA, no puede entregar aplicaciones ni un escritorio a los usuarios hasta que se registre con un Delivery Controller.
Para obtener información sobre los métodos de registro de VDA y cómo solucionar problemas de registro, consulta Registro de VDA.
Opciones de línea de comandos para instalar un Universal Print Server
La siguiente opción es válida con el comando XenDesktopPrintServerSetup.exe.
- /enable_upsserver_port
Cuando no se especifica esta opción, el instalador muestra la página Firewall de la interfaz gráfica. Selecciona Automáticamente para que el instalador agregue automáticamente las reglas del firewall de Windows, o Manualmente para que el administrador configure el firewall de forma manual.
Después de instalar el software en tus servidores de impresión, configura el Universal Print Server siguiendo las indicaciones de Citrix Universal Print Server (UPS).
Opciones de línea de comandos para instalar Secure Private Access
Las siguientes opciones son válidas con ambos:
- Instalador de CVAD:
XenDesktopSPASetup.exe - Instalador de SPA local:
SecurePrivateAccessSetup_XXXX.exe
-
/enable_spa_ports
Abre los puertos del firewall de Windows requeridos por Secure Private Access, si se detecta el servicio Firewall de Windows, incluso si el firewall no está habilitado. Si utilizas un firewall diferente o ningún firewall, debes configurar el firewall manualmente. Para obtener información sobre los puertos, consulta Puertos de red.
-
/nosql
Evita la instalación de Microsoft SQL Server Express en el servidor donde estás instalando Secure Private Access. Si se omite esta opción, se instala SQL Server Express para usarlo como base de datos del sitio.
-
/help o /h o /?
Muestra la ayuda del comando
-
/noreboot
Evita un reinicio después de la instalación. Secure Private Access no se puede usar hasta después de un reinicio.
-
/quiet o /passive
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.
-
/remove
Quita Secure Private Access.
Para obtener más detalles sobre las opciones, consulta Instalador de Secure Private Access.
Más información
Para obtener información sobre cómo Citrix informa del resultado de las instalaciones de componentes, consulta Códigos de retorno de la instalación de Citrix.
En este artículo
- Introducción
- Usar el instalador completo del producto
- Opciones de línea de comandos para instalar componentes principales
- Ejemplos de instalación de componentes principales
- Usa un instalador VDA independiente
- Opciones de línea de comandos para instalar un VDA
- Ejemplos de instalación de un VDA
- Personaliza un VDA
- Soluciona problemas de VDA
- Opciones de línea de comandos para instalar un Universal Print Server
- Opciones de línea de comandos para instalar Secure Private Access
- Más información