Installer et désinstaller

Vous pouvez installer l’application Citrix Workspace à partir de l’un des emplacements suivants :

  • Téléchargement du 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 et 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.

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 :

Les administrateurs ne peuvent pas installer l’application Citrix Workspace si une instance installée par l’utilisateur est présente sur le système. Nous vous recommandons de désinstaller toutes les instances installées par l’utilisateur avant d’installer l’application Citrix Workspace en tant qu’administrateur.

Utilisation d’un programme d’installation Windows

Vous pouvez installer l’application Citrix Workspace pour Windows en exécutant manuellement le package d’installation CitrixWorkspaceApp.exe à l’aide des méthodes suivantes :

  • Support d’installation
  • Partage réseau
  • Explorateur Windows
  • Interface de ligne de commande

Par défaut, les journaux du programme d’installation se trouvent sur %temp%\CTXReceiverInstallLogs*.logs.

  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 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 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 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 qu’après le redémarrage de la machine.
  • /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. Le commutateur /rcu 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 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. Utilisez ce commutateur 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.
  • Disabled (Désactivé) : les mises à jour automatiques sont désactivées. 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 les notifications 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 les notifications 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 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. 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 recevez les mises à jour pendant la période de mise à disposition configurée par Citrix. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Auto.
  • Fast (Rapide) : vous recevez les mises à jour au début de la période de mise à disposition. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Fast.
  • Medium (Moyen) : vous recevez les mises à jour au milieu de la période de mise à disposition. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Medium.
  • Slow (Lent) : vous recevez les mises à jour à la fin de la période de mise à disposition. Par exemple, CitrixWorkspaceApp.exe /AURolloutPriority=Slow.

/includeappprotection

Fournit une sécurité renforcée lors de l’utilisation de Citrix Virtual Apps and Desktops en protégeant les clients contre les programmes malveillants d’enregistrement de frappe et de capture d’écran.

  • CitrixWorkspaceApp.exe /includeappprotection

Consultez Protection des applications pour de plus amples informations.

/InstallEmbeddedBrowse

Exclut les fichiers binaires du navigateur Citrix intégré. Exécutez le commutateur /InstallEmbeddedBrowser=N pour interrompre la fonctionnalité de navigateur intégré.

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 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 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 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 Single Sign-On 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 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 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.
  • 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.
  • Dans une configuration multi-magasins, l’URL du magasin Citrix Gateway doit figurer en premier dans la liste. Seules 2 configurations d’URL de magasin Citrix Gateway sont autorisées.

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 à l’aide de l’utilitaire Programmes et fonctionnalités de Windows (Ajouter ou supprimer des programmes).

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.

Utiliser 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

Pour la désinstallation en mode silencieux de l’application Citrix Workspace, 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.