Installer et désinstaller

Vous pouvez installer l’application Citrix Workspace en téléchargeant le package d’installation CitrixWorkspaceApp.exe à partir de la page de téléchargement ou depuis la page de téléchargement de votre entreprise (si disponible). Le package peut être installé de deux façons :

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

L’application Citrix Workspace peut être installée par un utilisateur ainsi qu’un administrateur. 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.

Les installations de l’application Citrix Workspace pour Windows par un administrateur et par un utilisateur (non administrateur) présentent les différences suivantes.

  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 à partir 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.

  1. Lancez le fichier CitrixWorkspaceApp.exe et cliquez sur Démarrer.
  2. Lisez et acceptez le contrat de licence de l’utilisateur final et continuez l’installation.
  3. 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. Consultez Authentification pass-through au domaine pour de plus amples informations.
  4. 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 à l’aide 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 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 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

  • /? Ou /help : répertorie toutes les commandes et propriétés d’installation.
  • /silent : désactive les boîtes de dialogue et les invites d’installation pendant l’installation.
  • /noreboot : supprime les invites et la boîte de dialogue de redémarrage lors de 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 Workspace qu’après le redémarrage de la machine utilisateur.
  • /includeSSON : requiert une installation en tant qu’administrateur. Indique que l’application Citrix Workspace est installée avec le composant d’authentification unique. Consultez Authentification pass-through au domaine pour de plus amples informations.
  • /rcu - Ce commutateur n’est efficace que lors de la mise à niveau 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 ou plus anciens.

    Remarque :

    Le commutateur /rcu n’est plus pris en charge à compter de la version 1909. Pour de plus amples informations, consultez la section Fin de prise en charge.

  • /forceinstall - Ce commutateur est efficace lors du nettoyage de 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. Par exemple, CitrixWorkspaceApp.exe /AutoUpdateCheck=auto.
  • Manuel : vous n’êtes pas informé lorsqu’une mise à jour est disponible. Recherchez les mises à jour manuellement. Par exemple, CitrixWorkspaceApp.exe /AutoUpdateCheck=manual.
  • Désactivé : désactive les mises à jour automatiques. Par 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. Consultez Étapes du cycle de vie pour de plus amples informations.

  • LTSR : mise à jour automatique uniquement vers des mises à jour cumulatives Long Term Service Release. Par exemple, CitrixWorkspaceApp.exe /AutoUpdateStream=LTSR.
  • Current (Actuel) : mise à jour vers la dernière version de l’application Citrix Workspace. Par exemple, CitrixWorkspaceApp.exe /AutoUpdateStream=Current.

/DeferUpdateCount

Indique le nombre de fois où vous pouvez différer la notification de mise à jour lorsqu’une mise à jour est disponible. Consultez Mises à jour de Citrix Workspace pour de plus amples informations.

  • -1 (valeur par défaut) : permet de différer la notification n’importe quel nombre de fois. Par 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. Par exemple, CitrixWorkspaceApp.exe /DeferUpdateCount= 0.
  • Tout autre numéro « n » : permet de différer la notification de mise à jour un nombre « n » de fois. L’option Me rappeler plus tard s’affiche le nombre « n » de fois défini. Par 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 recevrez les mises à jour pendant la période de mise à disposition configurée par Citrix. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Auto.
  • Fast (Rapide) : vous recevrez les mises à jour au début de la période de mise à disposition. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Fast.
  • Medium (Moyen) : vous recevrez les mises à jour au milieu de la période de mise à disposition. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Medium.
  • Slow (Lent) : vous recevrez les mises à jour à la fin de la période de mise à disposition. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Slow.

INSTALLDIR

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. Par exemple, CitrixWorkspaceApp.exe INSTALLDIR=C:\Program Files\Citrix.

ADDLOCAL

Installe un ou plusieurs des composants spécifiés. Par exemple, CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SELFSERVICE,DesktopViewer,Flash,Vd3d,WebHelper,BrowserEngine, WorkspaceHub.

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 de plus amples informations, consultez la section Paramètres de stratégie Redirection bidirectionnelle du contenu dans la documentation de Citrix Virtual Apps and Desktops.

  • 0 (valeur par défaut) : indique que la redirection bidirectionnelle du contenu est désactivée. Par exemple, CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0.
  • 1 : indique que la redirection bidirectionnelle du contenu est activée. Par 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 Workspace avec des privilèges d’administrateur pour que ce composant fonctionne. Pour de plus amples informations, consultez la section Local App Access dans la documentation de Citrix Virtual Apps and Desktops.

  • 0 (valeur par défaut) : indique que le composant Local App Access n’est pas installé. Par exemple, CitrixWorkspaceApp.exe FORCE_LAA =0.
  • 1 : indique que le composant Local App Access côté client est installé. Par 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. Par 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. Par exemple, CitrixWorkspaceApp.exe LEGACYFTAICONS=True.

ALLOW_CLIENTHOSTEDAPPSURL

Active la fonctionnalité de redirection des adresses URL sur les machines utilisateur. Pour de plus amples informations, consultez la section Local App Access dans la documentation de Citrix Virtual Apps and Desktops.

  • 0 (valeur par défaut) : désactive la fonctionnalité de redirection des adresses URL sur les machines utilisateur. Par exemple, CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=0.
  • 1 : active la fonctionnalité de redirection des adresses URL sur les machines utilisateur. Par 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). Par 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. Par exemple, CitrixWorkspaceApp.exe ALLOWADDSTORE=A.
  • N : ne jamais autoriser les utilisateurs à ajouter ou supprimer leur propre magasin. Par 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). Par exemple, CitrixWorkspaceApp.exe ALLOWSAVEPWD=S.
  • N : n’autorise pas l’enregistrement du mot de passe. Par 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). Par exemple, CitrixWorkspaceApp.exe ALLOWSAVEPWD=A.

STARTMENUDIR

Spécifie le répertoire des raccourcis dans le menu Démarrer.

  • <Directory Name> : par défaut, toutes les applications apparaissent sous Démarrer > Tous les programmes. Vous pouvez spécifier le chemin d’accès relatif des raccourcis dans le dossier \Programs. Par exemple, pour placer les raccourcis sous Démarrer > Tous les programmes > Workspace, spécifiez STARTMENUDIR=\Workspace.

DESKTOPDIR

Spécifie le répertoire des raccourcis sur le Bureau.

Remarque :

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

  • <Directory Name> : vous pouvez spécifier le chemin d’accès relatif des raccourcis. Par exemple, pour placer les raccourcis sous Démarrer > Tous les programmes > Workspace, spécifiez DESKTOPDIR=\Workspace.

SELFSERVICEMODE

Contrôle l’accès à l’interface utilisateur en libre-service de l’application Workspace.

  • True : indique que l’utilisateur a accès à l’interface utilisateur en libre-service. Par exemple, CitrixWorkspaceApp.exe SELFSERVICEMODE=True.
  • False : indique que l’utilisateur n’a pas accès à l’interface utilisateur en libre-service. Par exemple, CitrixWorkspaceApp.exe SELFSERVICEMODE=False.

ENABLEPRELAUNCH

Contrôle le pré-lancement de session. Consultez Temps de lancement des applications pour de plus amples informations.

  • True : indique que le pré-lancement de session est activé. Par exemple, CitrixWorkspaceApp.exe ENABLEPRELAUNCH=True.
  • False : indique que le pré-lancement de session est désactivé. Par exemple, CitrixWorkspaceApp.exe ENABLEPRELAUNCH=False.

DisableSetting

Masque l’affichage de l’option Raccourcis et reconnexion sur la page Préférences avancées. Consultez Masquer des paramètres spécifiques sur la page Paramètres avancés pour de plus amples informations.

  • 0 (valeur par défaut) : affiche les options Raccourcis et Reconnexion sur la page Préférences avancées. Par exemple, CitrixWorkspaceApp.exe DisableSetting=0.
  • 1 : affiche uniquement l’option Reconnexion sur la page Préférences avancées. Par exemple, CitrixWorkspaceApp.exe DisableSetting=1.
  • 2 : affiche uniquement l’option Raccourcis sur la page Préférences avancées. Par exemple, CitrixWorkspaceApp.exe DisableSetting=2.
  • 3 : les options Raccourcis et Reconnexion sont masquées sur la page Préférences avancées. Par exemple, CitrixWorkspaceApp.exe DisableSetting=3.

EnableCEIP

Indique votre participation au programme d’amélioration de l’expérience utilisateur (CEIP). Consultez CEIP pour de plus amples informations.

  • True (valeur par défaut) : permet de participer au programme d’amélioration de l’expérience utilisateur (CEIP) de Citrix. Par exemple, CitrixWorkspaceApp.exe EnableCEIP=True.
  • False : permet de désactiver le programme d’amélioration de l’expérience utilisateur (CEIP) de Citrix. Par exemple, CitrixWorkspaceApp.exe EnableCEIP=False.

EnableTracing

Contrôle la fonction de suivi permanent.

  • True (valeur par défaut) : active la fonction de suivi permanent. Par exemple, CitrixWorkspaceApp.exe EnableTracing=true.
  • False : désactive la fonction de suivi permanent. Par 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%. Par 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. Par 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. Par exemple, CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No.

Paramètres d’authentification

ENABLE_SSON

Active l’authentification unique lorsque l’application Workspace est installée avec la commande /includeSSON. Consultez Authentification pass-through au domaine pour de plus amples informations.

  • Yes (valeur par défaut) : indique que l’authentification unique est activée. Par exemple, CitrixWorkspaceApp.exe /ENABLE_SSON=Yes.
  • No : indique que l’authentification unique est désactivée. Par 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 de plus amples informations, consultez la section Authentification pass-through au domaine avec Kerberos.

  • Yes : indique que le moteur HDX utilisera l’authentification Kerberos. Par exemple, CitrixWorkspaceApp.exe ENABLE_KERBEROS=Yes.
  • No : indique que le moteur HDX n’utilisera pas l’authentification Kerberos. Par exemple, CitrixWorkspaceApp.exe ENABLE_KERBEROS=No.

Outre les propriétés ci-dessus, vous pouvez également spécifier l’adresse URL du magasin utilisée avec l’application 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’adresse URL du magasin se présente sous le 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 délivrer 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.
  • storedescription : description facultative du magasin, telle que HR App Store.

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

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.
  • Lors de la configuration de plusieurs magasins, l’URL du magasin Citrix Gateway doit être la première dans la liste.

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 :

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

Désinstallation

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 demeurent dans le répertoire Software\Policies\Citrix\ICA Client sous HKEY_LOCAL_MACHINE et HKEY_LOCAL_USER après la désinstallation.
  • Si vous trouvez des entrées dans l’éditeur du Registre après la désinstallation, supprimez-les manuellement.