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.
  • Pour connaître les dernières informations sur les suites de chiffrement prises en charge et non prises en charge, consultez l’article du centre de connaissances CTX250104.

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). 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 :

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.

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

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 la section Authentification pass-through au domaine pour plus d’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 à 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

  • /? 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 Single Sign-On. Consultez la section Authentification pass-through au domaine pour plus d’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.

    Remarque :

    Le commutateur /rcu n’est plus pris en charge à compter de la version 1909. Pour plus d’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 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. 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. 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. 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. 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 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 Protection des applications.

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,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. 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 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é. 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 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. 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 : permet de 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 dossier 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 dossier 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 la section Temps de lancement des applications pour plus d’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. 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. 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 la section CEIP pour plus d’informations.

  • True (valeur par défaut) : choisir de participer au programme CEIP. Par exemple, CitrixWorkspaceApp.exe EnableCEIP=True.
  • False : choisir de ne pas participer au programme CEIP. 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 la section Authentification pass-through au domaine pour plus d’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 plus d’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 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 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.
  • 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 :

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