Modifying RemoteApp and Remote Desktop icons

  • Article

Updated: July 31, 2012

Applies To: Unified Access Gateway

When you publish RemoteApps and Remote Desktops through Forefront Unified Access Gateway (UAG), a default icon is used for the application in the portal. Using the CustomUpdate mechanism (as described in About customizing end user Web pages), you can provide a custom icon for each of your published RemoteApp and Remote Desktop applications.

Note

You must provide a custom icon before publishing the application, because the icon details are stored in the RDS internal configuration file, and not in the Forefront UAG configuration.

The icon files are not required to be a certain size or shape because they are automatically scaled to the correct size in the portal; however, it is recommended to use small square icons to reduce portal traffic.

The default icon is located here: ...\Microsoft Forefront Unified Access Gateway\von\PortalHomePage\images\AppIcons\mstsc64.png.

To use a custom icon with published RemoteApps and Remote Desktops

  • In the ...\Microsoft Forefront Unified Access Gateway\von\PortalHomePage\images\AppIcons\CustomUpdate folder, create a file in the format: <rmapp-name>.png

    where

    <rmapp-name> is the name of the application as specified in the imported .tspub file. When you publish Remote Desktops, <rmapp-name> is either remote_desktop or uag_selective_remote_desktop.

    Files using the above naming scheme represent the application icon in the Forefront UAG portal. If you have created a 16x16 icon for use in the tree view and in the Run Application drop-down list, append ‘_icon’ to the filename. For example for App1.png, the icon file is named App1_icon.png.

    Note

    • When you publish the application, Forefront UAG checks for a custom icon in these locations in the order of this list.

    • If you want to change the icon for a RemoteApp or Remote Desktop, you must remove the published application, change the icon, and publish the application again.