You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/virtual-desktop/quickstart.md
+37-40Lines changed: 37 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,17 +5,13 @@ ms.topic: quickstart
5
5
ms.custom: mode-portal
6
6
author: dknappettmsft
7
7
ms.author: daknappe
8
-
ms.date: 01/08/2025
8
+
ms.date: 03/05/2025
9
9
#customer intent: As an IT admin, I want quickly and easily deploy Azure Virtual Desktop so that I can evaluate and become familiar with the service before deploying it in production.
10
10
---
11
11
12
-
# Quickstart: deploy a sample Azure Virtual Desktop environment (preview)
12
+
# Quickstart: deploy a sample Azure Virtual Desktop environment
13
13
14
-
> [!IMPORTANT]
15
-
> Quickstart for Azure Virtual Desktop is currently in PREVIEW.
16
-
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
17
-
18
-
You can quickly deploy a sample Azure Virtual Desktop environment with *quickstart* (preview) in the Azure portal. Quickstart enables you to easily evaluate a Windows 11 Enterprise multi-session remotely and become familiar with the service before deploying it in production.
14
+
You can quickly deploy a sample Azure Virtual Desktop environment with *quickstart* in the Azure portal. Quickstart enables you to easily evaluate a Windows 11 Enterprise multi-session remotely and become familiar with the service before deploying it in production.
19
15
20
16
When you use quickstart, it deploys a small environment consisting of minimal resources and configuration. A user then signs into Windows App and connects to a full virtual desktop session. Deployment takes approximately 20 minutes to complete.
21
17
@@ -26,19 +22,20 @@ When you use quickstart, it deploys a small environment consisting of minimal re
26
22
27
23
Quickstart deploys the following resources:
28
24
29
-
- A resource group.
30
-
31
-
- A virtual network and subnet with the IPv4 address space `192.168.0.0/24` and uses Azure provided DNS servers.
32
-
33
-
- A network security group associated with the subnet of the virtual network with the default rules only. No inbound rules are required for Azure Virtual Desktop.
34
-
35
-
- A host pool with single sign-on (SSO) enabled.
36
-
37
-
- A session host running Windows 11 Enterprise multi-session with Microsoft 365 apps preinstalled in *English (US)*. It's a [Standard_D4ds_v4](/azure/virtual-machines/sizes/general-purpose/ddsv4-series) size virtual machine (4 vCPUs, 16 GiB memory) configured with a [standard SSD](/azure/virtual-machines/disks-types#standard-ssds) disk, and is joined to Microsoft Entra ID.
38
-
39
-
- An application group that publishes the full desktop from the session host.
40
-
41
-
- A workspace.
25
+
> [!div class="checklist"]
26
+
> - A resource group.
27
+
>
28
+
> - A virtual network and subnet with the IPv4 address space `192.168.0.0/24` and uses Azure provided DNS servers.
29
+
>
30
+
> - A network security group associated with the subnet of the virtual network with the default rules only. No inbound rules are required for Azure Virtual Desktop.
31
+
>
32
+
> - A host pool with single sign-on (SSO) enabled.
33
+
>
34
+
> - A session host running Windows 11 Enterprise multi-session with Microsoft 365 apps preinstalled in *English (US)*. It's a [Standard_D4ds_v4](/azure/virtual-machines/sizes/general-purpose/ddsv4-series) size virtual machine (4 vCPUs, 16 GiB memory) configured with a [standard SSD](/azure/virtual-machines/disks-types#standard-ssds) disk, and is joined to Microsoft Entra ID.
35
+
>
36
+
> - An application group that publishes the full desktop from the session host.
37
+
>
38
+
> - A workspace.
42
39
43
40
You can see a detailed list of [deployed resources](#deployed-resources) later in this article.
44
41
@@ -55,11 +52,11 @@ Before you can use quickstart to deploy a sample Azure Virtual Desktop environme
55
52
|**Contributor**| Used to deploy all the required resources. |
56
53
|**User access administrator**| Used to assign users you specify during deployment access to sign into a remote session. |
57
54
58
-
- One or two user accounts that you want to assign access to the remote session. These accounts must be members of the same Microsoft Entra tenant as the subscription you're using, not guests. You can assign other users later.
55
+
- One or two user accounts that you want to assign access to the remote session. At least one user is required. These accounts must be members of the same Microsoft Entra tenant as the subscription you're using, not guests. You can assign other users later.
59
56
60
-
- Available quota for your subscription for the `Standard_D4ds_v4`VM. If you don't have available quota, you can request an increase by following the steps in [Request VM quota increase](/azure/quotas/per-vm-quota-requests).
57
+
- Available quota for your subscription for the `Standard_D4ds_v4`virtual machine. If you don't have available quota, you can request an increase by following the steps in [Request VM quota increase](/azure/quotas/per-vm-quota-requests).
61
58
62
-
- Internet access from the VM that gets deployed. For more information, see [Required FQDNs and endpoints for Azure Virtual Desktop](required-fqdn-endpoint.md).
59
+
- Internet access from the new virtual machine that gets deployed. For more information, see [Required FQDNs and endpoints for Azure Virtual Desktop](required-fqdn-endpoint.md).
63
60
64
61
## Register the Azure Virtual Desktop resource provider
65
62
@@ -79,11 +76,11 @@ To deploy Azure Virtual Desktop resources, you need to register the `Microsoft.D
79
76
80
77
Here's how to use quickstart to deploy a sample Azure Virtual Desktop environment:
81
78
82
-
1. Go to the [Azure Virtual Desktop options in the Quickstart Center](https://portal.azure.com/#view/Microsoft_Azure_Resources/QuickstartAnchorServicesBlade/goalId/virtual-desktops-and-stream-remote-application). Azure Virtual Desktop is found in **Deliver virtual desktops and stream remote applications**.
79
+
1. Go to the [Quickstart options for Azure Virtual Desktop options](https://portal.azure.com/#view/Microsoft_Azure_WVD/WvdManagerMenuBlade/~/quickstart) in the Azure portal and sign in. Alternatively the **Quickstart Center** has Azure Virtual Desktop options found in the option**Deliver virtual desktops and stream remote applications**.
83
80
84
81
:::image type="content" source="media/quickstart/quickstart-center-options.png" alt-text="A screenshot showing the Azure Virtual Desktop options in the Quickstart Center." lightbox="media/quickstart/quickstart-center-options.png":::
85
82
86
-
1. Select **Get started quickly with Azure Virtual Desktop**, then select **Create**.
83
+
1. Select **Get started quickly with Azure Virtual Desktop** and review the description, then select **Create**.
87
84
88
85
1. On the **Basics** tab, complete the following information:
89
86
@@ -98,7 +95,7 @@ Here's how to use quickstart to deploy a sample Azure Virtual Desktop environmen
98
95
|**Assignment**||
99
96
|**User assignment**| Select **Select maximum two users**. In the pane that opens, search for and select the user account or user group that you want to assign to this desktop. Finish by selecting **Select**. |
100
97
101
-
1. Select **Review + create**. On the **Review + create** tab, ensure that validation passes and review the information that's used during deployment.
98
+
1. Select **Review + create**. On the **Review + create** tab, ensure that validation passes and review the information to use during deployment.
102
99
103
100
1. Select **Create** to deploy the sample Azure Virtual Desktop environment.
104
101
@@ -108,7 +105,7 @@ Here's how to use quickstart to deploy a sample Azure Virtual Desktop environmen
108
105
109
106
## Connect to the desktop
110
107
111
-
Once the sample Azure Virtual Desktop environment is deployed, you can connect to it using [Windows App](/windows-app/) and sign in with one of the user accounts you assigned.
108
+
Once the sample Azure Virtual Desktop environment is deployed, you can connect to it using [Windows App](/windows-app/) and sign in with a user account you assigned during deployment.
112
109
113
110
> [!TIP]
114
111
> The desktop takes longer to load the first time as the profile is being created, however subsequent connections are quicker.
@@ -123,7 +120,7 @@ To connect to your sample desktop on a Windows device, follow these steps:
123
120
124
121
:::image type="content" source="media/quickstart/windows-app-windows-welcome.png" alt-text="A screenshot showing the welcome tab for Windows App on Windows with Azure Virtual Desktop." lightbox="media/quickstart/windows-app-windows-welcome.png":::
125
122
126
-
1. Select **Sign in** and sign in with one of the user accounts you assigned during deployment. If you're signed in to your local Windows device with a work or school account on a managed device, you're signed in to Windows App automatically with the same account.
123
+
1. Select **Sign in** and sign in with a user account you assigned during deployment. If you're signed in to your local Windows device with a work or school account on a managed device, you're signed in to Windows App automatically with the same account.
127
124
128
125
1. If it's your first time using Windows App, navigate through the tour to learn more about Windows App, then select **Done**, or select **Skip**.
129
126
@@ -149,7 +146,7 @@ To connect to your sample desktop on a macOS device, follow these steps:
149
146
150
147
1. If it's your first time using Windows App, navigate through the tour to learn more about Windows App, then select **Done**, or select **Skip**.
151
148
152
-
1. Windows App opens on the **Devices** tab. Select the *plus* (**+**) icon, then select **Add Work or School Account** and sign in with one of the user accounts you assigned during deployment.
149
+
1. Windows App opens on the **Devices** tab. Select the *plus* (**+**) icon, then select **Add Work or School Account** and sign in with a user account you assigned during deployment.
153
150
154
151
:::image type="content" source="media/quickstart/windows-app-macos-devices-add.png" alt-text="A screenshot showing the empty devices tab for Windows App on macOS with Azure Virtual Desktop." lightbox="media/quickstart/windows-app-macos-devices-add.png":::
155
152
@@ -173,7 +170,7 @@ To connect to your sample desktop from a web browser, follow these steps:
173
170
174
171
1. Open a web browser and go to Windows App at [**https://windows.cloud.microsoft/**](https://windows.cloud.microsoft/).
175
172
176
-
1. Sign in with one of the user accounts you assigned during deployment. If you're signed in to your browser with a work or school account on a managed device, you're signed in to Windows App automatically with the same account.
173
+
1. Sign in with a user account you assigned during deployment. If you're signed in to your browser with a work or school account on a managed device, you're signed in to Windows App automatically with the same account.
177
174
178
175
1. If it's your first time using Windows App, navigate through the tour to learn more about Windows App, then select **Done**, or select **Skip**.
179
176
@@ -203,27 +200,27 @@ To connect to your sample desktop from a web browser, follow these steps:
203
200
204
201
## Deployed resources
205
202
206
-
When you deploy a sample Azure Virtual Desktop environment using quickstart, the following resources are deployed, where \<timestamp\> is the date and time when you started the deployment:
203
+
When you deploy a sample Azure Virtual Desktop environment using quickstart, the following resources are deployed, where `<timestamp>` is the date and time when you started the deployment:
207
204
208
205
| Resource type | Name | Notes |
209
206
|--|--|--|
210
-
| Resource group |`rg-avd-quickstart-<timestamp>`| None. |
211
-
| Host pool |`vdpool-avd-quickstart-<timestamp>`| Uses the breadth-first [load balancing algorithm](configure-host-pool-load-balancing.md), with a maximum session limit of **2**. |
212
-
| Application group |`vdag-avd-quickstart-<timestamp>`| Desktop application group. |
| Resource group |`rg-avd-quickstart-<guid>`| None. |
208
+
| Host pool |`vdpool-avd-quickstart-<guid>`| Uses the [breadth-first load balancing algorithm](configure-host-pool-load-balancing.md), with a maximum session limit of **2**. |
209
+
| Application group |`vdag-avd-quickstart-<guid>`| Desktop application group. |
| Virtual machine |`vmaqs<timestamp>`| Windows 11 Enterprise multi-session with Microsoft 365 apps preinstalled in *English (US)*.<br /><br />[Standard_D4ds_v4](/azure/virtual-machines/sizes/general-purpose/ddsv4-series) size virtual machine.<br /><br />Joined to Microsoft Entra ID. |
215
-
| Virtual network |`vnet-avd-quickstart-<timestamp>`| The IPv4 address space is `192.168.0.0/24`. |
216
-
| Network interface |`nic-avd-quickstart-<timestamp>`| Uses Azure provided DNS servers. |
217
-
| Disk |`vmaqs<timestamp>_OsDisk_1_<random-string>`|[Standard SSD](/azure/virtual-machines/disks-types#standard-ssds), 127 GiB. |
218
-
| Network security group |`nsg-avd-quickstart-<timestamp>`| Associated with the subnet of the virtual network with the default rules only. |
212
+
| Virtual network |`vnet-avd-quickstart-<guid>`| The IPv4 address space is `192.168.0.0/24`. |
213
+
| Network interface |`nic-avd-quickstart-<guid>`| Uses Azure provided DNS servers. |
214
+
| Disk |`vmaqs<timestamp>_OsDisk_1_<random-string>`|[Premium SSD](/azure/virtual-machines/disks-types#premium-ssds), 127 GiB, P10 performance tier. |
215
+
| Network security group |`nsg-avd-quickstart-<guid>`| Associated with the subnet of the virtual network with the default rules only. |
219
216
220
217
Once the resource group is created, all resources are deployed to that resource group. All resource names and their configuration are predefined.
221
218
222
219
Timestamps are in the format `yyMMddHHmm`. For example **2501081128** is January 8, 2025, 11:28 AM.
223
220
224
221
## Clean up resources
225
222
226
-
If you want to remove the sample Azure Virtual Desktop resources, you can safely remove them by stopping the virtual machine and deleting the resources in the resource group `rg-avd-quickstart-<timestamp>`.
223
+
If you want to remove the sample Azure Virtual Desktop resources, you can safely remove them by stopping the virtual machine and deleting the resources in the resource group `rg-avd-quickstart-<guid>`.
0 commit comments