Installation et désinstallation

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

Vous pouvez installer le package en :

• Exécutant un assistant d’installation interactif basé sur Windows.

Ou

• Saisissant 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. Pour plus d’informations sur l’installation de l’application Citrix Workspace à l’aide d’une interface de ligne de commande, consultez Utilisation des paramètres de ligne de commande.

Remarque :

• Vérifiez que vous avez installé toutes les configurations système requises, comme mentionné dans la section Configuration système requise.

• Utilisez la commande CitrixWorkspaceApp.exe /CleanInstall lors de la mise à niveau vers une version plus récente de l’application Citrix Workspace.

• Pour les rétrogradations, Citrix recommande de désinstaller la version existante, puis d’installer la version souhaitée.

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

Les utilisateurs et les administrateurs peuvent installer l’application Citrix Workspace. Les privilèges d’administrateur ne sont requis que lors de l’utilisation de l’authentification pass-through, de l’authentification unique, de la protection des applications et du plug-in VDI Microsoft Teams avec l’application Citrix Workspace pour Windows.

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

Remarque :

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

• Commande pour nettoyer et installer l’application Citrix Workspace

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

Par exemple :

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

Remarque :

La différence entre les commandes forceinstall et cleaninstall est que forceinstall s’exécute en cas de mise à niveau de version non prise en charge ou de toute défaillance, tandis que cleaninstall nettoie toujours avant d’effectuer l’action requise, qu’il s’agisse d’une installation ou d’une mise à niveau.

Processus d’installation amélioré pour l’application Citrix Workspace™ avec protection des applications

Auparavant, lorsque la protection des applications était activée, le commutateur /cleanInstall n’était pas pris en charge, et l’utilisateur devait désinstaller manuellement et redémarrer la machine avant de retenter l’installation. À partir de la version 2503, lorsque la protection des applications est activée et que la commande /CleanInstall est exécutée, l’application Citrix Workspace se désinstalle automatiquement, redémarre la machine en fonction de la sélection de l’utilisateur et réinstalle l’application pendant le redémarrage. Le message suivant apparaît pendant le processus :

  -  ![Installation réussie](/en-us/citrix-workspace-app-for-windows/media/installation-successful.png)

• Si l’utilisateur clique sur Redémarrer, l’application Citrix Workspace se réinstalle pendant le redémarrage.

• Si l’utilisateur clique sur Annuler, l’application Citrix Workspace sera installée lors du prochain redémarrage. Par conséquent, l’application Citrix Workspace n’est pas disponible lors de la recherche de l’application dans le système.

  • Remarque :

      -  Pour les installations silencieuses, l'application Citrix Workspace n'est disponible qu'après le prochain redémarrage initié par l'utilisateur.
      -  Si l'utilisateur retente l'installation avant le redémarrage, l'invite suivante apparaît pour redémarrer le système :
    

    

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 prérequis nécessaires à l’application Citrix Workspace et, si nécessaire, les installe automatiquement.

   

   Après l’installation des prérequis, l’écran Bienvenue dans l’installateur Citrix Workspace apparaît.

    -  1.  Cliquez sur **Continuer**. La page **Contrat de licence Citrix** apparaît.   -  1.  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.
   

2. Lors de l’installation avec des privilèges d’administrateur, vous pouvez choisir les options suivantes sur la page Modules complémentaires :

    -  Démarrer la protection des applications après l'installation   -  Activer l'authentification unique   -  Installer le plug-in VDI Microsoft Teams
    -  À partir de la version 2508 de l'application Citrix Workspace pour Windows, cette option est sélectionnée par défaut. Les utilisateurs peuvent désélectionner cette option pour empêcher l'installation du plug-in VDI Microsoft Teams.   -  Installer le plug-in VDI Zoom
    -  À partir de la version 2511 de l'application Citrix Workspace pour Windows, cette option est sélectionnée par défaut. Les utilisateurs peuvent désélectionner cette option pour empêcher l'installation du plug-in VDI Zoom.   -  Installer le plug-in VDI Cisco WebEx
   

L’installation de l’application Citrix Workspace se poursuit et se termine avec succès.

Important :

À partir de la version 2311.1 de l’application Citrix Workspace pour Windows, TrolleyExpress est remplacé par CWAInstaller-<date et heure>. Par exemple, le journal est enregistré à l’emplacement C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441.

Utilisation du Microsoft Store

1. Accédez au Microsoft Store.

• 1. Recherchez Citrix Workspace.

  

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

Remarque :

Les plug-ins tiers et les composants de gestion de plug-ins, tels que le plug-in VDI Microsoft Teams ou la gestion des plug-ins Zoom, ne sont pas pris en charge lors de l’installation de l’application Citrix Workspace via le Microsoft Store.

Installation basée sur la 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 package d’installation s’auto-extrait dans le répertoire temporaire du système avant de lancer le programme d’installation. L’espace requis inclut les fichiers programme, 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 et saisissez les éléments suivants sur une seule ligne :

• nom du fichier d’installation,
• commandes d’installation, et

• propriétés d’installation

• Les commandes et propriétés d’installation disponibles sont les suivantes :

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

Liste des paramètres de ligne de commande

Les paramètres sont classés de manière générale comme suit :

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

Paramètres courants

• /forceinstall

  Ce commutateur est efficace lors du nettoyage de toute configuration ou entrée existante de l’application Citrix Workspace dans le système. Utilisez ce commutateur lors de la mise à niveau à partir d’une version non prise en charge de l’application Citrix Workspace et lorsque l’installation ou la mise à niveau échoue.

Remarque :

Le commutateur forceinstall remplace le commutateur rcu. Le commutateur rcu est obsolète depuis la version 1909. Pour plus d’informations, consultez Obsolescence.

La différence entre les commandes forceinstall et cleaninstall est que forceinstall s’exécute en cas de mise à niveau de version non prise en charge ou de toute défaillance, tandis que cleaninstall nettoie toujours avant d’effectuer l’action requise, qu’il s’agisse d’une installation ou d’une mise à niveau.

Paramètres de mise à jour automatique

• Détecter les mises à jour disponibles

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

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

Sélectionner la version pour la mise à jour

• Commande AutoUpdateStream
• Description - Si vous avez activé la mise à jour automatique, vous pouvez choisir la version que vous souhaitez mettre à jour. Consultez Jalons du cycle de vie pour plus d’informations.

Les valeurs possibles sont les suivantes :

Différer les notifications de mise à jour

• Commande : DeferUpdateCount
• Description : Indique le nombre de fois que vous pouvez différer les notifications lorsqu’une mise à jour est disponible. Pour plus d’informations, consultez 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 livraison spécifique. Ce paramètre vous permet de contrôler le moment où vous recevez la mise à jour pendant la période de livraison.

Les valeurs possibles sont les suivantes :

• |Valeur de la commande AURolloutPriority|Description|Exemple| |—|—|—|

• Auto (par défaut)

  Vous recevez les mises à jour pendant la période de livraison telle que configurée par Citrix.

  CitrixWorkspaceApp.exe AURolloutPriority=Auto

• Fast	Vous recevez les mises à jour au début de la période de livraison.	CitrixWorkspaceApp.exe AURolloutPriority=Fast
  Medium	Vous recevez les mises à jour au milieu de la période de livraison.	CitrixWorkspaceApp.exe AURolloutPriority=Medium
  Slow	Vous recevez les mises à jour à la fin de la période de livraison.	CitrixWorkspaceApp.exe AURolloutPriority=Slow

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 :

• |Valeur de la commande ALLOWADDSTORE|Description|Exemple| |—|—|—|

• S (par défaut)

  Permet d’ajouter ou de supprimer uniquement les magasins sécurisés (configurés avec HTTPS).

  CitrixWorkspaceApp.exe ALLOWADDSTORE=S

• A

  Permet d’ajouter ou de supprimer les magasins sécurisés (HTTPS) et non sécurisés (HTTP). Non applicable si l’application Citrix Workspace est installée par utilisateur.

  CitrixWorkspaceApp.exe ALLOWADDSTORE=A

• N

  N’autorise jamais les utilisateurs à ajouter ou supprimer leur propre magasin.

  CitrixWorkspaceApp.exe ALLOWADDSTORE=N

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 de magasin à l’aide de l’installation en 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’URL du magasin Citrix Gateway :

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

Où, Storename indique le nom du magasin à configurer.

Remarque :

• L’URL du magasin Citrix Gateway configurée à l’aide de cette méthode ne prend pas en charge les sites de 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="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore"

-  STORE1="NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store"
<!--NeedCopy-->

Remarque :

Il est obligatoire d’inclure discovery dans l’URL du magasin pour une authentification pass-through réussie.

Le tableau suivant fournit la description des paramètres de l’URL du magasin :

• | Paramètre | Description | |—|—|

• Nom du magasin

  Le nom que l’utilisateur voit pour le magasin.

• URL du magasin	L’URL du magasin.
  État activé du magasin	L’état peut être activé ou désactivé.
  Description du magasin	La description que l’utilisateur voit pour le magasin.

Exemple pour StoreFront™ :

• SalesStore;https://sales.mycompany.com/Citrix/Store/discovery;On;Store pour le personnel de vente.

Paramètres d’installation

• Démarrer la protection des applications

• Commande : startAppProtection
• Description : Démarre le composant App Protection et offre une sécurité améliorée en limitant la capacité des clients à être compromis par les enregistreurs de frappe et les logiciels malveillants de capture d’écran.
• Exemple : CitrixWorkspaceApp.exe startAppProtection

Pour plus d’informations, consultez la documentation sur la protection des applications.

Remarque :

Le commutateur startAppProtection remplace le commutateur includeAppProtection. Le commutateur includeAppProtection est obsolète à partir de la version 2212. Pour plus d’informations, consultez la section Obsolescence.

Exclure les binaires de Citrix Enterprise Browser

• Commande : Exécutez la commande suivante pour exclure Citrix Enterprise Browser™

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

• Description : Exclut les binaires de Citrix Enterprise Browser.

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

• Nouvelle installation

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

• Remarque :

• À partir de la version 2511, Citrix Enterprise Browser n’est plus pris en charge dans l’application Citrix Workspace pour Windows. Si nécessaire, les utilisateurs et les administrateurs peuvent installer Citrix Enterprise Browser séparément en le téléchargeant directement depuis la page de téléchargements de Citrix dans la section Citrix Enterprise Browser.

Exclure le client EPA de l’installation automatique

• Commande : CitrixWorkspaceApp.exe InstallEPAClient=N
• Description : Arrête l’installation automatique du client EPA.
• Par exemple, en utilisant la commande suivante

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

Vous pouvez exclure l’EPA dans les cas suivants :

• Nouvelle installation
• Mise à niveau à partir d’une version qui n’inclut pas l’EPA.

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 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 des composants spécifiques

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

Remarque :

Lors de la mise à niveau de l’application Citrix Workspace, le programme d’installation n’honore pas les commandes d’exclusion (telles que BCR_Client) pour les composants déjà présents dans la version de base. Pour supprimer un composant pendant un processus de mise à niveau, désinstallez complètement l’application Citrix Workspace existante avant d’installer la nouvelle version avec les paramètres d’exclusion requis.

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

• ICA_Client

  Moteur HDX™

  Ce composant gère le fichier ICA ou le processus de lancement de session.

• BCR_Client	Client BCR	Plug-in pour gérer la redirection de contenu de navigateur.
  USB	Client USB	Plug-in pour gérer la redirection USB.
  DesktopViewer	Client Desktop Viewer	Framework d’interface utilisateur pour le bureau virtuel.
  AM	AuthManager	Gestionnaire d’authentification - Autorise l’utilisateur à l’application Citrix Workspace.
  SSON	SSON	Composant d’authentification unique – Prend en charge l’authentification unique.
  SELFSERVICE	Libre-service	Plug-in pour l’application Citrix Workspace pour un lancement natif.
  WebHelper	Assistant Web	Assistant pour connecter le navigateur à l’application Workspace native.
  CitrixEnterpriseBrowser	Navigateur	Navigateur natif qui permet aux utilisateurs d’ouvrir des applications Web ou SaaS depuis l’application Citrix Workspace de manière sécurisée.

Par exemple, en utilisant 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 :

• À partir de la version 2212, la fonctionnalité de protection des applications est installée par défaut. Par conséquent, AppProtection n’est plus une option valide pour la commande ADDLOCAL.

Limitation :

Lorsque vous installez l’application Citrix Workspace à l’aide des paramètres ADDLOCAL, les fenêtres Périphériques et Préférences peuvent ne pas répondre depuis le Centre de connexion. Ce problème se produit uniquement lorsque vous installez l’application Citrix Workspace sans le paramètre DesktopViewer. Pour contourner ce problème, incluez également le paramètre DesktopViewer. [HDX-67173]

Installer des plug-ins tiers

• L’application Citrix Workspace prend en charge les plug-ins tiers et les composants de gestion de plug-ins suivants :

Plug-in Microsoft Teams VDI

À partir de l’application Citrix Workspace pour Windows version 2508, ce composant est installé par défaut.

Nouvelles installations et mises à jour manuelles

• L’option d’installation est sélectionnée par défaut.
• Les utilisateurs peuvent désélectionner l’option selon leurs préférences.

Mises à jour automatiques

• Le composant est installé par défaut s’il n’est pas déjà présent.
• Les installations existantes sont mises à niveau lorsqu’une version plus récente est disponible.

Pour empêcher l’installation du plug-in VDI Microsoft Teams, les administrateurs peuvent utiliser la ligne de commande suivante :

• CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=N

À partir de la version 2508 de l’application Citrix Workspace pour Windows, lors des mises à niveau, l’application mémorise la sélection précédente. Pour installer le plug-in VDI Microsoft Teams lors d’une mise à niveau (s’il était précédemment désélectionné), les administrateurs peuvent utiliser la ligne de commande suivante :

CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=Y

Gestion du plug-in VDI Zoom

• À partir de la version 2511 de l’application Citrix Workspace pour Windows, ce composant est installé par défaut.

Nouvelles installations et mises à jour manuelles

• L’option d’installation est sélectionnée par défaut.

• Les utilisateurs peuvent désélectionner l’option selon leurs préférences.

• Mises à jour automatiques

• Le composant est installé par défaut s’il n’est pas déjà présent.

• Les installations existantes sont mises à niveau lorsqu’une version plus récente est disponible.

• Pour empêcher l’installation du plug-in VDI Zoom, les administrateurs peuvent utiliser la ligne de commande suivante :

CitrixWorkspaceapp.exe Installzoomplugin=N

Moteur d’installation du plug-in VDI WebEx

Pour installer le moteur d’installation du plug-in VDI WebEx :

Nouvelles installations et mises à jour manuelles

• L’option d’installation est désélectionnée par défaut.
• Les utilisateurs peuvent sélectionner l’option selon leurs préférences.

Mises à jour automatiques

• Le composant n’est pas installé par défaut.
• Les installations existantes sont mises à niveau lorsqu’elles ont été installées avec une version précédente de l’application Citrix Workspace et qu’une version plus récente du composant est disponible.

Pour installer le moteur d’installation du plug-in VDI WebEx, les administrateurs peuvent utiliser la ligne de commande suivante :

• CitrixWorkspaceapp.exe ADDONS=WebexVDIPlugin

Remarque :

• Les composants tiers sont récupérés à partir des CDN tiers respectifs plutôt que d’être inclus dans l’application Citrix Workspace. Les clients doivent s’assurer que l’accès réseau nécessaire est disponible depuis les points de terminaison pour une installation réussie des composants sur les packages de l’application Citrix Workspace en ligne et hors ligne.

• L’échec de l’installation d’un composant tiers n’a pas d’impact sur l’installation de l’application Citrix Workspace.

• Les composants défaillants peuvent être réinstallés en réexécutant le programme d’installation ou lors d’une mise à niveau.

• L’application Citrix Workspace ne gère pas la désinstallation des plug-ins tiers lors de la désinstallation de l’application Citrix Workspace.

• L’application Citrix Workspace conserve les sélections de composants lors des mises à jour. Par exemple, si le plug-in Microsoft Teams est désélectionné lors de l’installation, il ne sera pas automatiquement installé dans les versions ultérieures.

• Citrix recommande d’activer les mises à jour automatiques de l’application Citrix Workspace pour recevoir les dernières versions des composants tiers dès qu’elles sont disponibles.

• Ces plug-ins sont des logiciels tiers et ne sont ni créés, ni développés, ni gérés par Cloud Software Group. Cloud Software Group n’a aucune obligation ni responsabilité concernant les services ou logiciels tiers. En téléchargeant et/ou en utilisant un tel logiciel, VOUS RECONNAISSEZ ET ACCEPTEZ PAR LA PRÉSENTE QUE CE LOGICIEL EST FOURNI PAR CLOUD SOFTWARE GROUP « EN L’ÉTAT » SANS AUCUNE GARANTIE, SELON SA DISPONIBILITÉ, ET QUE VOTRE ACCÈS ET/OU UTILISATION DU LOGICIEL OU DE TOUT ACTIF ASSOCIÉ EST À VOS SEULS RISQUES. Vous reconnaissez être régi par les licences tierces respectives de ce logiciel.

Installer Citrix Casting™

Important :

Pour l’application Citrix Workspace version LTSR 2402 et ultérieure, Citrix Casting ne peut pas être installé même avec la commande IncludeCitrixCasting. Pour utiliser cette fonctionnalité, vous devez utiliser une version antérieure de l’application Citrix Workspace. Pour plus d’informations, consultez la page Dépréciation.

• Commande : IncludeCitrixCasting
• Description : Installe Citrix Casting lors de l’installation.

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

Paramètres d’UberAgent

• Commande : InstallUberAgent
• Description : Le module complémentaire UberAgent offre une surveillance et des diagnostics avancés pour l’application Citrix Workspace, fournissant des informations détaillées sur l’expérience utilisateur et les performances des applications. Cette intégration est disponible exclusivement sur les appareils gérés, ce qui simplifie le déploiement et réduit les frais administratifs.

Utilisation de l’installation en ligne de commande suivante :

Utilisez la commande /InstallUberAgent pour installer ou mettre à niveau le plug-in UberAgent. Utilisez la commande /InstallUberAgent /SkipUberAgentUpgrade pour installer le plug-in sans le mettre à niveau si UberAgent est déjà présent. Cette option est idéale pour les VDA ou les appareils où le déploiement d’UberAgent est géré séparément de l’application Citrix Workspace.

• Remarque :

• Ce composant peut être installé uniquement via la ligne de commande.

• Paramètres de l’agent d’enregistrement de session

• Commande : InstallSRAgent
• Description : Le module complémentaire d’enregistrement de session étend les capacités de surveillance de session directement à l’appareil de point de terminaison, offrant une supervision complète de l’activité de l’utilisateur sur diverses applications et environnements de point de terminaison. Cette intégration simplifie le déploiement et contribue à réduire la charge administrative.

Utilisation de l’installation en ligne de commande suivante :

Utilisez la commande /InstallSRAgent pour installer ou mettre à niveau l’agent d’enregistrement de session pour les appareils de point de terminaison. Utilisez la commande /InstallSRAgent /SkipSRAgentUpgrade pour installer le plug-in sans le mettre à niveau si l’agent d’enregistrement de session est déjà présent. Cette option est idéale pour les appareils où le déploiement de l’agent d’enregistrement de session est géré séparément de l’application Citrix Workspace.

Remarque :

Ce composant peut être installé uniquement via la ligne de commande.

Si vous utilisez le programme d’installation x86 de l’application Citrix Workspace, la version x64 de .NET Desktop Runtime 8.0.15 ou ultérieure (jusqu’à 8.x) est requise sur cette machine pour terminer l’installation.

• Paramètres des fonctionnalités HDX

Définir la redirection bidirectionnelle de contenu

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

Les valeurs possibles sont les suivantes :

Définir l’accès aux applications locales

• Commande : FORCE_LAA
• Description : Indique que l’application Citrix Workspace est installée avec le composant Accès aux applications locales 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 Accès aux applications locales dans la documentation Citrix Virtual Apps and Desktops.

Les valeurs possibles sont les suivantes :

Définir la fonctionnalité de redirection d’URL sur l’appareil utilisateur

• Commande : ALLOW_CLIENTHOSTEDAPPSURL
• Description : Active la fonctionnalité de redirection d’URL sur l’appareil utilisateur. Pour plus d’informations, consultez la section Accès aux applications locales dans la documentation Citrix Virtual Apps and Desktops.

Les valeurs possibles sont les suivantes :

Afficher les icônes pour les documents ou les fichiers

• Commande : LEGACYFTAICONS
• Description : Spécifie si vous souhaitez afficher les icônes pour les documents ou les fichiers qui ont une association de type de fichier avec des applications souscrites.

Les valeurs possibles sont les suivantes :

Paramètres de préférence et d’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 au 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 Temps de lancement de l’application.

Les valeurs possibles sont les suivantes :

Masquer l’option Raccourcis et Reconnexion

• Commande : DisableSetting
• Description : Masque l’option Raccourcis et Reconnexion afin qu’elle ne s’affiche pas dans la feuille Préférences avancées. Pour plus d’informations, consultez Masquer des paramètres spécifiques de la feuille Préférences avancées.

Les valeurs possibles sont les suivantes :

Activer le programme d’amélioration de l’expérience client

• Commande : EnableCEIP
• Description : Indique votre participation au programme d’amélioration de l’expérience client (CEIP). Pour plus d’informations, consultez CEIP.

Les valeurs possibles sont les suivantes :

Activer le traçage permanent

• Commande : EnableTracing
• Description : Contrôle la fonctionnalité de traçage permanent.

Les valeurs possibles sont les suivantes :

Spécifier le nom pour identifier le périphérique utilisateur

• Commande : CLIENT_NAME
• Description : Spécifie le nom utilisé pour identifier le périphérique utilisateur auprès du serveur.
• <NomClient> - Spécifie le nom utilisé pour identifier le périphérique utilisateur sur le serveur. Le nom par défaut est %COMPUTERNAME%.
• Exemple : CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%.

Définir le nom du client identique au nom de l’ordinateur

• Commande : ENABLE_DYNAMIC_CLIENT_NAME
• Description : Permet au nom du client d’être identique au nom de l’ordinateur. Lorsque vous modifiez le nom de l’ordinateur, le nom du client change également.

Les valeurs possibles sont les suivantes :

Paramètres d’authentification

Inclure l’authentification unique

• Commande : /includeSSON
• Description : Nécessite 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 de domaine pour plus d’informations.
• Exemple : CitrixWorkspaceApp.exe /includeSSON

À partir de la version 2503 de l’application Citrix Workspace pour Windows, le système installe SSON par défaut en mode dormant. Vous pouvez activer SSON après l’installation à l’aide de la stratégie d’objet de stratégie de groupe (GPO). Pour l’activer, accédez à Authentification utilisateur > Nom d’utilisateur et mot de passe locaux et cochez la case Activer l’authentification pass-through.

Remarque :

Vous devez redémarrer le système après avoir mis à jour la stratégie GPO pour que le paramètre SSON prenne effet

La commande includeSSON prend en charge uniquement les nouvelles installations de l’application Citrix Workspace.

Activer l’authentification unique

• Commande : ENABLE_SSON
• Description : Active l’authentification unique lorsque l’application Citrix Workspace est installée avec la commande /includeSSON. Pour plus d’informations, consultez Authentification pass-through de 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, une invite de désinstallation du package Citrix HDX RTME s’affiche. Cliquez sur OK pour poursuivre la désinstallation.

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

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

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

Pour une désinstallation silencieuse 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 aux GPO ; 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

Codes d’erreur

• Pour les codes d’erreur liés au programme d’installation, consultez 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 d’installation

Par défaut, les journaux d’installation se trouvent à l’emplacement suivant :

Remarque :

À partir de la version 2311.1 de l’application Citrix Workspace pour Windows, TrolleyExpress est remplacé par CWAInstaller-<date et horodatage>. Par exemple, le journal est enregistré à l’emplacement C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441.

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.
• Les applications fournies par le plug-in en libre-service, leurs icônes et leurs clés de registre.
• Les associations de types de fichiers créées par le plug-in en libre-service.
• Les fichiers mis en cache et les mots de passe enregistrés.
• Les paramètres de registre par utilisateur.
• Les installations par machine et leurs paramètres de registre.
• Les paramètres de registre 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 une réinitialisation silencieuse, utilisez la commande suivante :

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

Remarque :

Utilisez un U majuscule dans le paramètre.

La réinitialisation de l’application Citrix Workspace n’a pas d’incidence sur les éléments suivants :

• L’installation de l’application ou du plug-in Citrix Workspace.
• Les paramètres de verrouillage ICA® par machine.
• Les configurations de modèle administratif d’objet de stratégie de groupe (GPO) pour l’application Citrix Workspace.