Citrix Workspace app is the new universal app for all workspace services, that will encompass all Citrix clients and app capabilities over time.

Under certain circumstances, uninstalling older versions of Receiver for Windows may leave some files behind on the computer and in the registry.This article can also be used as reference to completely clean a system after uninstalling a legacy ICA Client or Citrix Online Plug-in version.
Note: If you plan to install a currently supported version of Receiver for Windows on the system (version 4.4 or later) then there is no need to perform these manual steps or run the clean-up utility. As per article CTX136410, Receiver for Windows 4.4 and later no longer require the separate Clean-Up Utility before installing or upgrading over a previously installed version of Receiver for Windows.

Instructions

After uninstalling Receiver and restarting the system, the following steps guide to remove any unnecessary files manually that might have been left on the client system.

It is important to remember that certain items mentioned in the following section might not exist on your system depending on the Receiver package used for the installation and how the package was deployed, for example per-machine against per-user installation.
More information on this is available in the Receiver and Plug-ins section of the Citrix eDocs for your version.

Following are the steps for cleaning up the file system:

1. On the system in use, show all hidden system files and folders (Explorer’s Tools > Folder Options menu item).

2. In the %userprofile%AppData folder

   • Delete the ICAClient folder if it exists.

   • If the Program Neighborhood Agent was present on the system, the following folder might also exist and should be deleted:
     CitrixPNAgent

   • For more recent Citrix Receiver releases, remove the following folders in AppData if they exist:

     • CitrixReceiver
     • CitrixAuthManager
     • CitrixSelfService

   • On Windows 7, the files and folders mentioned in the preceding must be deleted in both of the following locations:

     • AppDataLocal
     • AppDataRoaming

3. Repeat everything mentioned in preceding Step 2 for the C:UsersDefault folder as well (C:Documents and SettingsDefault User on Windows XP).

4. If they exist, ensure the following folders are removed from the directory in which the Receiver was installed. For example, the default install directory is %programfiles%Citrix (%programfiles(x86)%Citrix on 64-bit systems).

   • %programfiles%CitrixICA Client
   • %programfiles%CitrixAuthManager
   • %programfiles%CitrixSelfServicePlugin

Complete the following steps to clean up the system registry:
Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.

1. Using Registry Editor, navigate to the HKEY_CLASSES_ROOT key and delete the following keys if they exist:

   • Citrix.ICAClient* (delete all instances that exist – such as Citrix.ICAClient.2 or Citrix.ICAClient.2.1)
   • Citrix.ICAClientProp* (delete all instances – such as Citrix.ICAClientProp.2 or Citrix.ICAClientProp.2.1 might exist)
   • ica
   • In the CLSID key, delete any keys whose names begin with 238F
   • InstallerUpgradeCodes9B123F490B54521479D0EDD389BCACC1
   • MimeDatabaseContent Typeapplication/x-ica
   • Wfica
   • WinFrameICA
   • ICA Client
2. Navigate to HKEY_CURRENT_USER and delete the following in SOFTWARECitrix if they exist:
   • ICA Client
   • PNAgent
   • Dazzle
   • PrinterProperties
   • Receiver
   • XenDesktopDesktopViewer

3. Navigate to HKEY_LOCAL_MACHINESOFTWARE and delete the following keys if they exist (these keys are located in HKEY_LOCAL_MACHINESOFTWAREWow6432Node on 64-bit systems):

   • CitrixAuthManager
   • CitrixCitrixCAB
   • CitrixDazzle
   • CitrixICA Client
   • CitrixReceiverInside
   • CitrixPNAgent
   • CitrixPluginPackagesXenAppSuite
   • CitrixXenDesktopDesktopViewer
   • In CitrixInstall, delete the following keys if they exist:
     • {94F321B9-45B0-4125-970D-DE3D98CBCA1C}
     • ICA Client
     • PNAgent
     • DesktopViewer
     • ReceiverInsideForOnline
     • MUI
   • Depending on the Receiver package installed, delete one of the following keys in MicrosoftWindowsCurrentVersionUninstall if they exist:
     • CitrixOnlinePluginFull
     • CitrixOnlinePluginPackWeb

4. After uninstalling the Receiver software, any custom Receiver-side registry keys that icaclient.adm created remain in the registry as well. If you reinstall Receiver, these policies might be enforced possibly causing unexpected behavior. If you want to remove these customizations as well, delete the following ICA Client keys:

   • HKEY_LOCAL_MACHINESoftwarePoliciesCitrixICA Client
   • HKEY_CURRENT_USERSoftwarePoliciesCitrixICA Client
   • On 64-bit systems, ensure that the HKEY_LOCAL_MACHINESoftwareWow6432NodePoliciesCitrixICA Client key does not exist either.

5. For each user’s registry hive in HKEY_USERS, delete the following keys in SOFTWARECitrix if they exist (example HKEY_USERSS-1-5-18SoftwareCitrix):

   • ICA Client
   • Dazzle
   • Receiver
   • PrinterProperties
   • PNAgent
   • Program Neighborhood Agent

6. Repeat everything in Step 5 in the key: HKEY_USERS.DEFAULTSoftwareCitrix
   

Additional Resources

The number of items, their locations and names mentioned in this article might change in subsequent releases of the Receiver for Windows.

CTX121917 - How to Remove Legacy ICA Clients for Windows Using MSI or EXE Command-line Parameters

Disclaimer

Citrix Cleanup Utility

With the current version of Citrix Receiver for Windows at the time of this writing being 4.5, I will talk about some of the command line advanced command line install options available which allow you to be more precise and customisable with your Citrix Receiver installs.

The Receiver installer self-extracts to the user’s temp directory before install and roughly requires 80MB of free space in the %temp% directory.

To install Receiver via Command Line, firstly change the command prompt directory to the location storing your CitrixReceiver.exe file. Typing CitrixReceiver.exe ? or /help in to command prompt gives the following output:

The switches are explained briefly below:

• /help – Displays help on using the command line to install Citrix Receiver including the switches involved
• /uninstall – Removes any existing installation of Citrix Receiver from the machine if found
• /silent – Silently installs Citrix Receiver with no graphical output shown to the end-user
• /noreboot – Prevents any machine reboots or reboot prompts during installation
• /preview – Displays a preview of changes without altering the machine
• /extract (folder) – Extracts self-extracting package to an existing folder essentially extracting each MSI file from the .exe so you can separately install components i.e. SSON, USB Redirection, HDX Flash Redirection
• EnableCEIP=true/false – Enables or Disables the CEIP.
• /includeSSON – Installs the single sign-on component for domain pass through logon. The related option ENABLE_SSON is enabled when /includeSSON is on the command line. Note that you can tick to include/exclude install of the SSON component when running the graphical installation of Receiver. If you use the ADDLOCAL= option to specify which features to install and you want to use SSON you must specify the SSON value.
  

Note that to enable pass-through authentication you must install Receiver on a Windows device with Local Administrator rights via command line with the /includeSSON switch or via the GUI by ticking the option to include SSON. Furthermore you must configure Group Policy on the client device editing the Administrative Templates -> Classic Administrative Templates (ADM) -> Citrix Components -> Citrix Receiver -> User Authentication -> Local username and password object, enabling this object and selecting Enable pass-through authentication.

There are other options and switches available such as:

• /installdir – Specify which directory you want to install Citrix Receiver into. The default location is C:Program FilesCitrixReceiver. If you use this switch you must install RIInstaller.msi from the installation directory you specified and all other .msi files in the installation directory
• /client_name=ClientName – Where ClientName is used to identify the user device. The default value is %computername% which will use the client devices computer name as it is
• /EnableTracing={true|false} – Enabled by default. Enables or disables the always-on tracing feature which collects critical logs arround connection time to help troubleshoot intermittent connectivity issues.
• /enable_dynamic_client_name={Yes|No} – This switch allows the client name to be the same as the computer name. If the computer name changes due to an administrator renaming the device, the client name changes to match. Default is Yes however you can turn this off by choosing No and specifying a value for the client_name property
• /addlocal=feature – Installs one or more of the specified components. These components are the ones you would find had you extracted the .EXE contents with the CitrixReceiver.exe /extract command. The components are:
  • ReceiverInside – Installs the Receiver experience (required)
  • ICA_Client – Installs the standard Receiver (required)
  • SSON – Single sign-on
  • AM – Authentication Manager
  • USB – Installs USB support
  • DesktopViewer – Installs Desktop Viewer (for viewing of XenDesktop/XenApp Desktop)
  • SELFSERVICE – Installs the self-service plugin, which allows users to access virtual desktops and applications from the Receiver window or from a command line. If this is not installed, users must access their applications and desktops via the web (Receiver for Web)
  • Flash – Installs HDX media stream for Flash
  • Vd3d – Enables the Windows Aero Experience for operating systems that support it and have it enabled

Note that the ReceiverInside and ICA_Client are mandatory components and must be installed. Also note that these component names are case-sensitive so must be typed as displayed above.

• /enable_kerberos={Yes|No} – The default value is no. Specifies whether the HDX engine should use Kerberos authentication. This only applies when single sign-on (pass through) authentication is enabled. When Receiver uses Kerberos, Kerberos authenticates without passwords for Receiver. Receiver supports Kerberos domain pass-through authentication for deployments that use smart cards. As this method authenticates without passwords, this can prevent Trojan horse style attacks on the user device as no passwords exist to be gained
• /enableprelaunch={False|True} – The default value is false. Prelaunch is supported with StoreFront 2.0 and above. Prelaunch works when a user logs on to Receiver and can reduce application launch times during high traffic periods
• /startmenudir=Textstring – Shortcuts to subscribed applications by default appear under Start Menu -> All Programs however you can organise them under a sub-folder such as Start Menu -> All Programs -> Citrix Apps. To do this you would include STARTMENUDIR=”Citrix App” in your command line install. Users can change or move the folder at any time. It is also possible to configure this via Registry. Note that if the destination folder has a space DO NOT use a trailing i.e. STARTMENUDIR=”Citrix App Folder”. Instead use STARTMENUDIR=”Citrix App Folder” and use quotation marks. If the folder does not have spaces then STARTMENUDIR=CitrixAppFolder is fine without quotations.
• /desktopdir=Textstring – Brings all shortcuts in to a single folder. When using this option be sure to set the PutShortcutsOnDesktop key to True. This can be set via the Group Policy using receiver.admx.

• STOREx=”storename;http[s]://servername.domain/IISLocation/discovery;[On|Off];[StoreDescription]”
  • Storename – This must match the Citrix Store name configured on the StoreFront server
  • Servername.domain – The FQDN of the server(s) hosting the store, or load balanced URL
  • IISLocation – The path to the store within IIS
  • On|Off – This is an optional setting. The default option is On. If set to on, this enables you to deliver disabled stores. If off, the store will be unchecked and has to be manually checked in Citrix Receiver under Accounts to be able to deliver resources.
  • Storedescription – An optional description of the store, such as HR App Store

Note that is important to include /discovery in the store URL for successful pass-through authentication

Example command: STORE1=”CITRIX;https://storefront.domain.com/citrix/citrixstore/discovery;Off;ProductionStore”

• /ALLOWADDSTORE=N/S/A – N – Prevents users from adding or removing stores
  • S = Allows users to only add secure stores (HTTPS)
  • A = Allows users to add and remove both secure and non-secure stores (HTTP)
• /allow_clienthostedappsurl=1 – Enables the URL redirection feature on user devices. Local App Access seamlessly integrates users’ locally installed Windows applications in to a hosted desktop environment which eliminates the need to double-hop or change from one computer to another or minimize the Desktop Viewer box.

Finally, here is an example Citrix Receiver install command:

CitrixReceiver.exe /silent /includeSSON /STARTMENUDIR=CitrixApps

Citrix Receiver Cleanup Utility For Windows 98

/ADDLOCAL=ReceiverInside,ICA_Client,SSON,AM,DesktopViewer,SELFSERVICE,FLash

/store1=”CITRIX;https://storefront.domain.com/citrix/citrixstore/discovery;Off;ProductionStore”

Citrix Receiver Clean Up Utility Tool

Citrix Receiver 4.8+ Auto-Update

A couple of new switches exist to control the behaviour of the auto-update feature.

• /AutoUpdateCheck – Configure auto-update to be on, off or manual. Values accepted are AUTO, MANUAL and DISABLED.
• /AutoUpdateStream – Control if auto-updates are for LTSR versions only or Current Release versions. Values accepted are LTSR or Current.
• /DeferUpdateCount – Allows you to specify the number of times you can defer an update notification. Values accepted are -1 to 30. -1 means the user can defer any number of times.
• /AURolloutPriority – Specify the speed of which a rollout of an upgrade will be performed. Values accepted are Auto, Fast, Medum and Slow.

More info: https://www.jgspiers.com/citrix-receiver-windows-auto-update/

Citrix Receiver 4.10+ Advanced Preferences

A couple of new switches exist to control the Advanced Preferences menu.

• /DisablSetting – Values accepted are:
  • 0 – Set this value if you want both Application Display and Reconnect Options to be displayed in the Settions Option withn Advanced Preferences.
  • 1 – Set this value if you want the Settings Option within Advanced Preferences to only display the Reconnect Options tab.
  • 2 – Set this value if you want the Settings Option within Advanced Preferences to only display the Application Display tab.
  • 3 – Hides the Settings Option within Advanced Preferences.