Installer et désinstaller
Remarques à l’intention des administrateurs avant l’installation de l’application Citrix Workspace 1912 LTSR pour Windows
- L’application Citrix Workspace 1912 LTSR pour Windows nécessite la version 4.6.2 ou ultérieure de .NET Framework. Le programme d’installation de l’application Citrix Workspace télécharge et installe .NET Framework si la version n’est pas présente dans le système. Toutefois, nous vous recommandons d’installer manuellement le composant .NET Framework requis avant d’installer ou de mettre à jour l’application Citrix Workspace.
- Si vous tentez une installation sans assistance, consultez l’article du centre de connaissances CTX257546.
Vous pouvez installer l’application Citrix Workspace en téléchargeant le package d’installation CitrixWorkspaceApp.exe à partir de la page Téléchargement 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.
Installation avec des privilèges d’administrateur et non administrateur :
Aussi bien les utilisateurs que les administrateurs peuvent installer l’application Citrix Workspace. Vous devez disposer de privilèges d’administrateur pour utiliser l’authentification pass-through et 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 :
| Dossier d’installation | Type d’installation | |
|---|---|---|
| Administrateur | C:\Program Files (x86)\Citrix\ICA Client | Installation par système |
| Utilisateur | %USERPROFILE%\AppData\Local\Citrix\ICA Client | Installation par utilisateur |
Remarque :
Si un administrateur installe Citrix Workspace pour Windows sur un système alors qu’un utilisateur a déjà installé une instance de l’application sur ce système, un conflit se produira. Citrix vous recommande de désinstaller toutes les instances de l’application Citrix Workspace installées par l’utilisateur avant d’installer l’application en tant qu’administrateur.
Utilisation d’un programme d’installation Windows
Vous pouvez installer l’application Citrix Workspace pour Windows à l’aide du support d’installation, d’un partage réseau, de l’Explorateur Windows ou d’une ligne de commande en exécutant manuellement le package d’installation CitrixWorkspaceApp.exe.
Par défaut, les journaux d’installation se situent dans %temp%\CTXReceiverInstallLogs*.logs.
- Exécutez le fichier
CitrixWorkspaceApp.exeet cliquez sur Démarrer. - Lisez et acceptez le contrat de licence de l’utilisateur final et continuez l’installation.
- Si vous tentez l’installation sur une machine appartenant à un domaine avec des privilèges d’administrateur, une boîte de dialogue supplémentaire s’affiche pour activer ou désactiver l’authentification unique. Pour en savoir plus, consultez la section Authentification directe du domaine.
- Suivez le programme d’installation Windows pour terminer l’installation.
Utilisation des paramètres de ligne de commande
Vous pouvez installer l’application Citrix Workspace en tapant le nom du fichier d’installation, les commandes d’installation et les propriétés d’installation à partir de l’interface de ligne de commande. Vous pouvez personnaliser le programme d’installation de l’application Citrix Workspace en spécifiant des options de ligne de commande. Le programme d’installation s’extrait automatiquement sur le dossier temporaire du système avant le lancement de l’installation. Cet espace disponible comprend les fichiers programmes, les données utilisateur et les dossiers 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 commandes, puis tapez le nom du fichier d’installation, les commandes d’installation et les propriétés d’installation sur une seule ligne. 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 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
-
/?Ou/help- Répertorie toutes les commandes et propriétés d’installation. -
/silent- Désactive l’affichage des boîtes de dialogue et les invites d’installation pendant l’installation. -
/noreboot- Supprime les invites de redémarrage pendant l’installation. Lorsque vous supprimez l’invite de redémarrage, les périphériques USB qui sont dans un état suspendu ne sont reconnus par l’application Citrix Workspace qu’après le redémarrage de la machine utilisateur. -
/includeSSON- Nécessite une installation en tant qu’administrateur. Indique que l’application Citrix Workspace est installée avec le composant Single Sign-On. Pour en savoir plus, consultez la section Authentification directe du domaine. -
/rcu- Ce commutateur n’est efficace que lors de la mise à niveau à partir d’une version non prise en charge du logiciel. Indique que l’application Citrix Workspace sera installée ou mise à niveau en désinstallant la version existante du logiciel. Cela permet également de nettoyer les paramètres existants.Remarque :
Le commutateur
/rcuest obsolète depuis la version 1909. Pour plus d’informations, consultez Fin de prise en charge. -
/forceinstall- Ce commutateur est efficace pour nettoyer toute configuration ou entrée existante de l’application Citrix Workspace sur le système dans les scénarios suivants :- Vous effectuez une mise à niveau à partir d’une version non prise en charge de la version de l’application Citrix Workspace.
- L’installation ou la mise à niveau échoue.
Paramètres d’installation
/AutoUpdateCheck
Indique que l’application Citrix Workspace pour Windows détecte lorsqu’une mise à jour est disponible.
- Auto (valeur par défaut) : vous êtes informé lorsqu’une mise à jour est disponible. Exemple,
CitrixWorkspaceApp.exe /AutoUpdateCheck=auto. - Manuel : vous n’êtes pas informé lorsqu’une mise à jour est disponible. Recherchez les mises à jour manuellement. Exemple,
CitrixWorkspaceApp.exe /AutoUpdateCheck=manual. - Disabled (Désactivé) : les mises à jour automatiques sont désactivées. Exemple,
CitrixWorkspaceApp.exe /AutoUpdateCheck=disabled.
/AutoUpdateStream
Si vous avez activé la mise à jour automatique, vous pouvez choisir le canal de publication vers lequel vous souhaitez mettre à jour. Pour plus d’informations, consultez la section Étapes du cycle de vie.
- LTSR : mise à jour automatique uniquement vers des mises à jour cumulatives Long Term Service Release. Exemple,
CitrixWorkspaceApp.exe /AutoUpdateStream=LTSR. - Actuel - Effectue les mises à jour automatiques avec la dernière version de l’application Citrix Workspace. Exemple,
CitrixWorkspaceApp.exe /AutoUpdateStream=Current.
/DeferUpdateCount
Indique le nombre de fois où vous pouvez différer les notifications de mise à jour lorsqu’une mise à jour est disponible. Pour plus d’informations, consultez la section Mises à jour de Citrix Workspace.
- -1 (valeur par défaut) : permet de différer les notifications n’importe quel nombre de fois. Exemple,
CitrixWorkspaceApp.exe /DeferUpdateCount=-1. - 0 : indique que vous recevrez une (seule) notification pour chaque mise à jour disponible. Vous ne recevrez plus de rappel à propos de la mise à jour. Exemple,
CitrixWorkspaceApp.exe /DeferUpdateCount=0. - Tout autre numéro « n » : permet de différer les notifications de mise à jour un nombre « n » de fois. L’option Me rappeler plus tard s’affiche le nombre « n » de fois défini. Exemple,
CitrixWorkspaceApp.exe /DeferUpdateCount=<n>.
/AURolloutPriority
Lorsqu’une nouvelle version de l’application est publiée, 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.
- Auto (par défaut) : vous recevez les mises à jour pendant la période de mise à disposition configurée par Citrix. Exemple,
CitrixWorkspaceApp.exe /AURolloutPriority=Auto. - Fast (Rapide) : vous recevez les mises à jour au début de la période de mise à disposition. Exemple,
CitrixWorkspaceApp.exe /AURolloutPriority=Fast. - Medium (Moyen) : vous recevez les mises à jour au milieu de la période de mise à disposition. Exemple,
CitrixWorkspaceApp.exe /AURolloutPriority=Medium. - Slow (Lent) : vous recevez les mises à jour à la fin de la période de mise à disposition. Exemple,
CitrixWorkspaceApp.exe /AURolloutPriority=Slow.
/includeappprotection
Fournit une sécurité renforcée lors de l’utilisation de Citrix Virtual Apps and Desktops et Citrix DaaS (anciennement Citrix Virtual Apps and Desktops Service) en protégeant les clients contre les programmes malveillants d’enregistrement de frappe et de capture d’écran.
CitrixWorkspaceApp.exe /includeappprotection
Pour plus d’informations, consultez la section App Protection.
INSTALLDIR
Spécifie le répertoire d’installation personnalisé pour l’installation de l’application Citrix Workspace. Le chemin par défaut est C:\Program Files\Citrix. Exemple, CitrixWorkspaceApp.exe INSTALLDIR=C:\Program Files\Citrix.
ADDLOCAL
Installe un ou plusieurs des composants spécifiés. Exemple, CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SELFSERVICE,DesktopViewer,Flash,Vd3d,WebHelper,BrowserEngine,WorkspaceHub,USB.
Paramètres des fonctionnalités HDX
ALLOW_BIDIRCONTENTREDIRECTION
Indique que la redirection bidirectionnelle du contenu du client vers l’hôte et de l’hôte vers le client 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.
- 0 (valeur par défaut) : indique que la redirection bidirectionnelle du contenu est désactivée. Exemple,
CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0. - 1 : indique que la redirection bidirectionnelle du contenu est activée. Exemple,
CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1.
FORCE_LAA
Indique que l’application Citrix Workspace est installée avec le composant Local App Access côté client. Vous devez installer l’application Citrix 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.
- 0 (valeur par défaut) : indique que le composant Local App Access n’est pas installé. Exemple,
CitrixWorkspaceApp.exe FORCE_LAA=0. - 1 : indique que le composant Local App Access côté client est installé. Exemple,
CitrixWorkspaceApp.exe FORCE_LAA=1.
LEGACYFTAICONS
Spécifie si les icônes des applications 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.
- False (valeur par défaut) : indique que les icônes de l’application 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. Lorsque ce paramètre est défini sur false, le système d’exploitation génère une icône pour le document qui ne possède pas d’icône spécifique. L’icône générée par le système d’exploitation est une icône générique sur laquelle est superposée une version plus petite de l’icône d’application. Exemple,
CitrixWorkspaceApp.exe LEGACYFTAICONS=False. - True : indique que les icônes de l’application ne sont pas 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. Exemple,
CitrixWorkspaceApp.exe LEGACYFTAICONS=True.
ALLOW_CLIENTHOSTEDAPPSURL
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.
- 0 (valeur par défaut) : désactive la fonctionnalité de redirection des adresses URL sur les machines utilisateur. Exemple,
CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=0. - 1 : active la fonctionnalité de redirection des adresses URL sur les machines utilisateur. Exemple,
CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=1.
Préférences et paramètres de l’interface utilisateur
ALLOWADDSTORE
Permet de configurer les magasins (http ou https) en fonction du paramètre spécifié.
- S (valeur par défaut) : permet d’ajouter ou de supprimer des magasins sécurisés uniquement (configuré avec HTTPS). Exemple,
CitrixWorkspaceApp.exe ALLOWADDSTORE=S. - A : permet d’ajouter ou de supprimer des magasins sécurisés (HTTPS) et des magasins non sécurisés (HTTP). Non applicable si l’application Citrix Workspace est installée par utilisateur. Exemple,
CitrixWorkspaceApp.exe ALLOWADDSTORE=A. - N : permet de ne jamais autoriser les utilisateurs à ajouter ou supprimer leur propre magasin. Exemple,
CitrixWorkspaceApp.exe ALLOWADDSTORE=N.
ALLOWSAVEPWD
Permet d’enregistrer les informations d’identification du magasin localement. Ce paramètre s’applique uniquement aux magasins utilisant le protocole PNAgent.
- S (valeur par défaut) - autorise l’enregistrement du mot de passe uniquement pour les magasins sécurisés (configurés avec HTTPS). Exemple,
CitrixWorkspaceApp.exe ALLOWSAVEPWD=S. - N : n’autorise pas l’enregistrement du mot de passe. Exemple,
CitrixWorkspaceApp.exe ALLOWSAVEPWD=N. - R : autorise l’enregistrement du mot de passe pour les magasins sécurisés (HTTPS) et les magasins non sécurisés (HTTP). Exemple,
CitrixWorkspaceApp.exe ALLOWSAVEPWD=A.
STARTMENUDIR
Spécifie le dossier des raccourcis dans le menu Démarrer.
-
<Directory Name>- Par défaut, les applications s’affichent sous Démarrer > Tous les programmes. Vous pouvez spécifier le chemin d’accès relatif des raccourcis dans le dossier\Programmes. Par exemple, pour placer des raccourcis sous Démarrer > Tous les programmes > Espace de travail, spécifiezSTARTMENUDIR=\Workspace.
DESKTOPDIR
Spécifie le dossier des raccourcis sur le Bureau.
Remarque :
Lorsque vous utilisez l’option DESKTOPDIR, définissez la clé
PutShortcutsOnDesktopsurTrue.
-
<Directory Name>- Vous pouvez spécifier le chemin d’accès relatif des raccourcis. Par exemple, pour placer des raccourcis sous Démarrer > Tous les programmes > Espace de travail, spécifiezDESKTOPDIR=\Workspace.
SELFSERVICEMODE
Contrôle l’accès à l’interface utilisateur en libre-service de l’application Citrix Workspace.
- True : indique que l’utilisateur a accès à l’interface utilisateur en libre-service. Exemple,
CitrixWorkspaceApp.exe SELFSERVICEMODE=True. - False : indique que l’utilisateur n’a pas accès à l’interface utilisateur en libre-service. Exemple,
CitrixWorkspaceApp.exe SELFSERVICEMODE=False.
ENABLEPRELAUNCH
Contrôle le pré-lancement de session. Consultez la section Temps de lancement des applications pour plus d’informations.
- True : indique que le pré-lancement de session est activé. Exemple,
CitrixWorkspaceApp.exe ENABLEPRELAUNCH=True. - False : indique que le pré-lancement de session est désactivé. Exemple,
CitrixWorkspaceApp.exe ENABLEPRELAUNCH=False.
DisableSetting
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.
- 0 (valeur par défaut) : affiche les options Raccourcis et Reconnexion sur la page Préférences avancées. Exemple,
CitrixWorkspaceApp.exe DisableSetting=0. - 1 : affiche uniquement l’option Reconnexion sur la page Préférences avancées. Exemple,
CitrixWorkspaceApp.exe DisableSetting=1. - 2 : affiche uniquement l’option Raccourcis sur la page Préférences avancées. Exemple,
CitrixWorkspaceApp.exe DisableSetting=2. - 3 : les options Raccourcis et Reconnexion sont masquées sur la page Préférences avancées. Exemple,
CitrixWorkspaceApp.exe DisableSetting=3.
EnableCEIP
Indique votre participation au programme d’amélioration de l’expérience utilisateur (CEIP). Consultez la section CEIP pour plus d’informations.
- True (valeur par défaut) : choisir de participer au programme CEIP. Exemple,
CitrixWorkspaceApp.exe EnableCEIP=True. - False : choisir de ne pas participer au programme CEIP. Exemple,
CitrixWorkspaceApp.exe EnableCEIP=False.
EnableTracing
Contrôle la fonction de suivi permanent.
- True (valeur par défaut) : active la fonction de suivi permanent. Example.
CitrixWorkspaceApp.exe EnableTracing=true. - False : désactive la fonction de suivi permanent. Exemple,
CitrixWorkspaceApp.exe EnableTracing=false.
CLIENT_NAME
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%.
ENABLE_DYNAMIC_CLIENT_NAME
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.
- Yes (valeur par défaut) : autorise l’utilisation d’un nom de client identique au nom de machine. Exemple,
CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes. - No : n’autorise pas l’utilisation d’un nom de client identique au nom de machine. Vous devez spécifier une valeur pour la propriété
CLIENT_NAME. Exemple,CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No.
Paramètres d’authentification
ENABLE_SSON
Active l’authentification unique lorsque l’application Citrix Workspace est installée avec la commande /includeSSON. Pour en savoir plus, consultez la section Authentification directe du domaine.
- Yes (valeur par défaut) : indique que l’authentification unique est activée. Exemple,
CitrixWorkspaceApp.exe /ENABLE_SSON=Yes. - No : indique que l’authentification unique est désactivée. Exemple,
CitrixWorkspaceApp.exe /ENABLE_SSON=No.
ENABLE_KERBEROS
Spécifie si le moteur HDX doit utiliser l’authentification Kerberos. Ce paramètre ne s’applique que lorsque l’authentification unique est activée. Pour plus d’informations, consultez la section Authentification pass-through au domaine avec Kerberos.
- Yes : indique que le moteur HDX utilisera l’authentification Kerberos. Exemple,
CitrixWorkspaceApp.exe ENABLE_KERBEROS=Yes. - No : indique que le moteur HDX n’utilisera pas l’authentification Kerberos. Exemple,
CitrixWorkspaceApp.exe ENABLE_KERBEROS=No.
En plus des propriétés ci-dessus, vous pouvez également spécifier l’URL du magasin utilisée avec l’application Citrix Workspace. Vous pouvez ajouter jusqu’à 10 magasins. Utilisez la propriété suivante pour ce faire :
STOREx="storename;http[s]://servername.domain/IISLocation/discovery;[On, Off]; [storedescription]"
Valeurs :
- x : entiers 0 à 9 utilisés pour identifier un magasin.
- storename : nom du magasin. Cette valeur doit correspondre au nom configuré sur le serveur StoreFront.
- servername.domain : nom de domaine complet du serveur hébergeant le magasin.
- IISLocation : chemin d’accès au magasin dans IIS. L’adresse URL du magasin doit correspondre à l’adresse URL du fichier de provisioning dans StoreFront. L’URL du magasin est au format suivant
/Citrix/Store/Discovery. Pour obtenir l’adresse URL, exportez un fichier de provisioning de StoreFront, ouvrez-le dans Bloc-notes et copiez l’adresse URL à partir de l’élément Address. - [On, Off] : l’option Off vous permet de mettre à disposition des magasins désactivés, ce qui laisse aux utilisateurs le choix d’y accéder ou non. Lorsque l’état du magasin n’est pas spécifié, le paramètre par défaut est On.
- descriptionmagasin : description du magasin, telle que
App Store RH.
Exemples d’installation par ligne de commande
Pour spécifier l’adresse URL du magasin Citrix Gateway :
CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
où Storename indique le nom du magasin qui doit être configuré.
Remarque :
- 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.
- Si vous configurez plusieurs magasins, placez l’URL du magasin Citrix Gateway en premier dans la liste. Seule une configuration d’URL de magasin Citrix Gateway est autorisée.
Pour installer tous les composants de façon silencieuse et spécifier deux magasins applicatifs :
CitrixWorkspaceApp.exe /silent STORE0="AppStore;https://testserver.net/Citrix/MyStore/discovery;on;HR App Store" STORE1="BackUpAppStore;https://testserver.net/Citrix/MyBackupStore/discovery;on;Backup HR App Store"
Remarque :
- Pour que l’authentification directe réussisse, il est obligatoire d’inclure
discoverydans l’URL du magasin.- L’adresse URL du magasin Citrix Gateway doit être la première entrée dans la liste des adresses URL de magasin configurées.
Désinstaller
Utilisation du programme de désinstallation Windows :
Vous pouvez désinstaller l’application Citrix Workspace pour Windows à l’aide de l’utilitaire Programmes et fonctionnalités de Windows (Ajout/Suppression de programmes).
Remarque :
Vous êtes invité à désinstaller le package Citrix HDX RTME avant de poursuivre l’installation de l’application Citrix Workspace pour Windows. Cliquez sur OK pour poursuivre la désinstallation.
À l’aide de l’interface de ligne de commande :
Vous pouvez désinstaller l’application Citrix Workspace pour Windows à partir d’une ligne de commande en tapant la commande suivante :
CitrixWorkspaceApp.exe /uninstall
Pour la désinstallation en mode silencieux de l’application Citrix Workspace pour Windows, exécutez le commutateur suivant :
CitrixWorkspaceApp.exe /silent /uninstall
Remarque :
- Les clés de registre créées par receiver.adm/receiver.adml ou receiver.admx sont conservées après la désinstallation.
- Si vous trouvez des entrées dans l’Éditeur du Registre après la désinstallation, supprimez-les manuellement.