Applies to:
Foxtrot RPA, Foxtrot Classic, Foxtrot Legacy — all versions

Microsoft Windows includes an application called Remote Desktop that allows a user to connect to a remote computer. Often times, users will install Foxtrot on a remote computer and access it through Remote Desktop. If the user minimizes the Remote Desktop application, it causes the remote session to switch to a GUI-less mode which does not display windows or controls. When this occurs, Foxtrot is unable to interact with these applications causing the script to stop.

To prevent Remote Desktop from switching to a GUI-less mode when minimized, choose one of the following. The following steps must be completed under a Windows profile with administrative privileges:

From the host computer…

  1. Close all Remote Desktop sessions
  2. Launch the Registry Editor by typing regedit.exe in Windows Run command
  3. Locate any of the following registry keys:
    a. To change the settings for your user account only
    HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\
    b. To change the setting for all user accounts:
    HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client\
  4. Create a new DWORD value in this key named RemoteDesktop_SuppressWhenMinimized
  5. Specify 2 as the value data
  6. Add the RemoteDesktop_SuppressWhenMinimized value to the following keys under the Wow6432Node node:
    a. To change the settings for your user account only:
    HKEY_CURRENT_USER\Software\Wow6432Node\Microsoft\Terminal Server Client\
    b. To change the setting for all user accounts:
    HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Terminal Server Client\
  7. Reboot the computer for the changes to take effect

Disconnecting From Remote Desktop While Running Foxtrot

From the remote computer…

  1. Click on the Start button and type “Run” in the Windows Run command
  2. Type the following into the text box:
    %windir%\System32\tscon.exe RDP-Tcp#NNN /dest:console
    Where TDP-Tcp#NNN is the ID of your current Remote Desktop session, for example, RDP-Tcp#0. You can find this in the Windows Task Manager on the Users tab, in the Session column.
  3. You will see the following message
    Your remote desktop session has ended
  4. The Remote Desktop client will close, however all programs on the remote computer will continue running as normal.

Note: These changes should only be made if you are comfortable with working in and modifying the Windows registry.

Last Modified 10/02/2017