Installer et désinstaller

Vous pouvez télécharger l’application Citrix Workspace à partir de la page de téléchargement de Citrix ou de la page de téléchargement de votre entreprise (si disponible).

Vous pouvez installer le package à l’aide des méthodes suivantes :

• Exécution d’un assistant d’installation Windows interactif.

  Ou

• Saisie du nom du fichier d’installation, des commandes d’installation et des propriétés d’installation à l’aide de l’interface de ligne de commande. Pour plus d’informations sur l’installation de l’application Citrix Workspace à l’aide de l’interface de ligne de commande, consultez la section Utilisation des paramètres de ligne de commande.

Remarque :

Vérifiez que vous avez installé toutes les exigences requises par le système, comme indiqué dans la section Configuration système requise.

Installation avec des privilèges d’administrateur et non administrateur :

L’application Citrix Workspace peut être installée aussi bien par les utilisateurs que les administrateurs. Vous devez disposer de privilèges d’administrateur seulement si vous utilisez l’authentification pass-through, l’authentification unique, App Protection, le plug-in Microsoft Teams VDI, Citrix Ready Workspace Hub avec l’application Citrix Workspace pour Windows.

Le tableau suivant décrit les différences lorsque l’application Citrix Workspace est installée par un administrateur ou par un utilisateur :

Remarque :

Les administrateurs peuvent remplacer l’instance de l’application Citrix Workspace installée par l’utilisateur et poursuivre l’installation.

Commande pour nettoyer et installer l’application Citrix Workspace

Utilisez la commande /CleanInstall pour nettoyer les traces restantes, telles que les fichiers et les valeurs de registre d’une désinstallation précédente, puis installez la nouvelle version de l’application Citrix Workspace.

Par exemple :

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

Installation basée sur l’interface utilisateur

Vous pouvez installer l’application Citrix Workspace pour Windows en exécutant manuellement le package d’installation CitrixWorkspaceApp.exe.

1. Lancez le fichier CitrixWorkspaceApp.exe.

   Le système vérifie les conditions requises pour l’application Citrix Workspace et, le cas échéant, l’installe automatiquement.

    

   Après avoir installé les composants prérequis, l’écran Bienvenue dans le programme d’installation de Citrix Workspace s’affiche.

2. Cliquez sur Continuer. La page Contrat de licence Citrix s’affiche.
3. Lisez et acceptez le contrat de licence Citrix et poursuivez l’installation. L’installation de l’application Citrix Workspace se poursuit et se termine avec succès.
4. Lors de l’installation avec des privilèges d’administrateur, si nécessaire pour activer la fonctionnalité App Protection, cochez la case Démarrer App Protection après l’installation. L’installation de l’application Citrix Workspace se poursuit et se termine avec succès.

Important :

TrolleyExpress est remplacé par CWAInstaller-<date and timestamp>. Par exemple, le journal est enregistré sous C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441.

Utilisation de Windows Store

1. Accédez à Microsoft Store.
2. Recherchez Citrix Workspace.

1. Cliquez sur Obtenir. L’application Citrix Workspace est installée.

Installation avec ligne de commande

Vous pouvez personnaliser le programme d’installation de l’application Citrix Workspace en spécifiant différentes options de ligne de commande. Le programme d’installation s’extrait automatiquement sur le répertoire temporaire du système avant le lancement du programme d’installation. Cet espace disponible comprend les fichiers programmes, les données utilisateur et les répertoires temporaires après le lancement de plusieurs applications.

Pour installer l’application Citrix Workspace à l’aide de la ligne de commande Windows, lancez l’invite de commande et tapez ce qui suit sur une seule ligne :

• Nom de fichier du programme d’installation
• Commandes d’installation
• Propriétés d’installation

Les commandes et propriétés d’installation disponibles sont répertoriées ci-dessous :

CitrixWorkspaceApp.exe [commands] [properties]

Liste des paramètres de ligne de commande

Les paramètres sont généralement classés comme suit :

• Paramètres courants
• Paramètres de mise à jour
• Paramètres d’installation
• Paramètres des fonctionnalités HDX
• Préférences et paramètres de l’interface utilisateur
• Paramètres d’authentification

Paramètres courants

Remarque :

Le commutateur forceinstall remplace le commutateur rcu. Le commutateur rcu n’est plus pris en charge à compter de la version 1909. Pour plus d’informations, consultez Fin de prise en charge.

Paramètres de mise à jour automatique

Détecter la mise à jour disponible

• Commande : AutoUpdateCheck
• Description : cette commande indique que l’application Citrix Workspace détecte lorsqu’une mise à jour est disponible.

Les valeurs possibles sont les suivantes :

Remarque :

AutoUpdateCheck est un paramètre obligatoire que vous devez définir pour configurer d’autres paramètres comme AutoUpdateStream, DeferUpdateCount, AURolloutPriority.

Sélectionner la version à mettre à jour

• CommandeAutoUpdateStream
• Description : si vous avez activé la mise à jour automatique, vous pouvez choisir la version que vous souhaitez mettre à jour. Pour plus d’informations, consultez la section Étapes du cycle de vie.

Les valeurs possibles sont les suivantes :

Différer les notifications de mise à jour

• Commande : DeferUpdateCount
• Description : indique le nombre de fois où vous pouvez différer les notifications lorsqu’une mise à jour est disponible. Pour plus d’informations, consultez la section Mises à jour de Citrix Workspace.

Les valeurs possibles sont les suivantes :

Remarque :

à partir de la version 2207 de l’application Citrix Workspace pour Windows, la fonctionnalité de mise à jour automatique est améliorée et le paramètre DeferUpdatCount n’est pas applicable.

Définir la priorité de déploiement

• Commande : AURolloutPriority
• Description : lorsqu’une nouvelle version de l’application est disponible, Citrix déploie la mise à jour pendant une période de mise à disposition spécifique. Avec ce paramètre, vous pouvez contrôler à quel moment de cette période vous pouvez recevoir la mise à jour.

Les valeurs possibles sont les suivantes :

Paramètres de configuration du magasin

Configurer le magasin

• Commande : ALLOWADDSTORE
• Description : permet de configurer les magasins (http ou https) en fonction du paramètre spécifié.

Les valeurs possibles sont les suivantes :

Enregistrer les informations d’identification du magasin localement

• Commande : ALLOWSAVEPWD
• Description : permet d’enregistrer les informations d’identification du magasin localement. Ce paramètre s’applique uniquement aux magasins utilisant le protocole de l’application Citrix Workspace.

Les valeurs possibles sont les suivantes :

Exemples de configuration du magasin à l’aide de l’installation par ligne de commande

Pour spécifier l’URL du magasin StoreFront :

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

<!--NeedCopy-->

Pour spécifier l’adresse URL du magasin Citrix Gateway :

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

où Storename indique le nom du magasin qui doit être configuré.

Remarque :

• Dans une configuration multi-magasins, une seule configuration de l’URL du magasin Citrix Gateway est autorisée et doit figurer en premier de la liste (paramètre STORE0).
• L’adresse URL du magasin Citrix Gateway configurée à l’aide de cette méthode ne prend pas en charge les sites Services PNA qui utilisent Citrix Gateway.
• Le paramètre « Discovery » n’est pas requis lors de la spécification d’une URL de magasin Citrix Gateway.

Pour configurer plusieurs magasins :

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

Remarque :

• Il est obligatoire d’inclure discovery dans l’adresse URL du magasin pour une authentification pass-through réussie.
• L’adresse URL du magasin Citrix Gateway doit être la première entrée dans la liste des adresses URL de magasin configurées.

Paramètres d’installation

Démarrer la protection des applications

• Commande : startAppProtection
• Description : démarre la protection des applications et offre une sécurité renforcée en protégeant les clients contre les programmes malveillants d’enregistrement de frappe et de capture d’écran.
• Exemple : CitrixWorkspaceApp.exe startAppProtection

Pour plus d’informations, consultez App Protection.

Remarque :

Le commutateur startAppProtection remplace le commutateur includeAppProtection. Le commutateur includeAppProtection est obsolète. Pour plus d’informations, consultez Fin de prise en charge.

Exclure les fichiers binaires de Citrix Enterprise Browser

• Commande : InstallEmbeddedBrowser
• Description : exclut les fichiers binaires de Citrix Enterprise Browser.
• Exemple : exécutez le commutateur InstallEmbeddedBrowser=N pour exclure la fonctionnalité de navigateur intégré.

Vous pouvez exclure les fichiers binaires de Citrix Enterprise Browser uniquement dans les cas suivants :

• Nouvelle installation
• Mise à niveau à partir d’une version qui n’inclut pas les fichiers binaires de Citrix Enterprise Browser.

Si votre version de l’application Citrix Workspace inclut les fichiers binaires de Citrix Enterprise Browser et que vous effectuez une mise à niveau vers la version 2002, les fichiers binaires de Citrix Enterprise Browser sont automatiquement mis à jour pendant la mise à niveau.

Spécifier un répertoire d’installation personnalisé

• Commande : INSTALLDIR
• Description : spécifie le répertoire d’installation personnalisé pour l’installation de l’application Citrix Workspace. Le chemin d’accès par défaut est C:\Program Files\Citrix.
• Exemple : CitrixWorkspaceApp.exe INSTALLDIR=C:\custom path\Citrix.

Remarque :

Le dossier Program Files est protégé par le système d’exploitation. Si vous souhaitez utiliser un dossier personnalisé autre que Program Files, assurez-vous que le dossier dispose des autorisations appropriées et qu’il est protégé.

Installer un ou plusieurs composants spécifiques

• Commande : ADDLOCAL
• Description : utilisez la clé ADDLOCAL pour installer un ou plusieurs composants spécifiques de l’application Citrix Workspace. À l’aide de cette clé, si vous installez des composants spécifiques, l’application Citrix Workspace installe tous les composants obligatoires par défaut.

Remarque :

Nous vous recommandons d’utiliser la clé ADDLOCAL uniquement si vous souhaitez installer des composants spécifiques de l’application Citrix Workspace. Par défaut, si aucun paramètre ADDLOCAL n’est spécifié, tous les composants pris en charge sont installés lors de l’installation de l’application Citrix Workspace.

Le tableau suivant répertorie les composants pris en charge par la clé ADDLOCAL :

Par exemple, à l’aide de la commande suivante, vous pouvez installer les composants mentionnés dans la commande :

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

Remarque :

La fonction App Protection est installée par défaut. Par conséquent, AppProtection n’est plus une option valide pour ADDLOCAL.

Installer Citrix Casting

Important :

Pour l’application Citrix Workspace LTSR version 2402 et versions ultérieures, Citrix Casting ne peut pas être installé même avec la commande IncludeCitrixCasting. Pour utiliser cette fonctionnalité, vous devez utiliser une ancienne version de l’application Citrix Workspace. Pour plus d’informations, consultez la page Fin de prise en charge.

• Commande : IncludeCitrixCasting
• Description : installe Citrix Casting pendant l’installation.

Pour plus d’informations sur Citrix Casting, consultez Citrix Casting.

Paramètres des fonctionnalités HDX

Définir la redirection bidirectionnelle du contenu

• Commande : ALLOW_BIDIRCONTENTREDIRECTION
• Description : indique si la redirection bidirectionnelle du contenu du client vers l’hôte est activée. Pour plus d’informations, consultez la section Paramètres de stratégie Redirection bidirectionnelle du contenu de la documentation Citrix Virtual Apps and Desktops.

Les valeurs possibles sont les suivantes :

Définir Local App Access

• Commande : FORCE_LAA
• Description : indique que l’application Citrix Workspace est installée avec le composant Local App Access côté client. Installez l’application Workspace avec des privilèges d’administrateur pour que ce composant fonctionne. Pour plus d’informations, consultez la section Local App Access de la documentation Citrix Virtual Apps and Desktops.

Les valeurs possibles sont les suivantes :

Définir la fonctionnalité de redirection des adresses URL sur les machines utilisateur

• Commande : ALLOW_CLIENTHOSTEDAPPSURL
• Description : active la fonctionnalité de redirection des adresses URL sur les machines utilisateur. Pour plus d’informations, consultez la section Local App Access de la documentation Citrix Virtual Apps and Desktops.

Les valeurs possibles sont les suivantes :

Afficher des icônes pour des documents ou des fichiers

• Commande : LEGACYFTAICONS
• Description : spécifie si les icônes sont affichées pour les documents ou les fichiers qui disposent d’associations de type de fichier avec des applications faisant l’objet d’une souscription.

Les valeurs possibles sont les suivantes :

Préférences et paramètres de l’interface utilisateur

Spécifier le répertoire des raccourcis dans le menu Démarrer et sur le bureau

Remarque :

Lorsque vous utilisez l’option DESKTOPDIR, définissez la clé PutShortcutsOnDesktop sur True.

Contrôler l’accès à l’interface en libre-service

• Commande : SELFSERVICEMODE
• Description : contrôle l’accès à l’interface utilisateur en libre-service de l’application Citrix Workspace.

Les valeurs possibles sont les suivantes :

Contrôler le pré-lancement de session

• Commande : ENABLEPRELAUNCH
• Description : contrôle le pré-lancement de session. Pour plus d’informations, consultez la section Temps de lancement des applications.

Les valeurs possibles sont les suivantes :

Masquer l’option Raccourcis et reconnexion

• Commande : DisableSetting
• Description : masque l’affichage de l’option Raccourcis et reconnexion sur la page Préférences avancées. Pour plus d’informations, consultez la section Masquer des paramètres spécifiques sur la page Paramètres avancés.

Les valeurs possibles sont les suivantes :

Activer le programme d’amélioration de l’expérience utilisateur (CEIP)

• Commande : EnableCEIP
• Description : indique votre participation au programme d’amélioration de l’expérience utilisateur (CEIP). Pour plus d’informations, veuillez consulter la section CEIP (programme d’amélioration de l’expérience du client).

Les valeurs possibles sont les suivantes :

Activer le suivi permanent

• Commande : EnableTracing
• Description : contrôle la fonction de suivi permanent.

Les valeurs possibles sont les suivantes :

Spécifier le nom pour identifier la machine utilisateur

• Commande : CLIENT_NAME
• Description : spécifie le nom utilisé pour identifier la machine utilisateur sur le serveur.
• <ClientName> : spécifie le nom utilisé pour identifier la machine utilisateur sur le serveur. Le nom par défaut est %COMPUTERNAME%.
• Exemple : CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%.

Définir le nom du client comme nom de la machine

• Commande : ENABLE_DYNAMIC_CLIENT_NAME
• Description : autorise l’utilisation d’un nom de client identique au nom de machine. Lorsque vous modifiez le nom de machine, le nom de client change en conséquence.

Les valeurs possibles sont les suivantes :

Paramètres d’authentification

Inclure l’authentification unique (Single Sign-On)

• Commande : /includeSSON
• Description : requiert une installation en tant qu’administrateur. Indique que l’application Citrix Workspace est installée avec le composant d’authentification unique (Single Sign-On). Consultez la section Authentification pass-through au domaine pour plus d’informations.
• Exemple : CitrixWorkspaceApp.exe /includeSSON

Remarque :

La commande includeSSON prend uniquement en charge la nouvelle installation de l’application Citrix Workspace.

Activer l’authentification unique

• Commande : ENABLE_SSON
• Description : active l’authentification Single Sign-On lorsque l’application Citrix Workspace est installée avec la commande /includeSSON. Pour plus d’informations, consultez la section Authentification pass-through au domaine.

Les valeurs possibles sont les suivantes :

Désinstaller l’application Citrix Workspace

Désinstaller à l’aide du programme de désinstallation Windows

Vous pouvez désinstaller l’application Citrix Workspace pour Windows à partir du Panneau de configuration. Pour plus d’informations, consultez la section Désinstaller l’application Citrix Workspace pour Windows.

Remarque :

Lors de l’installation de l’application Citrix Workspace, vous recevez une invite pour désinstaller le package Citrix HDX RTME. Cliquez sur OK pour poursuivre la désinstallation.

Désinstaller à l’aide de l’interface de ligne de commande

Vous pouvez désinstaller l’application Citrix Workspace à partir d’une ligne de commande en tapant la commande suivante :

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

Pour la désinstallation en mode silencieux de l’application Citrix Workspace, exécutez le commutateur suivant :

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

Remarque :

Le programme d’installation de l’application Citrix Workspace ne contrôle pas les clés de registre liées à l’objet de stratégie de groupe. Elles sont donc conservées après la désinstallation. Si vous trouvez des entrées, mettez-les à jour à l’aide de gpedit ou supprimez-les manuellement.

Dépannage

Error codes

• Pour les codes d’erreur liés au programme d’installation, consultez les messages d’erreur MsiExec.exe et InstMsi.exe.
• Pour les codes d’erreur liés au système, consultez Codes d’erreur système.

Emplacement du journal du programme d’installation

Par défaut, les journaux du programme d’installation se trouvent dans l’emplacement suivant :

Remarque :

TrolleyExpress est remplacé par CWAInstaller-<date and timestamp>. Par exemple, le journal est enregistré sous C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441.

Dépannage

Error codes

• Pour les codes d’erreur liés au programme d’installation, consultez les messages d’erreur MsiExec.exe et InstMsi.exe.
• Pour les codes d’erreur liés au système, consultez Codes d’erreur système.

Emplacement du journal du programme d’installation

Par défaut, les journaux du programme d’installation se trouvent dans l’emplacement suivant :

Réinitialiser l’application Citrix Workspace

La réinitialisation de l’application Citrix Workspace restaure les paramètres par défaut.

Les éléments suivants sont réinitialisés lorsque vous réinitialisez l’application Citrix Workspace :

• Tous les comptes et magasins configurés.
• Applications fournies par le Self-Service Plug-in, leurs icônes et leurs clés de registre.
• Associations de types de fichiers créées par le Self-Service Plug-in.
• Fichiers mis en cache et mots de passe enregistrés.
• Paramètres de registre par utilisateur.
• Installations par machine et leurs paramètres de registre.
• Paramètres de registre de Citrix Gateway pour l’application Citrix Workspace.

Exécutez la commande suivante à partir de l’interface de ligne de commande pour réinitialiser l’application Citrix Workspace :

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

Pour effectuer une réinitialisation silencieuse, utilisez la commande suivante :

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

Remarque :

Utilisez le U majuscule dans le paramètre.

La réinitialisation de l’application Citrix Workspace n’a aucune incidence sur ce qui suit :

• Installation d’une application Citrix Workspace ou d’un plug-in.
• Paramètres de verrouillage ICA par machine.
• Configurations de modèles d’administration d’objets de stratégie de groupe (GPO) pour l’application Citrix Workspace.