This article covers the supported installation options and registry keys for the Workspot Windows Client.
Installation Options
The Windows Client is distributed as an MSI files and is installed with Microsoft’s standard msiexec utility.
MSI Command Line Options
Msiexec Syntax
Basic msiexec command format
msiexec /option required_parameters optional_parameters
Install a product
msiexec /i productname.msi optional_parameters
Install or configure a product
msiexec /a productname.msi optional_parameters
Administrative installation over the network
msiexec /j[u|m] productname.msi optional_parameters
where u = install for current user, m=all users
Uninstall
msiexec /x productname.msi product_code
Client Installation Example
msiexec /i WorkspotClientSetup64.msi mode=workspot subdomain=Workspot /qn /log=c:\Temp\Client.log
/i Installation
mode=workspot Normal mode
/q Quiet mode
/log Log file location
Workspot Options
Unlike msiexec options, Workspot options do not start with a “/” character.
Mode
mode=workspot (default). The Workspot Client is run in Workspot Mode, which allows only one Workspot user per Windows user profile. To share a Windows device between multiple users in Workspot mode, each user must log on to Windows using a different user profile.
mode=kiosk. the Workspot Client is run in Kiosk Mode, allowing the same Client instance to be shared among users without signing in as a different user on the local Windows device. In this mode, users enter their Workspot credentials each time: there is no default Client user. If “kiosk” is specified, the subdomain option must also be used. See Windows Client: Kiosk Mode.
Subdomain
Subdomain=string. Used with Kiosk Mode, where it is mandatory or Workspot Mode, where it is optional but recommended. The subdomain option is the same as the “Customer Identifier” in “Control > Setup > Configuration > Access."
Example: msiexec -i WorkspotClientSetup64.msi mode=Workspot subdomain=examplecorp
Sign Out User When Last Desktop/App Closes
AutoLogout=onappsclosed. Kiosk mode only. If set, the Client user is signed out when the user closes their last open desktop or application. This leaves the Client ready for the next user.
Cache Last Username
CacheLastUser=true. Kiosk mode only. Remembers the most recent username and uses it as the default for the kiosk mode login dialog.
Install for All Users
allusers=1. Install the Workspot Client in the Program Files directory for all users. If this option is not selected (default), the application will be installed in the current user's folder.
When using this option, the msiexec command must be run with elevated permissions
Run on All Monitors
RdpInitialMultiMon=true. Sets the "Use all monitors for Remote Desktop/App" when the Client starts. This is most useful for Kiosk mode, where this setting is not persistent when set by the user.
Registry Keys
These registry keys are supported on Windows Client devices. Most duplicate settings in Control’s Protocol Settings, which are present in both Security Policies and Protocol Policies.
Enable Remote Audio
Key: HKEY_CURRENT_USER\Software\Workspot\Client\PersistentSettings\rdp
String Value: “AudioMode”
Data:
0: Play sounds on the Client device (default).
1: Play sounds on the remote device. This disables the RDP virtual audio device but is needed if you use RemoteFX audio redireciton.
2: Do not play sounds.
Enable USB Hardware Token
Key: HKEY_CURRENT_USER\Software\Workspot\Client\PersistentSettings\rdp
String Value: “RedirectSmartcards”
Default: Undefined.
Data:
1 : Redirect smartcard requests on Workspot Desktop/App to Client device.
Connection Type (Connection Speed)
Key: HKEY_CURRENT_USER\Software\Workspot\Client\PersistentSettings\rdp
String Value: “ConnectionType”
Data:
0 - Default (automatic).
1 - Modem (56 Kbps).
2 - Low-speed broadband (256 Kbps – 2 Mbps).
3 - Satellite (2Mbps – 16 Mbps with high latency).
4 - High-speed broadband (2Mbps – 10 Mbps).
5 - WAN (10 Mbps or higher with high latency).
6 - LAN (10 Mbps or higher).
7 – Automatic
Printer Redirection
Key: HKEY_CURRENT_USER\Software\Workspot\Client\PersistentSettings\rdp
String Value: “RedirectPrinters”
Data:
0 – The printers on the local computer are not available to the remote session.
1 – (Default). The printers on the local computer are available in the remote session if allowed by Control.
Auto Reconnect
Key: HKEY_CURRENT_USER\Software\Workspot\Client\PersistentSettings\rdp
String Value: “EnableAutoReconnect”
Data:
0: The Client doesn't automatically try to reconnect.
1: (Default.) The Client automatically tries to reconnect after an unexpected connection drop if allowed by Control.
Redirect Clipboard
Key: HKEY_CURRENT_USER\Software\Workspot\Client\PersistentSettings\rdp
String Value: “RedirectClipboard”
Data:
0 – Do not redirect the clipboard.
1 – (Default). Redirect the clipboard if allowed by Control.