Creating a shared device connection
What is a shared device connection?
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.
How to execute a shared device connection command
Using the installer
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"
Using the Parallels Client application
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.
Arguments
Available operations (modes)
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).
Shared device connection settings string
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.
Possible settings for different modes
Setting | Mode 1 | Mode 2 |
---|---|---|
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 |
Examples
Using the installer
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
Using the Parallels Client application
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
How to change the shared device connection via UI
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.
How to delete the shared device connection
Using the installer
msiexec.exe /qn /i RASClient.msi SHAREDDEVICE="0:"
Using the Parallels Client application
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.
Troubleshooting
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:
Message | Details |
---|---|
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 |
Last updated