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

SettingMode 1Mode 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:

  1. Run Parallels Client with elevated permissions (using the Run as administrator option).

  2. Right-click the shared connections and select Connection Properties.

  3. Change the settings as necessary.

  4. 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:

MessageDetails

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.

Last updated

© 2024 Parallels International GmbH. All rights reserved.