Instalar y desinstalar

Puedes descargar la aplicación Citrix Workspace desde la página de descargas de Citrix o desde la página de descargas de tu empresa (si está disponible).

Puedes instalar el paquete de las siguientes maneras:

• Ejecutando un asistente de instalación interactivo basado en Windows.

  O bien

• Escribiendo el nombre del archivo del instalador, los comandos de instalación y las propiedades de instalación mediante la interfaz de línea de comandos. Para obtener información sobre cómo instalar la aplicación Citrix Workspace mediante la interfaz de línea de comandos, consulta Uso de parámetros de línea de comandos.

Nota:

Verifica que has instalado todos los requisitos del sistema necesarios, como se menciona en la sección Requisitos del sistema.

Instalación con privilegios de administrador y de no administrador:

Tanto los usuarios como los administradores pueden instalar la aplicación Citrix Workspace. Los privilegios de administrador solo son necesarios al usar la autenticación de paso, el inicio de sesión único, la Protección de aplicaciones, el plug-in VDI de Microsoft Teams y Citrix Ready workspace hub con la aplicación Citrix Workspace para Windows.

La siguiente tabla describe las diferencias cuando la aplicación Citrix Workspace se instala como administrador o como usuario:

Nota:

Los administradores pueden anular la instancia de la aplicación Citrix Workspace instalada por el usuario y continuar con la instalación correctamente.

Comando para limpiar e instalar la aplicación Citrix Workspace

Usa el comando /CleanInstall para limpiar cualquier rastro restante, como archivos y valores de registro, de una desinstalación anterior y luego instalar una nueva versión de la aplicación Citrix Workspace.

Por ejemplo:

CitrixWorkspaceApp.exe /CleanInstall
<!--NeedCopy-->

Instalación basada en la interfaz de usuario

Puedes instalar la aplicación Citrix Workspace para Windows ejecutando manualmente el paquete de instalación CitrixWorkspaceApp.exe.

1. Inicia el archivo CitrixWorkspaceApp.exe.

• El sistema verifica los requisitos previos necesarios para la aplicación Citrix Workspace y, si es necesario, los instala automáticamente.

  

  Después de instalar los requisitos previos, aparece la pantalla Bienvenido al instalador de Citrix Workspace.

• 1. Haz clic en Continuar. Aparece la página Acuerdo de licencia de Citrix.
• 1. Lee y acepta el Acuerdo de licencia de Citrix y continúa con la instalación. La instalación de la aplicación Citrix Workspace continúa y se completa correctamente.
• 1. Al instalar con privilegios de administrador, si es necesario habilitar la función Protección de aplicaciones, selecciona la casilla de verificación Iniciar Protección de aplicaciones después de la instalación. La instalación de la aplicación Citrix Workspace continúa y se completa correctamente.
• 

Importante:

El TrolleyExpress se reemplaza por CWAInstaller-<fecha y hora>. Por ejemplo, el registro se guarda en C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441.

Uso de Microsoft Store

1. Ve a Microsoft Store.
2. Busca Citrix Workspace.

1. Haz clic en Obtener. La aplicación Citrix Workspace se instala.

• Instalación basada en línea de comandos

Puedes personalizar el instalador de la aplicación Citrix Workspace especificando diferentes opciones de línea de comandos. El paquete del instalador se autoextrae en el directorio temporal del sistema antes de iniciar el programa de instalación. El requisito de espacio incluye archivos de programa, datos de usuario y directorios temporales después de iniciar varias aplicaciones.

Para instalar la aplicación Citrix Workspace mediante la línea de comandos de Windows, inicia el símbolo del sistema y escribe lo siguiente en una sola línea:

• el nombre del archivo del instalador,
• los comandos de instalación, y
• las propiedades de instalación

Los comandos y propiedades de instalación disponibles son los siguientes:

• CitrixWorkspaceApp.exe [commands] [properties]

Lista de parámetros de línea de comandos

Los parámetros se clasifican a grandes rasgos de la siguiente manera:

• Parámetros comunes
• Parámetros de actualización
• Parámetros de instalación
• Parámetros de las funciones HDX
• Parámetros de preferencias e interfaz de usuario
• Parámetros de autenticación

Parámetros comunes

• noreboot

  Suprime las solicitudes de reinicio durante la instalación. Cuando suprimes la solicitud de reinicio, los dispositivos USB que están en estado suspendido no se reconocen. Los dispositivos USB se activan solo después de reiniciar el dispositivo.

• /forceinstall

  Este modificador es eficaz al limpiar cualquier configuración o entrada existente de la aplicación Citrix Workspace en el sistema. Usa este modificador al actualizar desde una versión no compatible de la aplicación Citrix Workspace y cuando la instalación o actualización no se realiza correctamente.

Nota:

El modificador forceinstall reemplaza al modificador rcu. El modificador rcu está obsoleto a partir de la versión 1909. Para obtener más información, consulta Obsoleto.

Parámetros de actualización automática

Detectar actualización disponible

• Comando: AutoUpdateCheck
• Descripción: Este comando indica que la aplicación Citrix Workspace detecta cuándo hay una actualización disponible.

Los valores posibles son los siguientes:

• Deshabilitado

  Deshabilita las actualizaciones automáticas.

  CitrixWorkspaceApp.exe AutoUpdateCheck=disabled.

Nota:

AutoUpdateCheck es un parámetro obligatorio que debes configurar para establecer otros parámetros como AutoUpdateStream, DeferUpdateCount y AURolloutPriority.

Seleccionar la versión para actualizar

• ComandoAutoUpdateStream
• Descripción: Si has habilitado la actualización automática, puedes elegir la versión que quieres actualizar. Consulta Hitos del ciclo de vida para obtener más información.

Los valores posibles son los siguientes:

Posponer notificaciones de actualización

• Comando: DeferUpdateCount
• Descripción: Indica el número de veces que puedes posponer las notificaciones cuando hay una actualización disponible. Para obtener más información, consulta Actualizaciones de Citrix Workspace.

Los valores posibles son los siguientes:

Nota:

A partir de la versión 2207 de la aplicación Citrix Workspace para Windows, la función de actualización automática se ha mejorado y el parámetro DeferUpdateCount no es aplicable.

Establecer prioridad de implementación

• Comando: AURolloutPriority
• Descripción: Cuando hay una nueva versión de la aplicación disponible, Citrix implementa la actualización durante un período de entrega específico. Con este parámetro, puedes controlar en qué momento durante el período de entrega puedes recibir la actualización.

Los valores posibles son los siguientes:

|Valor del comando AURolloutPriority|Descripción|Ejemplo| |—|—|—|

• Automático (predeterminado)

  Recibes las actualizaciones durante el período de entrega según lo configurado por Citrix.

  CitrixWorkspaceApp.exe AURolloutPriority=Auto

• Rápido

  Recibes las actualizaciones al principio del período de entrega.

  CitrixWorkspaceApp.exe AURolloutPriority=Fast

• Medio	Recibes las actualizaciones a mitad del período de entrega.	CitrixWorkspaceApp.exe AURolloutPriority=Medium
  Lento	Recibes las actualizaciones al final del período de entrega.	CitrixWorkspaceApp.exe AURolloutPriority=Slow

Parámetros de configuración de almacén

Configurar almacén

• Comando: ALLOWADDSTORE

• Descripción: Te permite configurar los almacenes (HTTP o HTTPS) según el parámetro especificado.

• Los valores posibles son los siguientes:

|Valor del comando ALLOWADDSTORE|Descripción|Ejemplo| |—|—|———————–|

• S (predeterminado)

  Te permite agregar o quitar solo almacenes seguros (configurados con HTTPS).

  CitrixWorkspaceApp.exe ALLOWADDSTORE=S

• A

  Te permite agregar o quitar almacenes seguros (HTTPS) y no seguros (HTTP). No aplicable si la aplicación Citrix Workspace está instalada por usuario.

  CitrixWorkspaceApp.exe ALLOWADDSTORE=A

• N

  Nunca permitas a los usuarios agregar o quitar su propio almacén.

  CitrixWorkspaceApp.exe ALLOWADDSTORE=N

Guardar las credenciales del almacén localmente

• Comando: ALLOWSAVEPWD
• Descripción: Te permite guardar las credenciales del almacén localmente. Este parámetro solo se aplica a los almacenes que utilizan el protocolo de la aplicación Citrix Workspace.

Los valores posibles son los siguientes:

Ejemplos de configuración de almacenes mediante la instalación por línea de comandos

Para especificar la URL del almacén de StoreFront:

CitrixWorkspaceApp.exe /silent
STORE0="AppStore;https://testserver.net/Citrix/MyStore/discovery;on;HR App Store"

<!--NeedCopy-->

Para especificar la URL del almacén de Citrix Gateway:

CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
<!--NeedCopy-->

Donde, Nombre_almacén indica el nombre del almacén que se debe configurar.

Nota:

• En una configuración de varios almacenes, solo se permite una configuración de URL de almacén de Citrix Gateway y debe ser la primera de la lista (parámetro STORE0).
• La URL del almacén de Citrix Gateway configurada con este método no es compatible con los sitios de servicios PNA que utilizan Citrix Gateway.
• El parámetro “Discovery” no es necesario al especificar una URL de almacén de Citrix Gateway.

• Para configurar varios almacenes:

CitrixWorkspaceApp.exe  STORE0= NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store
-  STORE1="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore
<!--NeedCopy-->

Nota:

• Es obligatorio incluir discovery en la URL del almacén para que la autenticación de paso a través se realice correctamente.
• La URL del almacén de Citrix Gateway debe ser la primera entrada en la lista de URL de almacenes configuradas.

• La siguiente tabla proporciona la descripción de los parámetros de la URL del almacén:

• Ejemplo para StoreFront™:

SalesStore;https://sales.mycompany.com/Citrix/Store/discovery;On;Store para el personal de ventas.

Parámetros de instalación

Iniciar Protección de aplicaciones

• Comando: startAppProtection
• Descripción: Inicia el componente Protección de aplicaciones y proporciona seguridad mejorada al restringir la capacidad de los clientes para ser comprometidos por malware de registro de teclas y captura de pantalla.
• Ejemplo: CitrixWorkspaceApp.exe startAppProtection

Para obtener más información, consulta Protección de aplicaciones.

Nota:

El modificador startAppProtection reemplaza al modificador includeAppProtection. El modificador includeAppProtection está obsoleto. Para obtener más información, consulta Obsoleto.

Excluir binarios de Citrix Enterprise Browser

• Comando: InstallEmbeddedBrowser
• Descripción: Excluye los binarios de Citrix Enterprise Browser.

• Ejemplo: Ejecuta el modificador InstallEmbeddedBrowser=N para excluir la función de explorador incrustado.

• Puedes excluir los binarios de Citrix Enterprise Browser solo en los siguientes casos:

• Instalación nueva
• Actualización desde una versión que no incluye los binarios de Citrix Enterprise Browser.

Si tu versión de la aplicación Citrix Workspace incluye los binarios de Citrix Enterprise Browser y estás actualizando a la versión 2002, los binarios de Citrix Enterprise Browser se actualizan automáticamente durante la actualización.

Especificar directorio de instalación personalizado

• Comando: INSTALLDIR
• Descripción: Especifica el directorio de instalación personalizado para la instalación de la aplicación Citrix Workspace. La ruta predeterminada es C:\Program Files\Citrix.
• Ejemplo: CitrixWorkspaceApp.exe INSTALLDIR=C:\custom path\Citrix.

Nota:

La carpeta Archivos de programa está protegida por el sistema operativo. Si quieres usar una carpeta personalizada que no sea Archivos de programa, asegúrate de que la carpeta tenga los permisos adecuados y esté protegida.

• Instalar uno o más componentes específicos

• Comando: ADDLOCAL
• Descripción: Usa la clave ADDLOCAL para instalar uno o más componentes específicos de la aplicación Citrix Workspace. Al usar esta clave, si instalas algún componente específico, la aplicación Citrix Workspace instala todos los componentes obligatorios de forma predeterminada.

Nota:

Te recomendamos usar la clave ADDLOCAL solo si quieres instalar alguno de los componentes específicos de la aplicación Citrix Workspace. De forma predeterminada, si no se especifica ningún parámetro ADDLOCAL, se instalan todos los componentes compatibles, excepto BCR_Client.msi, al instalar la aplicación Citrix Workspace. Para instalar el cliente BCR, instálalo usando la clave ADDLOCAL.

• La siguiente tabla enumera los componentes que admite la clave ADDLOCAL:

• DesktopViewer

  Cliente Desktop Viewer

  Marco de interfaz de usuario para escritorio virtual.

• AM	AuthManager	Authentication Manager: autoriza al usuario a la aplicación Citrix Workspace.
  SSON	SSON	Componente de inicio de sesión único: admite el inicio de sesión único.
  SELFSERVICE	Autoservicio	Plug-in para Citrix Workspace para el inicio nativo.
  WebHelper	Web Helper	Ayudante para conectar el navegador con la aplicación de espacio de trabajo nativa.
  CitrixEnterpriseBrowser	Navegador	Navegador nativo que permite a los usuarios abrir aplicaciones web o SaaS desde la aplicación Citrix Workspace de forma segura.
  MTOPBootStrapperInstaller	Plug-in de Microsoft Teams VDI	Plug-in para admitir Microsoft Teams para VDI.
  EPAClient	Cliente EPA	Plug-in para realizar análisis de Endpoint Analysis.

• ^^

  ^^

  Nota: El cliente EPA es compatible a partir de la aplicación Citrix Workspace™ para Windows 2402 LTSR CU2 y versiones posteriores.

• Por ejemplo, al usar el siguiente comando, puedes instalar los componentes mencionados en el comando:

-  CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper,CitrixEnterpriseBrowser
<!--NeedCopy-->

Nota:

La función de Protección de aplicaciones se instala de forma predeterminada. Como resultado, AppProtection ya no es una opción válida para ADDLOCAL.

Instalar Citrix Casting™

• Importante:

• Para la versión LTSR 2402 y posteriores de la aplicación Citrix Workspace, Citrix Casting no se puede instalar ni siquiera con el comando IncludeCitrixCasting. Para usar esta función, debes usar una versión anterior de la aplicación Citrix Workspace. Para obtener más información, consulta la página Desuso.

• Comando: IncludeCitrixCasting

• Descripción: Instala Citrix Casting durante la instalación.

• Para obtener más información sobre Citrix Casting, consulta Citrix Casting.

Parámetros de las funciones HDX

Establecer la redirección bidireccional de contenido

• Comando: ALLOW_BIDIRCONTENTREDIRECTION
• Descripción: Indica si la redirección bidireccional de contenido entre el cliente y el host está habilitada. Para obtener más información, consulta la sección Configuración de directivas de redirección bidireccional de contenido en la documentación de Citrix Virtual Apps and Desktops.

Los valores posibles son los siguientes:

Establecer el acceso a aplicaciones locales

• Comando: FORCE_LAA
• Descripción: Indica que la aplicación Citrix Workspace se instala con el componente de acceso a aplicaciones locales del lado del cliente. Instala la aplicación Workspace con privilegios de administrador para que este componente funcione. Para obtener más información, consulta la sección Acceso a aplicaciones locales en la documentación de Citrix Virtual Apps and Desktops.

Los valores posibles son los siguientes:

• 1

  Indica que el componente de acceso a aplicaciones locales del lado del cliente está instalado.

  CitrixWorkspaceApp.exe FORCE_LAA =1

Establecer la función de redirección de URL en el dispositivo del usuario

• Comando: ALLOW_CLIENTHOSTEDAPPSURL
• Descripción: Habilita la función de redirección de URL en el dispositivo del usuario. Para obtener más información, consulta la sección Acceso a aplicaciones locales en la documentación de Citrix Virtual Apps and Desktops.

Los valores posibles son los siguientes:

• Mostrar iconos para documentos o archivos

• Comando: LEGACYFTAICONS
• Descripción: Especifica si deseas mostrar iconos para documentos o archivos que tienen asociación de tipo de archivo con aplicaciones suscritas.

Los valores posibles son los siguientes:

• True

  No muestra iconos para documentos o archivos que tienen asociaciones de tipo de archivo con aplicaciones suscritas.

  CitrixWorkspaceApp.exe LEGACYFTAICONS=True

• Parámetros de preferencias e interfaz de usuario

• Especificar el directorio para los accesos directos en el menú Inicio y el escritorio

• Valor del comando	Descripción	Nombre del directorio	Ejemplo
  CitrixWorkspaceApp.exe STARTMENUDIR	Especifica el directorio para los accesos directos en el menú Inicio.	De forma predeterminada, las aplicaciones aparecen en Inicio > Todos los programas. Puedes especificar la ruta relativa de los accesos directos en la carpeta Programs.	Para colocar accesos directos en Inicio > Todos los programas > Workspace, especifica STARTMENUDIR=Workspace.
  CitrixWorkspaceApp.exe DESKTOPDIR	Especifica el directorio para los accesos directos en el escritorio.	Puedes especificar la ruta relativa de los accesos directos.	Para colocar accesos directos en Inicio > Todos los programas > Workspace, especifica DESKTOPDIR=Workspace.

Nota:

Al usar la opción DESKTOPDIR, establece la clave PutShortcutsOnDesktop en True.

Controlar el acceso al autoservicio

• Comando: SELFSERVICEMODE

• Descripción: Controla el acceso a la interfaz de usuario de autoservicio de la aplicación Citrix Workspace.

• Los valores posibles son los siguientes:

Controlar el prelanzamiento de la sesión

• Comando: ENABLEPRELAUNCH
• Descripción: Controla el prelanzamiento de la sesión. Para obtener más información, consulta Tiempo de inicio de la aplicación.

Los valores posibles son los siguientes:

Ocultar la opción Accesos directos y Volver a conectar

• Comando: DisableSetting
• Descripción: Oculta la opción Accesos directos y Volver a conectar para que no se muestre en la hoja Preferencias avanzadas. Para obtener más información, consulta Ocultar configuraciones específicas de la hoja Preferencias avanzadas.

Los valores posibles son los siguientes:

Habilitar el Programa de mejora de la experiencia del cliente

• Comando: EnableCEIP
• Descripción: Indica tu participación en el Programa de mejora de la experiencia del cliente (CEIP). Para obtener más información, consulta CEIP.

Los valores posibles son los siguientes:

Habilitar el rastreo siempre activo

• Comando: EnableTracing
• Descripción: Controla la función Rastreo siempre activo.

Los valores posibles son los siguientes:

Especificar el nombre para identificar el dispositivo del usuario

• Comando: CLIENT_NAME
• Descripción: Especifica el nombre utilizado para identificar el dispositivo del usuario en el servidor.
• <ClientName> - Especifica el nombre utilizado para identificar el dispositivo del usuario en el servidor. El nombre predeterminado es %COMPUTERNAME%.
• Ejemplo: CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%.

Establecer el nombre del cliente igual que el nombre del equipo

• Comando: ENABLE_DYNAMIC_CLIENT_NAME
• Descripción: Permite que el nombre del cliente sea el mismo que el nombre del equipo. Cuando cambias el nombre del equipo, el nombre del cliente también cambia.

Los valores posibles son los siguientes:

Parámetros de autenticación

Incluir inicio de sesión único

• Comando: /includeSSON
• Descripción: Requiere que lo instales como administrador. Indica que la aplicación Citrix Workspace está instalada con el componente de inicio de sesión único. Consulta Autenticación de paso a través de dominio para obtener más información.
• Ejemplo: CitrixWorkspaceApp.exe /includeSSON

Nota:

El comando includeSSON solo admite la instalación nueva de la aplicación Citrix Workspace.

Habilitar inicio de sesión único

• Comando: ENABLE_SSON
• Descripción: Habilita el inicio de sesión único cuando la aplicación Citrix Workspace se instala con el comando /includeSSON. Para obtener más información, consulta Autenticación de paso a través de dominio.

Los valores posibles son los siguientes:

Desinstalar la aplicación Citrix Workspace

Desinstalar con el desinstalador basado en Windows

Puedes desinstalar la aplicación Citrix Workspace para Windows desde el Panel de control. Para obtener más información, consulta la sección Desinstalar la aplicación Citrix Workspace para Windows.

Nota:

Durante la instalación de la aplicación Citrix Workspace, se te pedirá que desinstales el paquete Citrix HDX RTME. Haz clic en Aceptar para continuar con la desinstalación.

Desinstalar mediante la interfaz de línea de comandos

Puedes desinstalar la aplicación Citrix Workspace desde una línea de comandos escribiendo el siguiente comando:

CitrixWorkspaceApp.exe /uninstall
<!--NeedCopy-->

Para una desinstalación silenciosa de la aplicación Citrix Workspace, ejecuta el siguiente modificador:

CitrixWorkspaceApp.exe /silent /uninstall
<!--NeedCopy-->

Nota:

El instalador de la aplicación Citrix Workspace no controla las claves de registro relacionadas con GPO, por lo que se conservan después de la desinstalación. Si encuentras alguna entrada, actualízala con gpedit o elimínala manualmente.

Solución de problemas

Códigos de error

• Para los códigos de error relacionados con el instalador, consulta MsiExec.exe y InstMsi.exe: mensajes de error.
• Para los códigos de error relacionados con el sistema, consulta Códigos de error del sistema.

Ubicación del registro del instalador

Por defecto, los registros del instalador se encuentran en la siguiente ubicación:

Nota:

TrolleyExpress se reemplaza por CWAInstaller-<fecha y marca de tiempo>. Por ejemplo, el registro se guarda en C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441.

Solución de problemas

Códigos de error

• Para los códigos de error relacionados con el instalador, consulta MsiExec.exe y InstMsi.exe: mensajes de error.
• Para los códigos de error relacionados con el sistema, consulta Códigos de error del sistema.

Ubicación del registro del instalador

Por defecto, los registros del instalador se encuentran en la siguiente ubicación:

Restablecer la aplicación Citrix Workspace

Al restablecer la aplicación Citrix Workspace, se restauran los ajustes predeterminados.

Los siguientes elementos se restablecen al restablecer la aplicación Citrix Workspace:

• Todas las cuentas y almacenes configurados.
• Las aplicaciones entregadas por el plug-in de autoservicio, sus iconos y las claves de registro.
• Las asociaciones de tipos de archivo creadas por el plug-in de autoservicio.
• Los archivos en caché y las contraseñas guardadas.
• La configuración del registro por usuario.
• Las instalaciones por máquina y su configuración de registro.
• La configuración del registro de Citrix Gateway para la aplicación Citrix Workspace.

Ejecuta el siguiente comando desde la interfaz de línea de comandos para restablecer la aplicación Citrix Workspace:

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" -cleanUser
<!--NeedCopy-->

Para un restablecimiento silencioso, usa el siguiente comando:

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" /silent -cleanUser
<!--NeedCopy-->

Nota:

Usa la “U” mayúscula en el parámetro.

Restablecer la aplicación Citrix Workspace no afecta a lo siguiente:

• La instalación de la aplicación o el plug-in de Citrix Workspace.
• La configuración de bloqueo de ICA® por máquina.
• Las configuraciones de la plantilla administrativa del objeto de directiva de grupo (GPO) para la aplicación Citrix Workspace.