Installation


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


OR


Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -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:


Install-RDWebClientPackage


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:


Install-RDWebClientPackage


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


MS URL: https://docs.microsoft.com/en-us/windows-server/remote/remote-desktop-services/clients/remote-desktop-web-client-admin