Deploying and Licensing VNC Connect using Windows MSIs

Follow

VNC Server and VNC Viewer are available as separate MSIs, in both 32-bit and 64-bit versions.

You can remotely deploy to target Windows computers using any suitable tool, for example SCCM or Group Policy.

*You can only license VNC Server as part of the deployment process if you have a subscription that includes offline licensing. VNC Viewer does not support licensing as part of MSI deployment.

To get started:

  1. Download the MSI installers for VNC Server and/or VNC Viewer.
  2. Extract appropriate MSI(s).

Installing at the command line

You can use msiexec to install VNC Server and VNC Viewer. For example, running the following command at an Administrator Command Prompt:

msiexec /i "<VNC Server>.msi" transforms="vnc.mst" /qn

...installs VNC Server silently and without restarting, and simultaneously applies a transform to configure VNC Server, perhaps by applying an offline license or disabling automatic update checks.

It is also possible to set properties directly on the command line. For example, running the following command at an Administrator Command Prompt:

msiexec /i "<VNC Server>.msi" /qn OFFLINELICENSE=<offline-license-key>

...installs VNC Server 7.x silently and without restarting, and simultaneously applies the offline license key to VNC Server.

Creating a Group Policy Object (GPO)

You can choose to deploy VNC Server and VNC Viewer to computers, to users, or to both in the standard way for a GPO.

If you choose to deploy to users, then once VNC Server is installed on a particular computer:

  • VNC Server in User Mode is available just to those users. VNC Server in Service Mode, however, is available to any user on the computer, since it is a system-wide service.
  • The VNC Mirror Driver (Windows 8 and earlier only) and VNC Printer Driver components must always be deployed to computers (that is, using the Computer Configuration section of Group Policy Management Editor), since these too are system-wide services. See below for more information.

Deploying VNC Server

To deploy VNC Server, create a new GPO in the standard way, using Group Policy Management Editor. Create a new package for either users or computers and assign the appropriate versions of the VNC Server MSI to it.

When you have created the package in accordance with the instructions below, add users or computers to the GPO and link it to an appropriate Organizational Unit.

*If you need to create a transform, do so on the Modifications tab of the Properties dialog before creating the package. It is not possible to add a transform once the package has been created.

Deploying VNC Printer Driver

VNC Printer Driver is a required component for VNC Server if connected users will print to local printers. To deploy it:

  1. In Group Policy Management Editor, expand Computer Configuration > Policies > Administrative Templates > System > Driver Installation.
  2. Edit the Allow non-administrators to install drivers for these device setup classes policy setting.
  3. Choose Enabled, and click Show to add the VNC Printer Driver GUID: 4658ee7e-f050-11d1-b6bd-00c04fa372a7
  4. Expand Computer Configuration > Policies > Windows Settings > Security Settings > Local Policies > Security Options.
  5. Edit the Devices: Prevent users from installing printer drivers policy to Define this policy setting as Disabled.
  6. Edit the User Account Control: Detect application installations and prompt for elevation policy to Define this policy settingas Disabled.

*If you choose not to deploy VNC Printer Driver, you must explicitly exclude it from the installation process using a transform.

Deploying VNC Mirror Driver (Windows 8 and earlier only)

VNC Mirror Driver is an optional component that enhances the performance of VNC Server. To deploy it:

  1. In Group Policy Management Editor, expand Computer Configuration > Policies > Administrative Templates > System > Device Installation > Device Installation Restrictions.
  2. Edit the Allow installation of devices using drivers that match these device setup classes policy setting.
  3. Choose Enabled, and click Show to add the VNC Mirror Driver GUID: 4D36E968-E325-11CE-BFC1-08002BE10318

*If you choose not to deploy VNC Mirror Driver, you must explicitly exclude it from the installation process using a transform.

Deploying VNC Viewer

To deploy VNC Viewer, create a new GPO in the standard way, using Group Policy Management Editor. Create a new package for either users or computers and assign the appropriate versions of the VNC Viewer MSI to it.

When you have created the package (there are no custom instructions), add users or computers to the GPO and link it to an Organizational Unit.

Creating a transform file

VNC Server

Create a transform for VNC Server if you want to:

  • License VNC Server as part of the installation process. You can only do this if you have a subscription that includes offline licensing.
    Note, VNC Server can be licensed post-installation, either desk-side (requires user interaction and elevated privileges), or using Group Policy.
  • Omit one or both of the VNC Mirror Driver or VNC Printer Driver components.
  • Disable or enable automatic update checks. By default, VNC Server prompts the user to decide when the user interface first starts.
  • Disable or enable sending anonymous analytics to RealVNC. By default, VNC Server prompts the user to decide when the user interface first starts.

To create a transform:

  1. In Orca, open the appropriate VNC Server MSI.
  2. Select Transform > New Transform.
  3. Open the Property table.
  4. Add properties (Tables > Add row) for the actions you wish to perform:
To Property Value
License VNC Server 7.x OFFLINELICENSE <offline-license-key>
License VNC Server 6.x LICENSEKEY <license-key>
Exclude VNC Mirror Driver ADDLOCAL FeatureServer,FeaturePrinterDriver
Exclude VNC Printer Driver ADDLOCAL FeatureServer,FeatureMirrorDriver
Exclude VNC Mirror Driver and VNC Printer Driver ADDLOCAL FeatureServer
Control automatic update checks ENABLEAUTOUPDATECHECKS 0 to disable 
1 to enable
Control analytics ENABLEANALYTICS 0 to disable 
1 to enable
  1. Select Transform > Generate Transform, and save the file in a suitable location.

*For a GPO, you should save the transform in the network share containing the VNC Server MSIs, and add it to the GPO before creating the package.

Looking to set VNC Server parameters?

Do not use the Properties table detailed above to set VNC Server parameters. Please see this guide instead.

VNC Viewer

VNC Viewer does not support any properties via Transform file at this time.

Was this article helpful?
10 out of 37 found this helpful

Comments

2 comments
  • IS the MSI a quite install? Other than disabling the tray Icon, what options must be configured to keep this silent and in the background? assuming I am using enterprise and running in service mode. 

    0
    Comment actions Permalink
  • It is possible to deploy the MSI with a cloud connect license? Can we incorporate our cloud license key into the MSI or Transform file?

    3
    Comment actions Permalink

Please sign in to leave a comment.