Citrix Workspace app for Windows

Instalar y desinstalar

Puedes descargar la aplicación Citrix Workspace desde la página de descarga de Citrix o desde la página de descarga 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

  • 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 una 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.

  • Usa el comando CitrixWorkspaceApp.exe /CleanInstall al actualizar a una versión más reciente de la aplicación Citrix Workspace.

  • Para las degradaciones, Citrix recomienda que desinstales la versión existente y luego instales la versión deseada.

Instalación con privilegios de administrador y sin privilegios de 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 pass-through, el inicio de sesión único, la protección de aplicaciones y el complemento VDI de Microsoft Teams 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:

  Carpeta de instalación Tipo de instalación
Administrador Para 64 bits: C:\Program Files\Citrix\ICA Client y para 32 bits: C:\Program Files (x86)\Citrix\ICA Client Instalación por sistema
Usuario %USERPROFILE%\AppData\Local\Citrix\ICA Client Instalación por usuario

Nota:

Los administradores pueden anular la instancia instalada por el usuario de la aplicación Citrix Workspace 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 de nuevo la nueva versión de la aplicación Citrix Workspace.

Por ejemplo:

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

Nota:

La diferencia entre los comandos forceinstall y cleaninstall es que forceinstall se ejecuta en caso de una actualización de versión no compatible o cualquier fallo, mientras que cleaninstall siempre limpia antes de realizar la acción requerida, ya sea una instalación o una actualización.

Proceso de instalación mejorado para la aplicación Citrix Workspace™ con protección de aplicaciones

Anteriormente, cuando la protección de aplicaciones estaba habilitada, el modificador /cleanInstall no era compatible y el usuario tenía que desinstalar y reiniciar la máquina manualmente antes de volver a intentar la instalación. A partir de la versión 2503, cuando la protección de aplicaciones está habilitada y se ejecuta el comando /CleanInstall, la aplicación Citrix Workspace se desinstala automáticamente, reinicia la máquina según la selección del usuario y reinstala la aplicación durante el reinicio. El siguiente mensaje aparece durante el proceso:

  -  ![Instalación correcta](/en-us/citrix-workspace-app-for-windows/media/installation-successful.png)
  • Si el usuario hace clic en Reiniciar, la aplicación Citrix Workspace se reinstala durante el reinicio.
  • Si el usuario hace clic en Cancelar, la aplicación Citrix Workspace se instalará en el próximo reinicio. Como resultado, la aplicación Citrix Workspace no estará disponible al buscarla en el sistema.

    • Nota:

        -  Para instalaciones silenciosas, la aplicación Citrix Workspace solo estará disponible después del próximo reinicio iniciado por el usuario.
        -  Si el usuario vuelve a intentar la instalación antes de reiniciar, aparecerá el siguiente mensaje para reiniciar el sistema:
      

      Fallo de instalación

Instalación basada en la interfaz de usuario

Puedes instalar la aplicación Citrix Workspace para Windows ejecutando manualmente el paquete del instalador 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.

    Requisitos previos

    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.
    
  2. Al instalar con privilegios de administrador, puedes elegir lo siguiente en la página Complemento(s):

     -  Iniciar la protección de aplicaciones después de la instalación   -  Habilitar el inicio de sesión único   -  Instalar el complemento VDI de Microsoft Teams
    -  A partir de la versión 2508 de la aplicación Citrix Workspace para Windows, esta opción está seleccionada de forma predeterminada. Los usuarios pueden desmarcar esta opción para evitar la instalación del complemento VDI de Microsoft Teams.   -  Instalar el complemento VDI de Zoom
    -  A partir de la versión 2511 de la aplicación Citrix Workspace para Windows, esta opción está seleccionada de forma predeterminada. Los usuarios pueden desmarcar esta opción para evitar la instalación del complemento VDI de Zoom.   -  Instalar el complemento VDI de Cisco WebEx
    

    instalador

    La instalación de la aplicación Citrix Workspace continúa y se completa correctamente.

SSON

Importante:

A partir de la versión 2311.1 de la aplicación Citrix Workspace para Windows, TrolleyExpress se reemplaza por CWAInstaller-<date and timestamp>. Por ejemplo, el registro se guarda en C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441.

Usar la Tienda Windows

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

    Instalación de la aplicación Citrix Workspace desde la Tienda

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

Nota:

Los plugins de terceros y los componentes de administración de plugins, como el plugin VDI de Microsoft Teams o la administración de plugins de Zoom, no son compatibles al instalar la aplicación Citrix Workspace a través de la Tienda Windows.

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 configuración. El requisito de espacio incluye los archivos de programa, los datos de usuario y los 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:

  • nombre del archivo del instalador,
  • comandos de instalación, y
  • 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

Comando Descripción
? O help Enumera todos los comandos y propiedades de instalación.
/silent Deshabilita los cuadros de diálogo y las solicitudes de instalación durante la instalación.
/forceinstall Este modificador es eficaz para 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 tenga éxito.
  • Nota:

  • El modificador forceinstall es el reemplazo del modificador rcu. El modificador rcu está obsoleto a partir de la versión 1909. Para obtener más información, consulta Obsoleto.

    La diferencia entre los comandos forceinstall y cleaninstall es que forceinstall se ejecuta en caso de una actualización de versión no compatible o cualquier fallo, mientras que cleaninstall siempre limpia antes de realizar la acción requerida, ya sea una instalación o una actualización.

Parámetros de actualización automática

Detectar actualizaciones disponibles

  • 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:

Valores del comando AutoUpdateCheck Descripción Ejemplo
Auto (predeterminado) Se te notificará cuando haya una actualización disponible. CitrixWorkspaceApp.exe AutoUpdateCheck=auto.
Manual No se te notificará cuando haya una actualización disponible. Busca actualizaciones manualmente. CitrixWorkspaceApp.exe AutoUpdateCheck=manual
Disabled 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, AURolloutPriority.

Seleccionar la versión para actualizar

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

Los valores posibles son los siguientes:

Valor del comando AutoUpdateStream Descripción Ejemplo
LTSR Actualizaciones automáticas solo a las actualizaciones acumulativas de la versión de servicio a largo plazo (LTSR). CitrixWorkspaceApp.exe AutoUpdateStream=LTSR.
Current Actualizaciones automáticas a la última versión de la aplicación Citrix Workspace. CitrixWorkspaceApp.exe AutoUpdateStream=Current

Aplazar notificaciones de actualización

  • Comando: DeferUpdateCount
  • Descripción: Indica el número de veces que puedes aplazar 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:

Valor del comando DeferUpdateCount Descripción Ejemplo
-1 (predeterminado) Permite aplazar las notificaciones cualquier número de veces CitrixWorkspaceApp.exe DeferUpdateCount=-1
0 Indica que recibes una (y solo una) notificación por cada actualización disponible. No te vuelve a recordar la actualización. CitrixWorkspaceApp.exe DeferUpdateCount=0
Cualquier otro número ‘n’ Permite aplazar la notificación ‘n’ veces. La opción Recordarme más tarde se muestra en el recuento ‘n’. CitrixWorkspaceApp.exe DeferUpdateCount=<n>

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 de ese período de entrega recibes 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 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 almacenes

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 permite 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:
Valor del comando ALLOWSAVEPWD Descripción Ejemplo
S (predeterminado) Permite guardar la contraseña solo para almacenes seguros (configurados con HTTPS). CitrixWorkspaceApp.exe ALLOWSAVEPWD=S
N No permite guardar la contraseña. CitrixWorkspaceApp.exe ALLOWSAVEPWD=N
A Permite guardar la contraseña tanto para almacenes seguros (HTTPS) como para almacenes no seguros (HTTP). CitrixWorkspaceApp.exe ALLOWSAVEPWD=A

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, Storename indica el nombre del almacén que se debe configurar.

Nota:

  • 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="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore"

STORE1="NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store"
<!--NeedCopy-->

Nota:

Es obligatorio incluir discovery en la URL del almacén para una autenticación de paso exitosa.

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

Parámetro Descripción
  • |—|—|
  • Nombre del almacén El nombre que el usuario ve para el almacén.
    URL del almacén La URL del almacén.
  • Estado habilitado del almacén El estado puede ser activado o desactivado.
  • Descripción del almacén La descripción que el usuario ve para el 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 la documentación de Protección de aplicaciones.

Nota:

El modificador startAppProtection reemplaza al modificador includeAppProtection. El modificador includeAppProtection está obsoleto a partir de la versión 2212. Para obtener más información, consulta Obsoleto.

Excluir binarios de Citrix Enterprise Browser

  • Comando: Ejecuta el siguiente comando para excluir Citrix Enterprise Browser™
CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper
<!--NeedCopy-->
  • Descripción: Excluye los binarios de Citrix Enterprise Browser.

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.

Nota:

  • A partir de la versión 2511, Citrix Enterprise Browser ya no es compatible con la aplicación Citrix Workspace para Windows. Si es necesario, los usuarios y administradores pueden instalar Citrix Enterprise Browser por separado descargándolo directamente desde la página de descargas de Citrix en la sección Citrix Enterprise Browser.

Excluir el cliente EPA de la instalación automática

  • Comando: CitrixWorkspaceApp.exe InstallEPAClient=N
  • Descripción: Detiene la instalación automática del cliente EPA.
  • Por ejemplo, usando el siguiente comando
-  CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper InstallEPAClient=N
<!--NeedCopy-->

Puedes excluir el EPA en los siguientes casos:

  • Instalación nueva
  • Actualización desde una versión que no incluye el EPA.

Especificar un directorio de instalación personalizado

  • Comando: INSTALLDIR
  • Descripción: Especifica el directorio de instalación personalizado para 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 correctos y esté protegida.

Instalar uno o más de los componentes específicos

  • Comando: ADDLOCAL
  • Descripción: Usa la clave ADDLOCAL para instalar uno o más de los 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:

Al actualizar la aplicación Citrix Workspace, el instalador no respeta los comandos de exclusión (como BCR_Client) para los componentes que ya están presentes en la versión base. Para quitar un componente durante un proceso de actualización, desinstala completamente la aplicación Citrix Workspace existente antes de instalar la nueva versión con los parámetros de exclusión requeridos.

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, todos los componentes compatibles se instalan al instalar la aplicación Citrix Workspace.

  • La siguiente tabla enumera los componentes que admite la clave ADDLOCAL:
Clave ADDLOCAL Nombre del componente Descripción
ReceiverInside Receiver Proporciona servicios SDK de espacio de trabajo al complemento de autoservicio.
ICA_Client Motor HDX™ Este componente gestiona el archivo ICA o el proceso de inicio de sesión.
BCR_Client Cliente BCR Complemento para gestionar la redirección de contenido del navegador.
  • USB Cliente USB Complemento para encargarse de la redirección USB.
  • DesktopViewer Cliente Desktop Viewer Marco de interfaz de usuario para escritorio virtual.
    AM AuthManager Administrador de autenticación: 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 Complemento 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.

Por ejemplo, usando 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:

A partir de la versión 2212, la función Protección de aplicaciones se instala de forma predeterminada. Como resultado, AppProtection ya no es una opción válida para el comando ADDLOCAL.

  • Limitación:

Cuando instalas la aplicación Citrix Workspace usando parámetros ADDLOCAL, las ventanas Dispositivos y Preferencias podrían no responder desde el Centro de conexión. Este problema ocurre solo cuando instalas la aplicación Citrix Workspace sin el parámetro DesktopViewer. Como solución alternativa, incluye también el parámetro DesktopViewer. [HDX-67173]

Instalar complementos de terceros

La aplicación Citrix Workspace admite los siguientes complementos de terceros y componentes de gestión de complementos:

  • Complemento VDI de Microsoft Teams

A partir de la versión 2508 de la aplicación Citrix Workspace para Windows, este componente se instala de forma predeterminada.

Instalaciones nuevas y actualizaciones manuales
  • La opción de instalación está seleccionada de forma predeterminada.
  • Los usuarios pueden desmarcar la opción según sus preferencias.
Actualizaciones automáticas
  • El componente se instala de forma predeterminada si no está ya presente.
  • Las instalaciones existentes se actualizan cuando hay una versión más reciente disponible.

Para evitar la instalación del complemento VDI de Microsoft Teams, los administradores pueden usar la siguiente línea de comandos:

CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=N

  • A partir de la versión 2508 de la aplicación Citrix Workspace para Windows, durante las actualizaciones, la aplicación recuerda la selección anterior. Para instalar el complemento VDI de Microsoft Teams durante una actualización (si se había deseleccionado previamente), los administradores pueden usar la siguiente línea de comandos:

CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=Y

Administración del complemento VDI de Zoom

A partir de la versión 2511 de la aplicación Citrix Workspace para Windows, este componente se instala de forma predeterminada.

  • Instalaciones nuevas y actualizaciones manuales
  • La opción de instalación está seleccionada de forma predeterminada.
  • Los usuarios pueden desmarcar la opción según sus preferencias.
Actualizaciones automáticas
  • El componente se instala de forma predeterminada si no está ya presente.
  • Las instalaciones existentes se actualizan cuando hay una versión más reciente disponible.

  • Para evitar la instalación del complemento VDI de Zoom, los administradores pueden usar la siguiente línea de comandos:

  • CitrixWorkspaceapp.exe Installzoomplugin=N
Motor de instalación del complemento VDI de WebEx

Para instalar el motor de instalación del complemento VDI de WebEx:

Instalaciones nuevas y actualizaciones manuales
  • La opción de instalación está desmarcada de forma predeterminada.
  • Los usuarios pueden seleccionar la opción según sus preferencias.

  • Actualizaciones automáticas
  • El componente no se instala de forma predeterminada.
  • Las instalaciones existentes se actualizan cuando se instalaron con una versión anterior de la aplicación Citrix Workspace y hay una versión más reciente del componente disponible.

Para instalar el motor de instalación del complemento VDI de WebEx, los administradores pueden usar la siguiente línea de comandos:

CitrixWorkspaceapp.exe ADDONS=WebexVDIPlugin

  • Nota:

    • Los componentes de terceros se obtienen de las CDN de terceros respectivas en lugar de empaquetarse con la aplicación Citrix Workspace. Los clientes deben garantizar el acceso a la red necesario desde los puntos finales para una instalación correcta de los componentes en los paquetes de la aplicación Citrix Workspace tanto en línea como sin conexión.

    • Un error en la instalación de un componente de terceros no afecta a la instalación de la aplicación Citrix Workspace.

    • Los componentes que fallaron se pueden reinstalar volviendo a ejecutar el instalador o durante una actualización.

    • La aplicación Citrix Workspace no gestiona la desinstalación de complementos de terceros al desinstalar la aplicación Citrix Workspace.

    • La aplicación Citrix Workspace conserva las selecciones de componentes en las actualizaciones. Por ejemplo, si el complemento de Microsoft Teams se deselecciona durante la instalación, no se instalará automáticamente en versiones posteriores.

    • Citrix recomienda habilitar las actualizaciones automáticas de la aplicación Citrix Workspace para recibir las últimas versiones de los componentes de terceros a medida que estén disponibles.

    • Estos complementos son software de terceros y no son creados, desarrollados ni gestionados por Cloud Software Group. Cloud Software Group no tiene obligaciones ni responsabilidad por ningún servicio o software de terceros. Al descargar o utilizar dicho software, USTED RECONOCE Y ACEPTA QUE DICHO SOFTWARE ES PROPORCIONADO POR CLOUD SOFTWARE GROUP “TAL CUAL” SIN GARANTÍA DE NINGÚN TIPO, SEGÚN DISPONIBILIDAD, Y QUE SU ACCESO O USO DEL SOFTWARE O CUALQUIER ACTIVO RELACIONADO ES BAJO SU PROPIO RIESGO. Usted reconoce que se rige por las respectivas licencias de terceros de dicho software.

Instalar Citrix Casting™

Importante:

Para la aplicación Citrix Workspace LTSR versión 2402 y posteriores, 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 UberAgent

  • Comando: InstallUberAgent
  • Descripción: El complemento UberAgent ofrece supervisión y diagnóstico avanzados para la aplicación Citrix Workspace, proporcionando información detallada sobre la experiencia del usuario y el rendimiento de la aplicación. Esta integración está disponible exclusivamente en dispositivos gestionados, lo que agiliza la implementación y reduce la sobrecarga administrativa.

Uso de la siguiente instalación de línea de comandos:

Usa el comando /InstallUberAgent para instalar o actualizar el complemento UberAgent. Usa el comando /InstallUberAgent /SkipUberAgentUpgrade para instalar el complemento sin actualizarlo si UberAgent ya está presente. Esta opción es ideal para VDA o dispositivos donde la implementación de UberAgent se gestiona por separado de la aplicación Citrix Workspace.

Nota:

  • Este componente solo se puede instalar mediante la línea de comandos.

  • Parámetros del agente de grabación de sesiones

  • Comando: InstallSRAgent
  • Descripción: El complemento de Grabación de sesiones extiende las capacidades de supervisión de sesiones directamente al dispositivo de punto final, lo que proporciona una supervisión completa de la actividad del usuario en varias aplicaciones y entornos de punto final. Esta integración agiliza la implementación y ayuda a reducir la sobrecarga administrativa.

Para la instalación mediante la línea de comandos, usa lo siguiente:

Usa el comando /InstallSRAgent para instalar o actualizar el agente de Grabación de sesiones para dispositivos de punto final. Usa el comando /InstallSRAgent /SkipSRAgentUpgrade para instalar el complemento sin actualizarlo si el agente de Grabación de sesiones ya está presente. Esta opción es ideal para dispositivos donde la implementación del agente de Grabación de sesiones se administra por separado de la aplicación Citrix Workspace.

Nota:

Este componente solo se puede instalar mediante la línea de comandos.

Si usas el instalador x86 de la aplicación Citrix Workspace, se requiere la versión x64 de .NET Desktop Runtime 8.0.15 o posterior (hasta 8.x) en esta máquina para completar la instalación.

Parámetros de las funciones HDX

  • Configurar 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:

Valor del comando ALLOW_BIDIRCONTENTREDIRECTION Descripción Ejemplo
0 (predeterminado) Indica que la redirección bidireccional de contenido está deshabilitada. CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0
1 Indica que la redirección bidireccional de contenido está habilitada. CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1

Configurar el acceso a aplicaciones locales

  • Comando: FORCE_LAA
  • Descripción: Indica que la aplicación Citrix Workspace está instalada con el componente 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:

Valor del comando FORCE_LAA Descripción Ejemplo
0 (predeterminado) Indica que el componente Acceso a aplicaciones locales no está instalado. CitrixWorkspaceApp.exe FORCE_LAA =0
1 Indica que el componente Acceso a aplicaciones locales del lado del cliente está instalado. CitrixWorkspaceApp.exe FORCE_LAA =1

Configurar 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:

Valor del comando ALLOW_CLIENTHOSTEDAPPSURL Descripción Ejemplo
0 (predeterminado) Deshabilita la función de redirección de URL en el dispositivo del usuario. CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=0
1 Habilita la función de redirección de URL en los dispositivos del usuario. CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=1

Mostrar iconos para documentos o archivos

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

Los valores posibles son los siguientes:

Valor del comando LEGACYFTAICONS Descripción Ejemplo
False (predeterminado) Muestra iconos para documentos o archivos que tienen asociaciones de tipo de archivo con aplicaciones suscritas. Cuando se establece en false, el sistema operativo genera un icono para el documento que no tiene un icono específico asignado. El icono generado por el sistema operativo es un icono genérico superpuesto con una versión más pequeña del icono de la aplicación. CitrixWorkspaceApp.exe LEGACYFTAICONS=False
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:

Cuando uses 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:

Valor del comando SELFSERVICEMODE Descripción Ejemplo
True Indica que el usuario tiene acceso a la interfaz de usuario de autoservicio. CitrixWorkspaceApp.exe SELFSERVICEMODE=True
False Indica que el usuario no tiene acceso a la interfaz de usuario de autoservicio. CitrixWorkspaceApp.exe SELFSERVICEMODE=False

Controlar el prelanzamiento de sesiones

Los valores posibles son los siguientes:

Valor del comando ENABLEPRELAUNCH Descripción Ejemplo
True Indica que el preinicio de sesión está habilitado. CitrixWorkspaceApp.exe ENABLEPRELAUNCH=True
False Indica que el preinicio de sesión está deshabilitado. CitrixWorkspaceApp.exe ENABLEPRELAUNCH=False

Ocultar la opción Accesos directos y Volver a conectar

Los valores posibles son los siguientes:

Valor del comando DisableSetting Descripción Ejemplo
0 (predeterminado) Muestra las opciones Accesos directos y Volver a conectar en la hoja Preferencias avanzadas. CitrixWorkspaceApp.exe DisableSetting=0
1 Muestra solo la opción Volver a conectar en la hoja Preferencias avanzadas. CitrixWorkspaceApp.exe DisableSetting=1
2 Muestra solo la opción Accesos directos en la hoja Preferencias avanzadas. CitrixWorkspaceApp.exe DisableSetting=2
3 Las opciones Accesos directos y Volver a conectar están ocultas en la hoja Preferencias avanzadas. CitrixWorkspaceApp.exe DisableSetting=3

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:

Valor del comando EnableCEIP Descripción Ejemplo
True (predeterminado) Participa en el Programa de mejora del cliente de Citrix (CEIP) CitrixWorkspaceApp.exe EnableCEIP=True
False No participa en el Programa de mejora del cliente de Citrix CitrixWorkspaceApp.exe EnableCEIP=False

Habilitar el rastreo siempre activo

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

Los valores posibles son los siguientes:

Valor del comando EnableTracing Descripción Ejemplo
True (predeterminado) Habilita la función Rastreo siempre activo. CitrixWorkspaceApp.exe EnableTracing=true
False Deshabilita la función Rastreo siempre activo. CitrixWorkspaceApp.exe EnableTracing=false

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:

Valor del comando ENABLE_DYNAMIC_CLIENT_NAME Descripción Ejemplo
Sí (predeterminado) Permite que el nombre del cliente sea el mismo que el nombre del equipo. CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes
No No permite que el nombre del cliente sea el mismo que el nombre del equipo. Especifica un valor para la propiedad CLIENT_NAME. CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No

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 se instala 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

A partir de la versión 2503 de la aplicación Citrix Workspace para Windows, el sistema instala SSON de forma predeterminada en modo inactivo. Puedes habilitar SSON después de la instalación mediante la directiva de objeto de directiva de grupo (GPO). Para habilitarlo, navega hasta Autenticación de usuario > Nombre de usuario y contraseña locales y selecciona la casilla de verificación Habilitar autenticación de paso a través.

Nota:

Debes reiniciar el sistema después de actualizar la directiva GPO para que la configuración de SSON surta efecto.

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:

Valor del comando ENABLE_SSON Descripción Ejemplo
Sí (predeterminado) Indica que el inicio de sesión único está habilitado. CitrixWorkspaceApp.exe ENABLE_SSON=Yes
No Indica que el inicio de sesión único está deshabilitado. CitrixWorkspaceApp.exe ENABLE_SSON=No

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 mantienen después de la desinstalación. Si encuentras alguna entrada, actualízala usando gpedit o elimínala manualmente.

Solución de problemas

Códigos de error

Ubicación del registro del instalador

De forma predeterminada, los registros del instalador se encuentran en la siguiente ubicación:

  Carpeta de registro de instalación Tipo de instalación
Administrador Para 64 bits: C:\Program Files (x86)\Citrix\Logs y para 32 bits: C:\Program Files\Citrix\ICA Client Instalación por sistema
Usuario %USERPROFILE%\AppData\Local\Citrix\Logs Instalación por usuario

Nota:

A partir de la versión 2311.1 de la aplicación Citrix Workspace para Windows, 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.

Restablecer la aplicación Citrix Workspace

Restablecer la aplicación Citrix Workspace restaura la configuración predeterminada.

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

  • Todas las cuentas y almacenes configurados.
  • Las aplicaciones entregadas por el complemento de autoservicio, sus iconos y claves de registro.
  • Las asociaciones de tipos de archivo creadas por el complemento de autoservicio.
  • Los archivos en caché y las contraseñas guardadas.
  • La configuración de registro por usuario.
  • Las instalaciones por máquina y su configuración de registro.
  • La configuración de 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 complemento de Citrix Workspace.
  • La configuración de bloqueo de ICA® por máquina.
  • Las configuraciones de plantilla administrativa de objeto de directiva de grupo (GPO) para la aplicación Citrix Workspace.
Instalar y desinstalar