|
1 | 1 | --- |
2 | | -title: Error "The remote desktop wasn't found" |
3 | | -description: Solves an issue that occurs when on runtime the flow fails with 'The remote desktop wasn't found' |
| 2 | +title: The Remote Desktop Wasn't Found Error |
| 3 | +description: Solves an error that occurs when you use Remote Desktop Protocol (RDP) or Citrix automation in Microsoft Power Automate. |
4 | 4 | ms.reviewer: amitrou |
5 | 5 | ms.author: iopanag |
6 | 6 | author: iopanag |
7 | 7 | ms.custom: sap:Desktop flows\UI or browser automation |
8 | | -ms.date: 03/28/2025 |
| 8 | +ms.date: 04/15/2025 |
9 | 9 | --- |
10 | | -# Error "The remote desktop wasn't found" |
| 10 | +# A desktop flow fails with the "The remote desktop wasn't found" error |
11 | 11 |
|
12 | | -This article helps you resolve an issue you might encounter when a flow fails with error 'The remote desktop wasn't found'. |
| 12 | +This article helps you resolve the issue where a flow fails with the "The remote desktop wasn't found" error when using Microsoft Remote Desktop Protocol (RDP) or Citrix automation in Microsoft Power Automate. |
13 | 13 |
|
14 | 14 | ## Symptoms |
15 | 15 |
|
16 | | -A flow using RDP/Citrix automation used to run successfully but it started failing with error 'The remote desktop wasn't found'. It might even never run successfully. This issue is more common in Citrix Virtual Apps. |
| 16 | +A flow using [Remote Desktop Protocol (RDP) or Citrix automation](/power-automate/desktop-flows/virtual-desktops) that previously ran successfully might start failing with the following error: |
| 17 | + |
| 18 | +> The remote desktop wasn't found. |
| 19 | +
|
| 20 | +In some cases, the flow might never run successfully. This issue is more commonly observed in Citrix Virtual Apps. |
17 | 21 |
|
18 | 22 | ## Cause 1 |
19 | 23 |
|
20 | | -The RDP Window/Citrix Desktop/Virtual App might changed name since when the elements were captured and tracking them with the old name fails. |
| 24 | +The name of the RDP window, Citrix Desktop, or Citrix Virtual Apps may have changed since the original [UI elements](/power-automate/desktop-flows/virtual-desktops#distinguish-ui-elements-captured-on-virtual-desktops) were captured. Tracking these elements with the old name can fail. |
21 | 25 |
|
22 | 26 | ### Resolution |
23 | 27 |
|
24 | | -You can repair the selectors used to retract the RDP Window/Citrix Desktop/Virtual App like normal window selectors: |
| 28 | +You can [repair the selectors](/power-automate/desktop-flows/repair-selector) used to track the RDP window, Citrix Desktop, or Citrix Virtual Apps as follows: |
25 | 29 |
|
26 | | -1. Make sure the affected RDP Window/Citrix Desktop/Virtual App is up. |
27 | | -2. Find the desktop element that has the problem in the "UI Elements" pane on Designer and double click it to open the selector editor. |
| 30 | +1. Ensure the affected RDP window, Citrix Desktop, or Citrix Virtual Apps is active. |
| 31 | +2. Locate the desktop element causing the issue in the [UI elements](/power-automate/desktop-flows/ui-elements#ui-elements) pane in the flow designer. Double-click it to open the selector editor. |
28 | 32 |
|
29 | 33 | :::image type="content" source="media/error-remote-desktop-not-found/control-repo-desktop.png" alt-text="Screenshot of the Power Automate elements section with a Citrix desktop element highlighted."::: |
30 | 34 |
|
31 | | -3. Select on "Repair" button and capture the new Desktop/App. Check the suggested changes and accept them. |
| 35 | +3. Select the **Repair** button and capture the new desktop or app. Review the suggested changes and accept them. |
| 36 | + |
| 37 | + :::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-repair.png" alt-text="Screenshot of the Power Automate selector builder window with the Repair button highlighted."::: |
32 | 38 |
|
33 | | - :::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-repair.png" alt-text="Screenshot of the Power Automate selector builder window with the repair button highlighted"::: |
| 39 | +4. After accepting the changes, select **Test** to verify the new selector. For more information, see [Test a selector](/power-automate/desktop-flows/test-selectors). |
34 | 40 |
|
35 | | -4. After Accepting the changes, select "Test" to test the new selector. |
36 | | -5. [Optionally if needed] You can use the "New" Button to add more fallback selectors for the desktop. |
| 41 | +5. (Optionally) Use the **New** button to add more fallback selectors for the desktop, if necessary. |
37 | 42 |
|
38 | 43 | ## Cause 2 |
39 | 44 |
|
40 | | -The usage of Citrix Virtual App with certain applications causes the creation of incorrect target desktop selector using ordinal, especially when interacting with combo box lists. |
| 45 | +When you use Citrix Virtual Apps with certain applications, an incorrect target desktop selector may be created using an ordinal value (for example, **eq**) instead of a more robust selection method. This is particularly common when interacting with combo box lists. |
41 | 46 |
|
42 | 47 | ### Resolution |
43 | 48 |
|
44 | | -1. Make sure the affected RDP Window/Citrix Desktop/Virtual App is up. |
45 | | -2. Find the desktop element that has the problem in the "UI Elements" pane on Designer and double click it to open the selector editor. |
| 49 | +1. Ensure the affected RDP window, Citrix Desktop, or Citrix Virtual Apps is active. |
| 50 | +2. Locate the desktop element causing the issue in the [UI elements](/power-automate/desktop-flows/ui-elements#ui-elements) pane in the flow designer. Double-click it to open the selector editor. |
46 | 51 |
|
47 | 52 | :::image type="content" source="media/error-remote-desktop-not-found/control-repo-desktop.png" alt-text="Screenshot of the Power Automate elements section with a Citrix app element highlighted."::: |
48 | 53 |
|
49 | | -3. Check if the selector is using ordinal (eq is checked). If it uses, **uncheck** it and save it. |
| 54 | +3. Check if the selector is using an ordinal value (the **eq** is selected.) If it is, clear the value and save the change. |
50 | 55 |
|
51 | | - :::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-ordinal.png" alt-text="Screenshot of the Power Automate selector builder window with ordinal attribute checkbox unchecked"::: |
| 56 | + :::image type="content" source="media/error-remote-desktop-not-found/rdp-selector-builder-ordinal.png" alt-text="Screenshot of the Power Automate selector builder window with an ordinal attribute checkbox cleared."::: |
52 | 57 |
|
53 | | -4. Click on the "Test" to test the new selector. |
| 58 | +4. Select **Test** to verify the new selector. For more information, see [Test a selector](/power-automate/desktop-flows/test-selectors). |
0 commit comments