Blogging about Royal TS/X, Royal Server and Royal Passwords

How to install VMware.PowerCLI for the VMware Connection


Royal TS and Royal Server are supporting the basic management of virtual machines in a vCenter or ESXi installation. This implementation is based on PowerCLI, a product of VMware which you need to install upfront on the machine where Royal TS or Royal Server is running.

So far, this installation was not straight forward, since you needed to have an account on in order to download it and also find the correct/current version.


PowerCLI in the PowerShell Gallery

Starting with PowerCLI version 6.5.1 it is available in the PowerShell Gallery – finally!

Though there are some topics you need to be aware of:

  • Uninstall any previous version which were installed via an MSI installer before installing via the PowerShell Gallery
  • Check that the old installation directory is gone, usually C:\Program Files (x86)\VMware\Infrastructure\
  • Install it via
    Install-Module VMware.PowerCLI
  • If you use a regular PowerShell session, it will be installed for the current user. If you want to have it for all users (e.g. for Royal Server with its worker account) use a PowerShell session with administrative rights
  • The new path where you find the Vmware.Vim.dll is C:\Program Files\WindowsPowerShell\Modules\VimAutomation.Core\<version-number>\
  • Please be aware that the VMware Remote Console is not part of this and newer versions anymore (in previous versions this was included). So if you want to connect to the Console of your virtual machines, you need to manually install the Remote Console first. The latest version can be downloaded at

For more information see the VMware blogpost.

If Royal TS or Royal Server can not locate the VMware.Vim.dll automatically, point them manually to the new location.


VMware.PowerCLI installation via MSI

Versions before 6.5.1 needed to be downloaded first from and installed manually.
A good overview of the different versions of PowerCLI can be found here.


New Feature: VMware Connection

Since we have had support for managing Hyper-V virtual machines for quite some time, it was only logical that quite some users requested VMware support as well. So here it is!

2017-04-03 13_41_38-ESXi 6.0




Note: This feature requires Royal TS (for Windows) V4 or Royal TSX (for macOS) V3 and Royal Server V2.



Please note that our implementation is based on the VMware PowerCLI software that needs to be installed upfront (except on macOS). If you execute VMware connections over Royal Server, please install PowerCLI on the machine where Royal Server is installed. If you execute VMware connections directly from Royal TS (for Windows) you need to install it on the machine where Royal TS is running. For Royal TSX (for macOS) no additional software is required. We support all versions from 5.5 Update 2 and newer.

If you do not have it installed, you will see the following error message:

2017-04-03 11_18_41-VMware.Vim.dll Not Found

By default, VMware PowerCLI is installed at C:\Program Files (x86)\VMware\Infrastructure\PowerCLI\.

Royal TS and Royal Server try to locate it automatically. If the automatic detection fails, please specify the location manually.


For Royal TS, click on the VIEW ribbon tab and select Plugins. Select the VMware plugin and click on Settings.

2017-04-03 11_19_22-Plugin Settings

For Royal Server click on the Royal Server navigation, click on Modules, select the VMware module and click on Settings… 

2017-04-03 11_27_37-VMware Module Settings


Use Cases

Our VMware support includes the following actions:

  • List all virtual machines hosted in an ESXi or vCenter environment with Name, State, Provisioned Space, Host Memory, Guest Memory, Guest IP Address, VNC enabled and Data Center
  • Extended information for virtual machines like Host Agent Update Level, Maximum CPU and Memory Usage, Private Memory, Number of Snapshots, Tools Version
  • Management of virtual machines: Power On, Power Off, Suspend, Reset, Shutdown, Restart
  • Connect to virtual machines via Ad Hoc RDP, VMware Instance (Console), VMware Instance (VNC) or VMware Host (SSH)


Creating a VMware Connection

Creating a VMware connection is simple:

In Royal TS (for Windows) click on Add in the context menu or the Ribbon and select More… Locate the VMware connection and click Next.
In Royal TSX (for macOS) option/right-click a folder and select AddVMware.


Enter a Display Name and Computer Name (as usual, this can be a list of computers):

2017-04-03 13_28_54-Add VMware Management


The Computer Name in this case is the IP or name of the host where VMware is running. Do not enter http/https or any URL. The default port is 443 (and not 9443 as you might think)

Additionally specify the needed credentials for the ESXi or vCenter host.


You can use a Royal Server installation for the connection or use Direct Connect if possible.

2017-04-03 13_29_12-Add VMware Management

2017-04-03 13_29_23-Add VMware Management




Configure the VMware Connection

You can configure what information is shown in the virtual machine list via the Column Chooser which can be found either via the Settings icon in the toolbar (on Windows only) or by right-clicking on the column header of the virtual machine list.

2017-04-03 13_15_28-Royal TS

2017-04-03 13_16_09-Dev Environment (bp) - ESXi 6.0 - Royal TS



Managing the virtual machines

Just listing the registered virtual machines would be pretty boring so Royal TS/X enables you to change the state of them as well:

2017-04-03 13_22_32-Dev Environment (bp) style=



Connecting to virtual machines in VMware ESXi or vCenter

The following options to connect to the powered on virtual machines are available:

  • VMware Instance (Console): connects to the console of the VM. Please note that this option requires VMware Remote Console (or, alternatively VMware Fusion on the Mac) to be installed.
  • VMware Instance (VNC): If you have enabled VNC in the virtual machine, you can directly connect to it via this option (Only available on Windows)
  • VMware Host (SSH): you can directly connect to the host via SSH (Only available on Windows)



Working with ESXi / vCenter in Royal TSi (for iOS)

This works the exact same way with Royal TSi (for iOS) as well if using Royal Server:

You have the same options to work with the virtual machines on iOS:

New Features in our Chrome based Web Page Connection

With Royal TS 4.1 for Windows, we’re introducing a couple of new features for web page connections which are based on our Chrome plugin. We also updated our documentation to reflect all those changes here.

When you open the connection properties, you will notice a new settings page in the navigation area:


By default, all Chrome based web page connection tabs in Royal TS share one single engine (session) which is the same for all tabs. So if you log on to a web site and open a second connection in Royal TS to the same web site, you are already logged in because you share the same session.

Check the “Use Dedicated Engine” to let Royal TS create a dedicated/isolated engine for the web page connection tab. You may now ask yourself, what do I gain from having a dedicated engine?

Well, there are several benefits:

  • You have fine grained control over a lot of script, security and plugin related settings
  • You can specify additional plugin directories
  • You can configure the web page connection to use a proxy server
  • You can override CSS, disable the GPU or the spell checker

And the best of all, with the dedicated engine, you can have multiple tabs of Chrome browsers in Royal TS with different settings and an isolated session. This means that you can have browser tabs with different proxy configurations or you can have multiple browser tabs open to the same site/app with different credentials (sessions). Royal TS will consume more memory for each dedicated engine, so it’s wise to use the feature only when necessary.

Another very important improvement is the support for Secure Gateway as SOCKS proxy. If you are familiar with local/dynamic port forwarding, you are maybe aware that you can use an SSH based tunnel as a SOCKS5 proxy. We also made it super easy for you to configure:


On the Proxy tab, simply select “Use Secure Gateway as proxy server” and configure the Secure Gateway (your Royal Server or SSH server to handle your tunnel). Also, if you just configure the Secure Gateway, Royal TS assumes that you want to use that as your proxy server and will take care of the engine settings.

That’s it for now. Stay tuned for some more blog posts about new features in Royal TS/X.

Configuring Royal Server for high availability

Since Royal Server acts as a gateway for managing servers and tunneling secure connections it plays a vital role in the IT infrastructure.

Now a logical question is: how can I configure Royal Server for high availability?

There are a couple of options you can achieve this:

1) Loadbalancing Royal Server

If you have a hardware loadbalancer you can use it to split the load on two or more installations of Royal Server. This scenario also helps you on upgrading Royal Server installations at runtime without going offline.

Royal Server is stateless which means that you can use a classic round robin strategy with no sticky sessions required. Be aware though that the configuration of Royal Server is kept locally to the server, so you need to make sure that the installations are configured the same. Most of the configuration is pretty static and can be synched via a PowerShell script very easily. Keep in mind that the local Windows groups “Royal Server Users”, “Royal Server Gateway Users” and “Royal Server Administrators” are important for Royal Server. So its best to define these groups in your Active Directory, add the appropriate users there and then add the AD group to the local Windows group.

Additionally make sure, you install the same certificates on all Royal Server installations, otherwise Royal TS is showing a warning if the fingerprint changes (when you hit another box behind the loadbalancer) all the time.

2) Automatic failover from the client to a standby installation

If you do not have a hardware loadbalancer, you can configure Royal TS/X to automatically failover from one Royal Server to another if the first is not answering. Simply configure two Computer Names separated with a semicolon:

2017-02-02 22_20_07-Dev Environment - - Royal TS

After hitting a timeout from the first  Royal Server, Royal TS automatically tries the second, then the third and so on.

3) Manual failover from the client to a standby installation

You can always easily reconfigure your Royal Server object to use another installation when you get a problem with one installation. Use our bulk edit feature to configure this on multiple objects with one click if needed.

And what about a real cluster?

At the moment, we do not have a plan to implement a real cluster where you have nodes that know of each other.

Monitoring Royal Server

Royal Server is technically a Windows Service which can be monitored easily. If its stopped, you have a problem. Additionally since Royal Server basically is a web server, you also can check if it listenes on the configured port. By default it logs in the Windows Event Log, but you can also configure a file log and process this log in your monitoring infrastructure (e.g. Splunk).

Which licenses do I need for these installation options?

Starting from Royal Server V2 we do not license by installation anymore. With the exception of the Personal License you can have as many installations as you need in your environment (for the Site License the users that use the installations have to be in one site/office)

File Transfer and VMware Connection Types

File Transfer Connections File Transfer Connections

A feature that has been requested time and again is to be able to browse and transfer files on (S)FTP and SCP enabled devices. In the latest major releases we finally added support for this to the arsenal of Royal TS/X weapons.

Here’s a complete list of supported protocols of the new File Transfer connection type:

  • FTP
  • FTP with Implicit SSL
  • FTP with Explicit TLS/SSL
  • SFTP
  • SCP

In addition to plain old username/password authentication we also support key file based authentication (SFTP and SCP), certificate and fingerprint validation and multi-factor authentication.

Naturally, tightly integrated Secure Gateway (SSH Tunneling) support is included as well as Passive Mode, support for showing hidden files, resolving symlinks and large buffers for file transfers.

For the actual file transfer sessions we adopted the popular dual pane browser UI, breadcrumb controls for easily navigating between directories and a status bar that displays the current running action and allows you to cancel it at any time.

File Transfer Connection

And because we want you to get started quickly you can simply use your existing SSH connections to create ad hoc file transfer connections (Connect with Options – Connect using SFTP/SCP).

While our file transfer connection might not yet be ready to completely replace dedicated file transfer applications, we’re constantly improving it and have lots of additional features in the pipeline. If you would like to suggest a specific feature or just have general feedback, feel free to get in touch with us via our support portal.


VMware Connections VMware Connections

Many users are already enjoying the Hyper-V management capabilities in Royal TS/X. Now we provide a similar management connection for VMware to connect to your ESXi and vSphere environments.

VMware Connection

Here is a list of features our VMware integration offers:

  • Detailed Information about the VM is provided (Provisioned and Used Space, Used Memory, CPU data, Uptime, all IP addresses, datastore paths, etc.)
  • You can Power On, Power Off, Suspend, Shutdown, Restart and Reset VMs
  • You can quickly connect to VMs via Console or VNC and to the Host via SSH
  • Shutdown Guest and Restart Guest are supported (if VMware tools are installed in the Guest VM)
  • On Windows, the integration is based on PowerCLI and works from 5.5. r2 up to 6.5 installations
  • No additional software is required on macOS

The VMware management module is available for Royal TS/X directly (no Royal Server needed) and for Royal Server.

There are tons of additional features when it comes to VMware integration and we are interested to hear your opinions. Please contact us via our support portal if you want to see additional functionality integrated in Royal TS/X and Royal Server.