To install the web client for the first time, follow these steps:

1. On the RD Connection Broker server, obtain the certificate used for Remote Desktop connections and export it as a .cer file. Copy the .cer file from the RD Connection Broker to the server running the RD Web role.

2. On the RD Web Access server, open an elevated PowerShell prompt.

3. On Windows Server 2016, update the PowerShellGet module since the inbox version doesn't support installing the web client management module. To update PowerShellGet, run the following cmdlet:

Install-Module -Name PowerShellGet -Force

If error, try: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12


Install-PackageProvider -Name NuGet -RequiredVersion -Force

4. Install the Remote Desktop web client management PowerShell module from the PowerShell gallery with this cmdlet:

Install-Module -Name RDWebClientManagement

5. After that, run the following cmdlet to download the latest version of the Remote Desktop web client:


6. Next, run this cmdlet with the bracketed value replaced with the path of the .cer file that you copied from the RD Broker:

Import-RDWebClientBrokerCert <.cer file path>

7. Finally, run this cmdlet to publish the Remote Desktop web client:

Publish-RDWebClientPackage -Type Production -Latest

Make sure you can access the web client at the web client URL with your server name, formatted as https://server_FQDN/RDWeb/webclient/index.html. It's important to use the server name that matches the RD Web Access public certificate in the URL (typically the server FQDN).

To Update

When a new version of the Remote Desktop web client is available, follow these steps to update the deployment with the new client:

Open an elevated PowerShell prompt on the RD Web Access server and run the following cmdlet to download the latest available version of the web client:


Optionally, you can publish the client for testing before official release by running this cmdlet:

Publish-RDWebClientPackage -Type Test -Latest

The client should appear on the test URL that corresponds to your web client URL (for example, https://server_FQDN/RDWeb/webclient-test/index.html).

Publish the client for users by running the following cmdlet:

Publish-RDWebClientPackage -Type Production -Latest