This guide is to assist in configuring the Microsoft remote desktop web client. Please note that as of the writing of this article, the web client can only be installed and configured using powershell and available only on Windows Server 2016 and Windows Server 2019.

In order to setup the rd web client you will need the following:

  1. Windows Server 2016/2019
  2. Remote desktop gateway(s) server
  3. Remote desktop webapp server
  4. Wildcard SSL or multiple SSL certificates to cover the rdweb, rdgateway, rdbroker and rdsession hosts. The SSL cert will need to be in .crt or .cer format and not a .pfx. The wildcard or multiple ssl certificates must be applied to the remote desktop deployment through the servermanager for all four roles. If the deployment is not configured correctly with an ssl certificate(s) then you will receive an error when trying to log into the web client.

Start by logging into the server where the rdwebapp is installed. This is usually bundled in with the rdgateway. Once logged into the server launch powershell with administrative rights.

Once powershell is open, type in the following command to install the latest NuGet provider:

install-packageprovier -name NuGet -force

After installing the latest NuGet provider, type the following command to update the powershellget module:

install-module -name PowerShellGet -force -allowclobber

After updating the powershellget module create a variable that will reference the version installed and type in the following command to select the correct version of powershellget:

$psgver = (get-installedmodule -name powershellget).version

import-packageprovider -name PowerShellGet -force -requiredversion $psgver

After selecting the latest version of powershellget type in the following command to trust the PSGallery PSRepository:

set-psrepository -name PSGallery -installationpolicy Trusted

Import the powershellget module version 1.6.6 using the following command:

import-module -name PowerShellGet -requiredversion $psgver

After selecting the psget module, run the following command to start installing the rd web client management module:

install-module -name RDWebClientManagement -acceptlicense

After installing the rdwebclient management module run the following cmdlet to install the rdwebclient package:


After installing the rdwebclient package, it's time to import the ssl certificate, please remember that it needs to be in .cer or .crt format. The certificate can be imported using the following command:

import-rdwebclientbrokercert <path to the .cer or .crt file>

After importing the ssl run the following command to publish the rdwebclient:

publish-rdwebclientpackage -type Production -latest

There you have it, the rdwebclient has been installed on the rdwebapp server and can be accessed by going to https://fqdn/RDWeb/webclient/index.html

Did this answer your question?