Skip to main content

July 16, 2026

Using the Omnissa Access Desktop Command-Line Application

The Omnissa Access Desktop application includes a command-line application, hws-desktop-ctrl.exe, that you can use to perform operations related to using ThinApp packages on the user's Windows system.

The installation process for the Omnissa Access Desktop application installs hws-desktop-ctrl.exe in the HorizonThinApp folder in the Windows directory location where the Omnissa Access Desktop application is installed.

To use the hws-desktop-ctrl.exe application to perform one of its supported commands, use the following format.

hws-desktop-ctrl.exe command options
CommandDescription
hws-desktop-ctrl.exe recheckThis command immediately does an entitlement check of the ThinApp packages that are associated with the user account that is logged into the Omnissa Access Desktop application. Any newly entitled or updated ThinApp packages are synced.
hws-desktop-ctrl.exe set InstallMode=install_mode This command changes the ThinApp deployment mode used for ThinApp packages on this Windows system. Because this command changes the registry keys associated with the ThinApp deployment mode, only administrators with the appropriate registry permissions are able to change the install mode using this command. Available values for install_mode are:
  • CopyToLocal
  • RunFromShare
  • HttpDownload
hws-desktop-ctrl.exe authorize guid=ThinApp_GUID path=package_pathThis command verifies whether a ThinApp package can be launched. This command does not actually launch the ThinApp package. Provide the ThinApp package's GUID and the path to the package's executable file. If ThinApp download mode is used for the packages on the Windows client system, the path is relative to the local cache root folder, which is the same as the path relative to the repository root. An example is
hws-desktop-ctrl.exe authorize guid= 436E1D7D-552C-4F70-8197-DB1B05D30394 path="FileZilla Client 3.3.2/FileZilla.exe"
You can see the ThinApp package's GUID, application path, and executable file name on its resources page in the Omnissa Access console.
hws-desktop-ctrl.exe quitThis command tells the Omnissa Access Desktop application to exit cleanly.
hws-desktop-ctrl.exe launch app=package_path url=launch_urlThis command is used to manually launch a ThinApp package, where package_path is the path to the package's executable file, and launch_url is the Omnissa Access protocol URL for that package, in the form horizon://package_path. An example is
hws-desktop-ctrl.exe launch app="FileZilla Client 3.3.2/FileZilla.exe" url="horizon://FileZilla Client 3.3.2/FileZilla.exe"
This command is not typically used by end users, who can launch their entitled ThinApp packages from the Omnissa Intelligent Hub app or portal. This command is typically used for debugging.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…