The Shared Device Connection feature allows Parallels Client to share one connection across all users using a computer.
You can define the shared connection during or after the installation of Parallels Client. The shared connection is stored on the system in the Local Machine registry hive.
When a user starts Parallels Client, it automatically makes a copy of the shared connection in the user profile with the shared settings. All the other settings are available for the user to modify unless the corresponding policies are set.
The connection can share the connectivity information only or both the connectivity information and the credentials.
An administrator can update the shared connection information or delete the shared connection.
Note: Parallels Client supports only a single shared connection.
Use the SHAREDDEVICE
argument to instruct the installer to perform a command related to the shared connection. The format is SHAREDDEVICE="mode:settingsstring"
.
You can use commands that use UI or commands that are executed silently.
Example:
msiexec.exe /qn /i RASClient.msi SHAREDDEVICE="mode:settingsstring"
You can work with the shared connection after Parallels Client is installed by using the following command:
APPServerClient.exe -shareddevice "mode:settingsstring"
Please ensure that the application is executed with elevated privileges using the Run as administrator option. This is required when storing information in the Local Machine registry hive.
The command string has the format "mode:settingsstring"
, where the settings string depends on the mode. The following modes are possible:
0
- Delete the shared connection.
1
- Create or update a shared connection with shared connection settings.
2
- Create or update a shared connection with shared connection settings and credentials (the authentication type is set to Credentials).
The settingsstring
parameter will determine how to read or write the connection settings information. You can use one of the following values:
ui
— This will open the UI and let you enter the configuration arguments. Once you press OK, the settings are stored in the Local Machine registry hive.
e.g., AppServerClient.exe -shareddevice 2:ui
export:filepath
- This will open the UI and let you enter the configuration arguments. Once you press OK, the settings are saved to the file with the provided path.
e.g., AppServerClient.exe -shareddevice 1:export:c:\test\shared.xml
import:filepath
- Settings are imported from a configuration file, preferebly created with the export command, and stored in the Local Machine registry hive.
e.g., AppServerClient.exe -shareddevice 1:import:c:\test\shared.xml
Please use the same mode that was used when exporting the settings.
Use the UI to configure a shared connection:
msiexec.exe /i cRASClient-x64.msi SHAREDDEVICE=1:ui
Use the UI to configure a shared connection and export the settings to a file. The connection is not added to the client:
msiexec.exe /i cRASClient-x64.msi SHAREDDEVICE=1:export:filepath
Use the UI to import a previously exported shared connection. Since no UI is involved, this command can be executed in silent mode:
msiexec.exe /qn /i cRASClient-x64.msi SHAREDDEVICE=1:import:filepath
Use the UI to configure a shared connection. This command requires elevated permissions (the Run as administrator option):
AppServerClient.exe -shareddevice 1:ui
Use the UI to configure a shared connection and export the setting to a file. The connection is not added to the client:
AppServerClient.exe -shareddevice 1:export:filepath
Use the UI to import a previously exported shared connection. Since no UI is involved, this command can be executed in silent mode. This command requires elevated permissions (the Run as administrator option).
AppServerClient.exe -shareddevice 1:import:filepath
You can use the information in the section above to update the shared connection settings. However, there is an easier way to do so:
Run Parallels Client with elevated permissions (using the Run as administrator option).
Right-click the shared connections and select Connection Properties.
Change the settings as necessary.
Click OK.
When the shared connection settings are changed, they are automatically updated for all users. Restarting the client will immediately update the settings.
msiexec.exe /qn /i RASClient.msi SHAREDDEVICE="0:"
Use the following command line in elevated mode using the “Run as administrator” option:
APPServerClient.exe -shareddevice "0:"
When deleting a shared connection, the copy of the connection is also removed from all users' profiles. Re-starting your Parallels Client application will synch the shared connection immediately.
If you are executing a shared device command with the UI and a problem happens, you will be presented with a message explaining what the error is. If there is no UI, the same message is logged to the log file. Make sure that you check the log file of the elevated user and not the current user.
The following is a list of all possible messages that you might encounter:
Setting | Mode 1 | Mode 2 |
---|---|---|
Message | Details |
---|---|
Primary connection
yes
yes
Connection Mode
yes
yes
Port
yes
yes
Secondary Connections
yes
yes
Name
yes
yes
Authentication Type
yes
Set to Credentials
Username
no
yes
Password
no
yes
Domain
no
yes
Settings saved successfully
Success. This message is never displayed on screen.
Settings unsupported mode
This is not expected to happen and is there in case we add new modes in the future.
Settings unsupported action
This is not expected to happen and is there in case we add new actions in the future or the shared connection configuration file is tempered with.
You need elevated permissions
The process is deployed in the non-elevated mode, and the operation needs access to HKLM. Please ensure the process is executed with the Run as Administrator option.
Failed to clear information
Could not clear registry data.
You cannot run UI in quiet mode
UI and quiet mode cannot be used together. Please note that export also uses UI.
Action canceled by user
Never displayed on screen.
Failed to save settings in registry
Unlikely to happen, but this error is thrown if the registry is not available. e.g., the parent keys are not present.
Failed to read from file
The file location is not valid, or Parallels Client does not have the necessary permissions.
Shared mode does not match that stored in file
Settings are exported with a different mode than the one used to import. You must use the same mode for both operations.
Failed to export settings
The file location is not valid, or Parallels Client does not have the necessary permissions.
Invalid argument
Wrong arguments set. Please note that when invalid arguments are passed to the MSI file, the setup will still be completed normally. You can change them later by using AppServerClient.exe
.
The following Parallels Client for Windows parameters are available when launching published application and published desktop in a single client session from the command line.
In Command Prompt, go to the location were Parallels Client is installed and run the following command:
Running the above command will launch Published application with ID92, for user testerjm.
Parameters
Note
s!='primary server'
Primary Server hostname or IP address.
b!='backup server'
Secondary Server hostname or IP address.
a!='application/desktop id'
Published Application/Desktop ID.
p!='override application params'
t!='port'
Port of the Parallels RAS server connection.
u!='username'
Username for the user to connect with.
q!='password'
Password for the user.
d!='domain' ignored if user name is in UPN format
Domain name.
l!='0/1' 0 use primary server, 1 user backup server
Specify value in order to connect either to primary or backup server.
m!='connection mode' (gateway mode = 0, direct mode 1, gateway ssl mode = 2, direct ssl = 3, direct rdp=4)
Specify value for the connection mode.
o!='0/1' if set to 1 credentials are overwritten with SSO information if available
When set to 1, credentials are overwritten with SSO credentials.
i!='connection alias'
Specify a connection Alias.
c!
Always ask for credentials.
r!
Reconnect if connection is dropped .
Parameters
Note
-s filename
Write session information to a file called "filename".
-importsettings filename
Import session setting from a file called "filename".
-disconnectallsessions
Disconnects all RAS and RDP connections
-logoffallsessions
Logs off all RAS sessions and disconnects all RDP sessions
-sharedevice "mode:args"
Possible modes are:
0: Delete any shared device information. The existing shared connections will be deleted by the client when it is started.
1: Create a shared connection and shared connection information (i.e. server, port, mode, backup connections, connection mode)
2: Create a shared connection and shared connection information (i.e. server, port, mode, backup connections), and user name and password. Connection mode is assumed to be credentials.
Possible arguments are:
ui: Show the UI dialog to enter the shared connection information and credentials.
import: Import shared connection information and credentials from a file.
export: Export shared connection information and credentials to a file.
Manage one shared connection for multiple users working on the same Windows computer.
Possible combinations are:
0:
1:ui
1:import:file
1:export:file
2:ui
2:import:file
2:export:file