SOLVED: How To Customize Your RDS RDWeb Page

customized-rdsweb-login-pageIf you are running Remote Desktop Services (RDS) you likely have an /RDWeb landing page that you would like to reconfigure to make it easier for people to visit.  My RDWeb page now looks like the one on the right.

If you are interested in customizing the RDWeb page, you might be interested in our easy explanation of how to eliminate the /RDWeb portion of the rds.YourDomain.com/RDWeb and change it to just rds.YourDomain.com, HERE.

WARNING: Internet Explorer does a good job of detecting the changes when you refresh RDWeb page but Chrome does not.  Soooo, if you are testing with Chrome, make sure you flush your browser cache.


Customize the HELP Page on the RDS Login Page:

  1. customize-rdsweb-help-pageLaunch IIS
  2. Expand DEFAULT WEBSITE > RDWeb > PAGES
  3. Double click on APPLICATION SETTINGS from the middle pane
  4. Change LocalHelp to true
  5. Use Notepad to edit or replace %windir%\Web\RDWeb\Pages\en-US\rap-help.htm
    1. Note that you may want a different path than en-US if you are not using English
  6. Refresh your RDWeb login page and note that there is no need to restart IIS after this

Customize the TO PROTECT AGAINST Warning on the RDS Login Page:
rdweb-change-to-protect-against-text

  1. Use Notepad to edit or replace %windir%\Web\RDWeb\Pages\login.aspx
  2. Go to Line 43 and echange the text.  Ours now looks like:

const string L_TSWATimeoutLabel_Text = “All actions are logged off site to protect against unauthorized access. If you are unsure if you are authorized, contact Up & Running IT at 403-xxx-xxxx. Your RD Web Access session will automatically time out after a period of inactivity. If your session ends, refresh your browser and sign in again.”;


Remove HELP Link From the RDS Login Page:

Note that we think it is better to customize the help page than it is to remove it (see above), but you can if you wish.

  1. rds-rdweb-remove-helpUse Notepad to edit %windir%\web\rdweb\pages\site.xsl
    1. I would make a copy first, in case you screw it up
  2. EDIT > GOTO line 150
  3. Delete the next 8 lines (everything between the <table> and </table> tags )
  4. Save the file to the desktop then copy the file to %windir%\web\rdweb\pages\

Remove CONNECT TO A REMOTE PC Link from RDS Login Page:

  1. remove-remote-desktop-rdswebLaunch IIS
  2. Expand DEFAULT WEBSITE > RDWeb > PAGES
  3. Double click on APPLICATION SETTINGS from the middle pane
  4. Change ShowDesktops to false
  5. Restart IIS (I like using IISRESET)

Allow Users To CHANGE PASSWORD from RDS Login Page:

  1. allow-users-to-change-password-remote-desktop-rdswebLaunch IIS
  2. Expand DEFAULT WEBSITE > RDWeb > PAGES
  3. Double click on APPLICATION SETTINGS from the middle pane
  4. Change PasswordChangeEnabled to false
  5. Restart IIS (I like using IISRESET)

Change The Graphics On a Server 2016 RDWeb Login Page

A) Change the Brand Logo On The RDWeb Login Page:

Option 1:

  1. Replace %windir%\Web\RDWeb\Pages\images\logo_02.png with your graphic but make sure it is the same 48×48 pixel size

FYI, logo_01.png is the small remote desktop’ graphic in the top right beside the words RD WEB ACCESS

Option 2:

  1. rdsweb-customize-change-logoCreate a new folder named images %windir%\Web\RDWeb\Pages\en-US\images\
    1. If you are not using English, change the en-US to the appropriate folder
  2. Use Notepad to edit %windir%\web\rdweb\pages\site.xsl
    1. I would make a copy first, in case you screw it up
  3. Search for ../images/logo_02.png 
    1. on line 114 in the factory site.xsl
  4. Update the graphic name and size so it looks the the screen shot to the right

Thanks to THIS page for this one.

B) Change The Server 2016 Logo On The RDWeb Login Page:

  1. Replace %windir%\web\rdweb\pages\images\WS_h_c.png 

We suggest that at very least you delete white background of the Server 2016 logo because the default graphic looks terrible.  Also, we suggest you edit that graphic to remove the “2016” from it so that it is 1% harder for hackers to figure out what they are attacking.

C) Change The Microsoft Logo On The RDWeb Login Page:

  1. Replace %windir%\web\rdweb\pages\images\mslogo_black.png 

If you just want to remove the Microsoft Logo on the RDWeb home page, the easiest way to to this is to change the mslogo_block.png to a single pixel.  Otherwise you can screw around in the site.xsl code to find it but why bother.

D) Change The Globe Wallpaper On The RDWeb Login Page:

  1. Replace %windir%\web\rdweb\pages\images\bg_globe_01.jpg

Change The Text ‘Work Resources’ On The RDWeb Login page:

  1. Start a PowerShell as an Administrator
  2. Enter Set-RDWorkspace -Name "YourNameHere"
    1. Yes, you need the quotes

That to THIS blog for this tip.


Change the RD Workspace Name and Other Text On the RDWeb Login Page:

  1. Use Notepad to edit %windir%\Web\RDWeb\Pages\en-US\RDWAStrings.xml
  2. Change the text as you see fit like:
    1. line 3 which contains the Page Title
    2. line 10 which contains the HEADING RDWA , and
    3. line 12 that contains the HELP title text

WARNING: Internet Explorer does a good job of detecting the changes when you refresh the page but Chrome does not.  Soooo, if you are using Chrome, make sure you flush your browser cache.

The text in this file is used in more places than just the RDWeb login page.


There are many other customizations you can perform and I found the following articles useful:

Comments

  1. Avatar
    jjackson337 August 4, 2020 at 11:05 am

    Do you know where the html file for the RDS login page is located? I would like to attempt to add a recaptcha to our login page.

    • Ian Matthews
      Ian Matthews September 18, 2020 at 11:29 am

      I am sorry, I shut down my last RDS servers last week. My client that used RDS is pulling out of the country and I have no other clients using it right now.

  2. Avatar
    Martin Wierenga January 21, 2020 at 12:20 pm

    Is there a way to launch a connection through RDweb when you login? I want some users for a collection to be able to login to RDweb and the connection to a RDP session being launched automatically.

    • Ian Matthews
      Ian Matthews February 10, 2020 at 8:48 pm

      Hi Martin;

      We have not tried to do that and I don’t have access to our RDP servers for the next few weeks. If you want us to look into it, ping us back here and we will when regain access.

      Thanks

  3. Avatar
    Oudel Inc November 10, 2019 at 12:13 am

    Thanks for sharing such beautiful information with us.
    I hope you will share some more info about Remote Desktop Services Remote .
    Please keep sharing.

  4. Avatar
    Alessio August 26, 2019 at 7:50 am

    Great post!
    But where you state “Allow Users To CHANGE PASSWORD from RDS Login Page”, I think you should set the “PasswordChangeEnabled” to “true” instead of “false”…

    • Ian Matthews
      Ian Matthews August 26, 2019 at 7:04 pm

      Hi Alessio;

      This setting is a choice each admin will make but I did not want this set of staff changing passwords at all. I force reset this group every 3 months as they are contractors that come and go very quickly.

      Thanks for the observation.

Questions or Comments?