|
| 1 | +--- |
| 2 | +title: Connect to Azure Virtual Desktop with the legacy Remote Desktop clients for Windows - Azure Virtual Desktop |
| 3 | +description: Learn how to connect Connect to Azure Virtual Desktop with the legacy Remote Desktop clients for Windows. |
| 4 | +ms.topic: how-to |
| 5 | +author: dknappettmsft |
| 6 | +ms.author: daknappe |
| 7 | +ms.date: 09/24/2024 |
| 8 | +--- |
| 9 | + |
| 10 | +# Connect to Azure Virtual Desktop with the legacy Remote Desktop clients for Windows |
| 11 | + |
| 12 | +> [!IMPORTANT] |
| 13 | +> The Azure Virtual Desktop store app is no longer available for download or installation. To ensure a seamless experience and avoid any disruption, users are encouraged to download Windows App. Windows App is the gateway to securely connect to any devices or apps across Azure Virtual Desktop, Windows 365, and Microsoft Dev Box. For more information, see [What is Windows App](/windows-app/overview). |
| 14 | +
|
| 15 | +The Microsoft Remote Desktop client is used to connect to Azure Virtual Desktop to access your desktops and applications. Connecting to Azure Virtual Desktop with the Remote Desktop client for Windows allows you to subscribe to a feed made available to you by your organization administrators. |
| 16 | + |
| 17 | +There are three versions of the Remote Desktop client for Windows, which are all supported for connecting to Azure Virtual Desktop: |
| 18 | + |
| 19 | +- Standalone download as an MSI installer. This is the most common version of the Remote Desktop client for Windows. |
| 20 | +- Azure Virtual Desktop app from the Microsoft Store. This is a preview version of the Remote Desktop client for Windows, but it's no longer available to download. You can still use it to connect to Azure Virtual Desktop if it's already installed. |
| 21 | +- Remote Desktop app from the Microsoft Store. This version is no longer being developed. |
| 22 | + |
| 23 | +This article shows you how to connect to Azure Virtual Desktop with the Azure Virtual Desktop app and the Remote Desktop app. We recommend connecting to Azure Virtual Desktop with the Remote Desktop client using the MSI installer. To connect using the MSI installer, see [Connect to Azure Virtual Desktop with the Remote Desktop client](connect-remote-desktop-client.md?tab=windows). |
| 24 | + |
| 25 | + |
| 26 | +> [!TIP] |
| 27 | +> You can also connect to Azure Virtual Desktop with Windows App, a single app to securely connect you to Windows devices and apps from Azure Virtual Desktop, Windows 365, Microsoft Dev Box, Remote Desktop Services, and remote PCs. For more information, see [What is Windows App?](/windows-app/overview) |
| 28 | +
|
| 29 | +You can find a list of all the Remote Desktop clients you can use to connect to Azure Virtual Desktop at [Remote Desktop clients overview](remote-desktop-clients-overview.md). |
| 30 | + |
| 31 | +If you want to connect to Remote Desktop Services or a remote PC instead of Azure Virtual Desktop, see [Connect to Remote Desktop Services with the Remote Desktop app for Windows](/windows-server/remote/remote-desktop-services/clients/windows). |
| 32 | + |
| 33 | +## Prerequisites |
| 34 | + |
| 35 | +Select a tab for the version of the Remote Desktop client for Windows you want to use: |
| 36 | + |
| 37 | +# [Azure Virtual Desktop Store app](#tab/avd-store) |
| 38 | + |
| 39 | +To access your resources, you need: |
| 40 | + |
| 41 | +- Internet access. |
| 42 | + |
| 43 | +- A device running one of the following supported versions of Windows: |
| 44 | + - Windows 11 |
| 45 | + - Windows 10 |
| 46 | + |
| 47 | +# [Remote Desktop Store app](#tab/rd-store) |
| 48 | + |
| 49 | +To access your resources, you need: |
| 50 | + |
| 51 | +- Internet access. |
| 52 | + |
| 53 | +- A device running one of the following supported versions of Windows: |
| 54 | + - Windows 11 |
| 55 | + - Windows 10 |
| 56 | + |
| 57 | +--- |
| 58 | + |
| 59 | + |
| 60 | +## Download and install |
| 61 | + |
| 62 | +Select a tab for the version of the Remote Desktop client for Windows you want to use: |
| 63 | + |
| 64 | +# [Azure Virtual Desktop Store app](#tab/avd-store) |
| 65 | + |
| 66 | +The Azure Virtual Desktop app from the Microsoft Store is a preview version of the Remote Desktop client for Windows, but it's no longer available to download. You can still use it to connect to Azure Virtual Desktop if it's already installed. |
| 67 | + |
| 68 | +> [!IMPORTANT] |
| 69 | +> If you have the Remote Desktop client (MSI) and the Azure Virtual Desktop app from the Microsoft Store installed on the same device, you may see the message that begins **A version of this application called Azure Virtual Desktop was installed from the Microsoft Store**. Both apps are supported, and you have the option to choose **Continue anyway**, however we recommend using [Windows App](/windows-app/overview) for the most up-to-date experience. |
| 70 | +
|
| 71 | + |
| 72 | +# [Remote Desktop Store app](#tab/rd-store) |
| 73 | + |
| 74 | +> [!IMPORTANT] |
| 75 | +> We're no longer updating the Remote Desktop app for Windows with new features and support for Azure Virtual Desktop will be removed in the future. |
| 76 | +> |
| 77 | +> To ensure a seamless experience and avoid any disruption, users are encouraged to download Windows App. Windows App is the gateway to securely connect to any devices or apps across Azure Virtual Desktop, Windows 365, and Microsoft Dev Box. For more information, see [What is Windows App](/windows-app/overview). |
| 78 | +
|
| 79 | +The Remote Desktop app is available from the Microsoft Store. To download and install it, follow these steps: |
| 80 | + |
| 81 | +1. Go to the [Remote Desktop app in the Microsoft Store](https://go.microsoft.com/fwlink/?LinkID=616709). |
| 82 | + |
| 83 | +1. Select **Install** to start downloading the app and installing it. |
| 84 | + |
| 85 | +1. Once the app has finished downloading and installing, select **Open**. |
| 86 | + |
| 87 | +--- |
| 88 | + |
| 89 | +## Subscribe to a workspace |
| 90 | + |
| 91 | +Select a tab for the version of the Remote Desktop client for Windows you want to use: |
| 92 | + |
| 93 | +# [Azure Virtual Desktop Store app](#tab/avd-store) |
| 94 | + |
| 95 | +A workspace combines all the desktops and applications that have been made available to you by your admin. To be able to see these in the Azure Virtual Desktop app, you need to subscribe to the workspace by following these steps: |
| 96 | + |
| 97 | +1. Open the **Azure Virtual Desktop** app on your device. |
| 98 | + |
| 99 | +1. The first time you subscribe to a workspace, from the **Let's get started** screen, select **Subscribe** or **Subscribe with URL**. Use the tabs below for your scenario. |
| 100 | + |
| 101 | + - If you selected **Subscribe **, sign in with your user account when prompted, for example `[email protected]`. After a few seconds, your workspaces should show the desktops and applications that have been made available to you by your admin. |
| 102 | + |
| 103 | + If you see the message **No workspace is associated with this email address**, your admin might not have set up email discovery, or you're using an Azure environment that isn't Azure cloud, such as Azure for US Government. Try the steps to **Subscribe with URL** instead. |
| 104 | + |
| 105 | + - If you selected **Subscribe with URL**, in the **Email or Workspace URL** box, enter the relevant URL from the following table. After a few seconds, the message **We found Workspaces at the following URLs** should be displayed. |
| 106 | + |
| 107 | + | Azure environment | Workspace URL | |
| 108 | + |--|--| |
| 109 | + | Azure cloud *(most common)* | `https://rdweb.wvd.microsoft.com` | |
| 110 | + | Azure for US Government | `https://rdweb.wvd.azure.us/api/arm/feeddiscovery` | |
| 111 | + | Azure operated by 21Vianet | `https://rdweb.wvd.azure.cn/api/arm/feeddiscovery` | |
| 112 | + |
| 113 | +1. Select **Next**. |
| 114 | + |
| 115 | +1. Sign in with your user account when prompted. After a few seconds, the workspace should show the desktops and applications that have been made available to you by your admin. |
| 116 | + |
| 117 | +Once you've subscribed to a workspace, its content will update automatically regularly and each time you start the client. Resources may be added, changed, or removed based on changes made by your admin. |
| 118 | + |
| 119 | +# [Remote Desktop Store app](#tab/rd-store) |
| 120 | + |
| 121 | +A workspace combines all the desktops and applications that have been made available to you by your admin. To be able to see these in the Remote Desktop app, you need to subscribe to the workspace by following these steps: |
| 122 | + |
| 123 | +1. Open the **Remote Desktop** app on your device. |
| 124 | + |
| 125 | +1. In the Connection Center, select **+ Add**, then select **Workspaces**. |
| 126 | + |
| 127 | +1. In the **Email or Workspace URL ** box, either enter your user account, for example `[email protected]`, or the relevant URL from the following table. After a few seconds, the message **We found Workspaces at the following URLs ** should be displayed. |
| 128 | + |
| 129 | + If you see the message **We couldn't find any Workspaces associated with this email address. Try providing a URL instead**, your admin might not have set up email discovery. Use one of the following workspace URLs instead. |
| 130 | + |
| 131 | + | Azure environment | Workspace URL | |
| 132 | + |--|--| |
| 133 | + | Azure cloud *(most common)* | `https://rdweb.wvd.microsoft.com` | |
| 134 | + | Azure for US Government | `https://rdweb.wvd.azure.us/api/arm/feeddiscovery` | |
| 135 | + | Azure operated by 21Vianet | `https://rdweb.wvd.azure.cn/api/arm/feeddiscovery` | |
| 136 | + |
| 137 | +1. Select **Subscribe**. |
| 138 | + |
| 139 | +1. Sign in with your user account. After a few seconds, your workspaces should show the desktops and applications that have been made available to you by your admin. |
| 140 | + |
| 141 | +Once you've subscribed to a workspace, its content will update automatically regularly. Resources may be added, changed, or removed based on changes made by your admin. |
| 142 | + |
| 143 | +--- |
| 144 | + |
| 145 | +## Connect to your desktops and applications |
| 146 | + |
| 147 | +Select a tab for the version of the Remote Desktop client for Windows you want to use: |
| 148 | + |
| 149 | +# [Azure Virtual Desktop Store app](#tab/avd-store) |
| 150 | + |
| 151 | +Once you've subscribed to a workspace, here's how to connect: |
| 152 | + |
| 153 | +1. Open the **Azure Virtual Desktop** app on your device. |
| 154 | + |
| 155 | +1. Double-click one of the icons to launch a session to Azure Virtual Desktop. You may be prompted to enter the password for your user account again, depending on how your admin has configured Azure Virtual Desktop. |
| 156 | + |
| 157 | +1. To pin your desktops and applications to the Start Menu, right-click one of the icons and select **Pin to Start Menu**, then confirm the prompt. |
| 158 | + |
| 159 | +### Insider releases |
| 160 | + |
| 161 | +If you want to help us test new builds before they're released, you should download our Insider releases. Organizations can use the Insider releases to validate new versions for their users before they're generally available. For more information, see [Enable Insider releases](client-features-windows.md#enable-insider-releases). |
| 162 | + |
| 163 | + |
| 164 | +# [Remote Desktop Store app](#tab/rd-store) |
| 165 | + |
| 166 | +Once you've subscribed to a workspace, here's how to connect: |
| 167 | + |
| 168 | +1. Open the **Remote Desktop** app on your device. |
| 169 | + |
| 170 | +1. Select one of the icons to launch a session to Azure Virtual Desktop. You may be prompted to enter the password for your user account again, depending on how your admin has configured Azure Virtual Desktop. |
| 171 | + |
| 172 | +--- |
| 173 | + |
| 174 | +## Next steps |
| 175 | + |
| 176 | +- To learn more about the features of the Remote Desktop client for Windows, check out [Use features of the Remote Desktop client for Windows when connecting to Azure Virtual Desktop](client-features-windows.md). |
| 177 | + |
| 178 | +- If you want to use Teams on Azure Virtual Desktop with media optimization, see [Use Microsoft Teams on Azure Virtual Desktop](../teams-on-avd.md). |
0 commit comments