To facilitate bulk deployment of RealVNC Connect v8 to the RealVNC Connect cloud, RealVNC Connect can be joined to the cloud from the command line or via a script using a cloud connectivity token.
Computers can also be added to groups using cloud connectivity tokens if you need to restrict discovery of the computer to certain members of the team.
Cloud connectivity tokens are only available with Enterprise subscriptions.
Download the MSI file from this link
Generating a cloud connectivity token
Cloud connectivity tokens are found in the Device Access -> Deployment section of your RealVNC account. To generate a new cloud connectivity token use the Generate Token button in the Cloud connectivity tokens section.
Next, select how long the token will be valid for; either one hour or indefinitely.
The token will be generated and will appear in the token column of the table.
The token can be applied either at install time (Windows only) or by using the command line/script for an existing RealVNC Server installation.
Deploying a cloud connectivity token
In the below examples, <TOKEN> should be replaced with the token you generated in the Deployment section of your RealVNC Account. Alternatively, you can download a JSON file containing your token and replace <TOKEN> with the path to the downloaded JSON file.
Install time (Windows only)
You can include a cloud connectivity token as an MSI property JOINCLOUD, for example:
msiexec /i RealVNC-Connect-8.0.0-Windows.msi /qn JOINCLOUD=<TOKEN>You can also specify which group(s) the RealVNC Server should be added to using the JOINGROUP property, and the name that the device should be given using the JOINNAME property.
When using JOINGROUP, the group must already exist in the RealVNC Connect Portal. You can specify multiple groups as a comma separated list.
For both JOINGROUP and JOINNAME, the values must be URL encoded, for example spaces become %20.
Command line
Windows (Powershell)
In an administrator / elevated command prompt run:
& "C:\Program Files\RealVNC\RealVNC Connect\rvncserver.exe" -service -joinCloud <TOKEN>Windows (Command Prompt)
In an administrator / elevated command prompt run:
"%programfiles%\RealVNC\RealVNC Connect\rvncserver.exe" -service -joinCloud <TOKEN>macOS
In Terminal:
sudo /Library/RealVNC/rvncserver -service -joinCloud <TOKEN>
RealVNC Connect will check if it is already joined to the same team that the cloud connectivity token belongs to. If the team does not match, RealVNC Connect will use the cloud connectivity token to join the new team.
To force the token to be used, add the -rejoin option to the -joinCloud command, e.g.
"%programfiles%\RealVNC\RealVNC Connect\rvncserver.exe" -service -joinCloud <TOKEN> -rejoinAdditional Options
Adding a computer to a group
To add a computer to a group using a token the option -joinGroup <GROUP> must be added to the end of the joinCloud command.
You need to replace <GROUP> with the name of the group the computer is to be added to. The group must exist in the RealVNC Connect Portal before it can be used by -joinGroup.
You can also specify that RealVNC Connect should be added to multiple groups, by adding -joinGroup <GROUP> for each group you want to add RealVNC Connect to.
Changing the name RealVNC Server uses when joining the cloud
RealVNC Connect will use the computer's hostname when joining the cloud by default. To use a different name the option -joinName <NAME> must be added to the end of the joinCloud command.
You need to replace <NAME> with the name that you would like to use for the computer.
Comments
Article is closed for comments.