Skip to content

Commit 50c58e3

Browse files
authored
Merge pull request #111790 from Heidilohr/work-small-images
Second round of edits for "small" docs
2 parents 871c801 + 8710ba1 commit 50c58e3

25 files changed

+261
-271
lines changed

articles/virtual-desktop/configure-host-pool-load-balancing.md

Lines changed: 38 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,34 +17,65 @@ Configuring the load-balancing method for a host pool allows you to adjust the W
1717
>[!NOTE]
1818
> This does not apply to a persistent desktop host pool because users always have a 1:1 mapping to a session host within the host pool.
1919
20+
## Prerequisites
21+
22+
This article assumes you've followed the instructions in [Set up the Windows Virtual Desktop PowerShell module](powershell-module.md) to download and install the PowerShell module and sign in to your Azure account.
23+
2024
## Configure breadth-first load balancing
2125

2226
Breadth-first load balancing is the default configuration for new non-persistent host pools. Breadth-first load balancing distributes new user sessions across all available session hosts in the host pool. When configuring breadth-first load balancing, you may set a maximum session limit per session host in the host pool.
2327

24-
First, [download and import the Windows Virtual Desktop PowerShell module](/powershell/windows-virtual-desktop/overview/) to use in your PowerShell session if you haven't already. After that, run the following cmdlet to sign in to your account:
28+
To configure a host pool to perform breadth-first load balancing without adjusting the maximum session limit, run the following PowerShell cmdlet:
2529

2630
```powershell
27-
Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
31+
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -LoadBalancerType 'BreadthFirst'
2832
```
2933

30-
To configure a host pool to perform breadth-first load balancing without adjusting the maximum session limit, run the following PowerShell cmdlet:
34+
After that, to make sure you've set the breadth-first load balancing method, run the following cmdlet:
3135

3236
```powershell
33-
Set-RdsHostPool <tenantname> <hostpoolname> -BreadthFirstLoadBalancer
37+
Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, LoadBalancerType
38+
39+
Name : hostpoolname
40+
LoadBalancerType : BreadthFirst
3441
```
3542

3643
To configure a host pool to perform breadth-first load balancing and to use a new maximum session limit, run the following PowerShell cmdlet:
3744

3845
```powershell
39-
Set-RdsHostPool <tenantname> <hostpoolname> -BreadthFirstLoadBalancer -MaxSessionLimit ###
46+
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -LoadBalancerType 'BreadthFirst' -MaxSessionLimit ###
4047
```
4148

4249
## Configure depth-first load balancing
4350

44-
Depth-first load balancing distributes new user sessions to an available session host with the highest number of connections but has not reached its maximum session limit threshold. When configuring depth-first load balancing, you **must** set a maximum session limit per session host in the host pool.
51+
Depth-first load balancing distributes new user sessions to an available session host with the highest number of connections but has not reached its maximum session limit threshold. When configuring depth-first load balancing, you must set a maximum session limit per session host in the host pool.
4552

4653
To configure a host pool to perform depth-first load balancing, run the following PowerShell cmdlet:
4754

4855
```powershell
49-
Set-RdsHostPool <tenantname> <hostpoolname> -DepthFirstLoadBalancer -MaxSessionLimit ###
56+
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -LoadBalancerType 'DepthFirst' -MaxSessionLimit ###
57+
```
58+
59+
To make sure the setting has updated, run this cmdlet:
60+
61+
```powershell
62+
Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, LoadBalancerType, MaxSessionLimit
63+
64+
Name : hostpoolname
65+
LoadBalancerType : DepthFirst
66+
MaxSessionLimit : 6
5067
```
68+
69+
## Configure load balancing with the Azure portal
70+
71+
You can also configure load balancing with the Azure portal.
72+
73+
To configure load balancing:
74+
75+
1. Sign into the Azure portal at https://portal.azure.com.
76+
2. Search for and select **Windows Virtual Desktop** under Services.
77+
3. In the Windows Virtual Desktop page, select **Host pools**.
78+
4. Select the name of the host pool you want to edit.
79+
5. Select **Properties**.
80+
6. Enter the **Max session limit** into the field and select the **load balancing algorithm** you want for this host pool in the drop-down menu.
81+
7. Select **Save**. This applies the new load balancing settings.

articles/virtual-desktop/configure-host-pool-personal-desktop-assignment-type.md

Lines changed: 13 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: HeidiLohr
66

77
ms.service: virtual-desktop
88
ms.topic: conceptual
9-
ms.date: 12/10/2019
9+
ms.date: 04/30/2020
1010
ms.author: helohr
1111
manager: lizross
1212
---
@@ -23,33 +23,26 @@ You can configure the assignment type of your personal desktop host pool to adju
2323
>[!NOTE]
2424
> The instructions in this article only apply to personal desktop host pools, not pooled host pools, since users in pooled host pools aren't assigned to specific session hosts.
2525
26+
## Prerequisites
27+
28+
This article assumes you've already downloaded and installed the Windows Virtual Desktop PowerShell module. If you haven't, follow the instructions in [Set up the PowerShell module](powershell-module.md).
29+
2630
## Configure automatic assignment
2731

2832
Automatic assignment is the default assignment type for new personal desktop host pools created in your Windows Virtual Desktop environment. Automatically assigning users doesn't require a specific session host.
2933

3034
To automatically assign users, first assign them to the personal desktop host pool so that they can see the desktop in their feed. When an assigned user launches the desktop in their feed, they will claim an available session host if they have not already connected to the host pool, which completes the assignment process.
3135

32-
Before you start, [download and import the Windows Virtual Desktop PowerShell module](/powershell/windows-virtual-desktop/overview/) if you haven't already.
33-
34-
> [!NOTE]
35-
> Make sure you've installed Windows Virtual Desktop PowerShell module version 1.0.1534.2001 or later before following these instructions.
36-
37-
After that, run the following cmdlet to sign in to your account:
38-
39-
```powershell
40-
Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
41-
```
42-
4336
To configure a host pool to automatically assign users to VMs, run the following PowerShell cmdlet:
4437

4538
```powershell
46-
Set-RdsHostPool <tenantname> <hostpoolname> -AssignmentType Automatic
39+
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -PersonalDesktopAssignmentType Automatic
4740
```
4841

4942
To assign a user to the personal desktop host pool, run the following PowerShell cmdlet:
5043

5144
```powershell
52-
Add-RdsAppGroupUser <tenantname> <hostpoolname> "Desktop Application Group" -UserPrincipalName <userupn>
45+
New-AzRoleAssignment -SignInName <userupn> -RoleDefinitionName "Desktop Virtualization User" -ResourceName <appgroupname> -ResourceGroupName <resourcegroupname> -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'
5346
```
5447

5548
## Configure direct assignment
@@ -59,19 +52,19 @@ Unlike automatic assignment, when you use direct assignment, you must assign the
5952
To configure a host pool to require direct assignment of users to session hosts, run the following PowerShell cmdlet:
6053

6154
```powershell
62-
Set-RdsHostPool <tenantname> <hostpoolname> -AssignmentType Direct
55+
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -PersonalDesktopAssignmentType Direct
6356
```
6457

6558
To assign a user to the personal desktop host pool, run the following PowerShell cmdlet:
6659

6760
```powershell
68-
Add-RdsAppGroupUser <tenantname> <hostpoolname> "Desktop Application Group" -UserPrincipalName <userupn>
61+
New-AzRoleAssignment -SignInName <userupn> -RoleDefinitionName "Desktop Virtualization User" -ResourceName <appgroupname> -ResourceGroupName <resourcegroupname> -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'
6962
```
7063

7164
To assign a user to a specific session host, run the following PowerShell cmdlet:
7265

7366
```powershell
74-
Set-RdsSessionHost <tenantname> <hostpoolname> -Name <sessionhostname> -AssignedUser <userupn>
67+
Update-AzWvdSessionHost -HostPoolName <hostpoolname> -Name <sessionhostname> -ResourceGroupName <resourcegroupname> -AssignedUser <userupn>
7568
```
7669

7770
## Next steps
@@ -80,3 +73,6 @@ Now that you've configured the personal desktop assignment type, you can sign in
8073

8174
- [Connect with the Windows Desktop client](connect-windows-7-and-10.md)
8275
- [Connect with the web client](connect-web.md)
76+
- [Connect with the Android client](connect-android.md)
77+
- [Connect with the iOS client](connect-ios.md)
78+
- [Connect with the macOS client](connect-macos.md)

articles/virtual-desktop/configure-vm-gpu.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Azure offers a number of [GPU optimized virtual machine sizes](/azure/virtual-ma
2828

2929
## Create a host pool, provision your virtual machine, and configure an app group
3030

31-
Create a new host pool using a VM of the size you selected. For instructions, see [Tutorial: Create a host pool with Azure Marketplace](/azure/virtual-desktop/create-host-pools-azure-marketplace).
31+
Create a new host pool using a VM of the size you selected. For instructions, see [Tutorial: Create a host pool with the Azure portal](/azure/virtual-desktop/create-host-pools-azure-marketplace).
3232

3333
Windows Virtual Desktop supports GPU-accelerated rendering and encoding in the following operating systems:
3434

articles/virtual-desktop/create-fslogix-profile-container.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,7 @@ This section is based on [Create a profile container for a host pool using a fil
205205

206206
## Make sure users can access the Azure NetApp File share
207207

208-
1. Open your internet browser and go to <https://rdweb.wvd.microsoft.com/webclient/index.html>.
208+
1. Open your internet browser and go to <https://rdweb.wvd.microsoft.com/arm/webclient>.
209209

210210
2. Sign in with the credentials of a user assigned to the Remote Desktop group.
211211

articles/virtual-desktop/create-profile-container-adds.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ Now all you have to do is make sure the profile you created exists and works as
215215
216216
To verify your profile:
217217
218-
1. Open a browser and go to [the Windows Virtual Desktop web client](https://rdweb.wvd.microsoft.com/webclient/index.html).
218+
1. Open a browser and go to [the Windows Virtual Desktop web client](https://rdweb.wvd.microsoft.com/arm/webclient).
219219
220220
2. Sign in with the user account assigned to the Remote Desktop group.
221221

articles/virtual-desktop/create-validation-host-pool.md

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -27,54 +27,52 @@ You can debug issues in the validation host pool with either [the diagnostics fe
2727
>[!NOTE]
2828
> We recommend that you leave the validation host pool in place to test all future updates.
2929
30-
Before you begin, [download and import the Windows Virtual Desktop PowerShell module](/powershell/windows-virtual-desktop/overview/), if you haven't already. After that, run the following cmdlet to sign in to your account:
30+
>[!IMPORTANT]
31+
>The Windows Virtual Desktop Spring 2020 release currently has trouble enabling and disabling validation environment. We'll update this article when we've resolved the issue.
3132
32-
```powershell
33-
Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
34-
```
33+
## Prerequisites
34+
35+
Before you begin, follow the instructions in [Set up the Windows Virtual Desktop PowerShell module](powershell-module.md) to set up your PowerShell module and sign in to Azure.
3536

3637
## Create your host pool
3738

3839
You can create a host pool by following the instructions in any of these articles:
3940
- [Tutorial: Create a host pool with Azure Marketplace](create-host-pools-azure-marketplace.md)
40-
- [Create a host pool with an Azure Resource Manager template](./virtual-desktop-fall-2019/create-host-pools-arm-template.md)
4141
- [Create a host pool with PowerShell](create-host-pools-powershell.md)
4242

4343
## Define your host pool as a validation host pool
4444

45-
Run the following PowerShell cmdlets to define the new host pool as a validation host pool. Replace the values in quotes by the values relevant to your session:
45+
Run the following PowerShell cmdlets to define the new host pool as a validation host pool. Replace the values in brackets with the values relevant to your session:
4646

4747
```powershell
48-
Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
49-
Set-RdsHostPool -TenantName $myTenantName -Name "contosoHostPool" -ValidationEnv $true
48+
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -ValidationEnvironment:$true
5049
```
5150

52-
Run the following PowerShell cmdlet to confirm that the validation property has been set. Replace the values in quotes by the values relevant to your session.
51+
Run the following PowerShell cmdlet to confirm that the validation property has been set. Replace the values in brackets with the values relevant to your session.
5352

5453
```powershell
55-
Get-RdsHostPool -TenantName $myTenantName -Name "contosoHostPool"
54+
Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | Format-List
5655
```
5756

5857
The results from the cmdlet should look similar to this output:
5958

60-
```
61-
TenantName : contoso
62-
TenantGroupName : Default Tenant Group
63-
HostPoolName : contosoHostPool
59+
```powershell
60+
HostPoolName : hostpoolname
6461
FriendlyName :
6562
Description :
6663
Persistent : False
67-
CustomRdpProperty : use multimon:i:0;
64+
CustomRdpProperty : use multimon:i:0;
6865
MaxSessionLimit : 10
6966
LoadBalancerType : BreadthFirst
70-
ValidationEnv : True
71-
Ring :
67+
ValidationEnvironment : True
7268
```
7369

7470
## Update schedule
7571

7672
Service updates happen monthly. If there are major issues, critical updates will be provided at a more frequent pace.
7773

74+
If there are any service updates, make sure you have at least a small group of users signing in each day to validate the environment. We recommend you regularly visit our [TechCommunity site](https://techcommunity.microsoft.com/t5/forums/searchpage/tab/message?filter=location&q=wvdupdate&location=forum-board:WindowsVirtualDesktop&sort_by=-topicPostDate&collapse_discussion=true) and follow any posts with WVDUPdate to stay informed about service updates.
75+
7876
## Next steps
7977

8078
Now that you've created a validation host pool, you can learn how to use Azure Service Health to monitor your Windows Virtual Desktop deployment.

articles/virtual-desktop/customize-feed-for-virtual-desktop-users.md

Lines changed: 71 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,9 @@ manager: lizross
2020
2121
You can customize the feed so the RemoteApp and remote desktop resources appear in a recognizable way for your users.
2222

23-
First, [download and import the Windows Virtual Desktop PowerShell module](/powershell/windows-virtual-desktop/overview/) to use in your PowerShell session if you haven't already. After that, run the following cmdlet to sign in to your account:
23+
## Prerequisites
2424

25-
```powershell
26-
Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
27-
```
25+
This article assumes you've already downloaded and installed the Windows Virtual Desktop PowerShell module. If you haven't, follow the instructions in [Set up the PowerShell module](powershell-module.md).
2826

2927
## Customize the display name for a RemoteApp
3028

@@ -33,16 +31,55 @@ You can change the display name for a published RemoteApp by setting the friendl
3331
To retrieve a list of published RemoteApps for an app group, run the following PowerShell cmdlet:
3432

3533
```powershell
36-
Get-RdsRemoteApp -TenantName <tenantname> -HostPoolName <hostpoolname> -AppGroupName <appgroupname>
34+
Get-AzWvdApplication -ResourceGroupName <resourcegroupname> -ApplicationGroupName <appgroupname>
35+
```
36+
37+
To assign a friendly name to a RemoteApp, run the following cmdlet with the required parameters:
38+
39+
```powershell
40+
Update-AzWvdApplication -ResourceGroupName <resourcegroupname> -ApplicationGroupName <appgroupname> -Name <applicationname> -FriendlyName <newfriendlyname>
41+
```
42+
43+
For example, let's say you retrieved the current applications with the following example cmdlet:
44+
45+
```powershell
46+
Get-AzWvdApplication -ResourceGroupName 0301RG -ApplicationGroupName 0301RAG | format-list
47+
```
48+
49+
The output would look like this:
50+
51+
```powershell
52+
CommandLineArgument :
53+
CommandLineSetting : DoNotAllow
54+
Description :
55+
FilePath : C:\Program Files\Windows NT\Accessories\wordpad.exe
56+
FriendlyName : Microsoft Word
57+
IconContent : {0, 0, 1, 0…}
58+
IconHash : --iom0PS6XLu-EMMlHWVW3F7LLsNt63Zz2K10RE0_64
59+
IconIndex : 0
60+
IconPath : C:\Program Files\Windows NT\Accessories\wordpad.exe
61+
Id : /subscriptions/<subid>/resourcegroups/0301RG/providers/Microsoft.DesktopVirtualization/applicationgroups/0301RAG/applications/Microsoft Word
62+
Name : 0301RAG/Microsoft Word
63+
ShowInPortal : False
64+
Type : Microsoft.DesktopVirtualization/applicationgroups/applications
65+
```
66+
To update the friendly name, run this cmdlet:
67+
68+
```powershell
69+
Update-AzWvdApplication -GroupName 0301RAG -Name "Microsoft Word" -FriendlyName "WordUpdate" -ResourceGroupName 0301RG -IconIndex 0 -IconPath "C:\Program Files\Windows NT\Accessories\wordpad.exe" -ShowInPortal:$true -CommandLineSetting DoNotallow -FilePath "C:\Program Files\Windows NT\Accessories\wordpad.exe"
70+
```
71+
72+
To confirm you've successfully updated the friendly name, run this cmdlet:
73+
74+
```powershell
75+
Get-AzWvdApplication -ResourceGroupName 0301RG -ApplicationGroupName 0301RAG | format-list FriendlyName
3776
```
38-
![A screenshot of PowerShell cmdlet Get-RDSRemoteApp with Name and FriendlyName highlighted.](media/get-rdsremoteapp.png)
3977

40-
To assign a friendly name to a RemoteApp, run the following PowerShell cmdlet:
78+
The cmdlet should give you the following output:
4179

4280
```powershell
43-
Set-RdsRemoteApp -TenantName <tenantname> -HostPoolName <hostpoolname> -AppGroupName <appgroupname> -Name <existingappname> -FriendlyName <newfriendlyname>
81+
FriendlyName : WordUpdate
4482
```
45-
![A screenshot of PowerShell cmdlet Set-RDSRemoteApp with Name and New FriendlyName highlighted.](media/set-rdsremoteapp.png)
4683

4784
## Customize the display name for a Remote Desktop
4885

@@ -51,20 +88,39 @@ You can change the display name for a published remote desktop by setting a frie
5188
To retrieve the remote desktop resource, run the following PowerShell cmdlet:
5289

5390
```powershell
54-
Get-RdsRemoteDesktop -TenantName <tenantname> -HostPoolName <hostpoolname> -AppGroupName <appgroupname>
91+
Get-AzWvdDesktop -ResourceGroupName <resourcegroupname> -ApplicationGroupName <appgroupname> -Name <applicationname>
5592
```
56-
![A screenshot of PowerShell cmdlet Get-RDSRemoteApp with Name and FriendlyName highlighted.](media/get-rdsremotedesktop.png)
5793

5894
To assign a friendly name to the remote desktop resource, run the following PowerShell cmdlet:
5995

6096
```powershell
61-
Set-RdsRemoteDesktop -TenantName <tenantname> -HostPoolName <hostpoolname> -AppGroupName <appgroupname> -FriendlyName <newfriendlyname>
97+
Update-AzWvdDesktop -ResourceGroupName <resourcegroupname> -ApplicationGroupName <appgroupname> -Name <applicationname> -FriendlyName <newfriendlyname>
6298
```
63-
![A screenshot of PowerShell cmdlet Set-RDSRemoteApp with Name and New FriendlyName highlighted.](media/set-rdsremotedesktop.png)
99+
100+
## Customize a display name in Azure portal
101+
102+
You can change the display name for a published remote desktop by setting a friendly name using the Azure portal.
103+
104+
1. Sign in to the Azure portal at <https://portal.azure.com>.
105+
106+
2. Search for **Windows Virtual Desktop**.
107+
108+
3. Under Services, select **Windows Virtual Desktop**.
109+
110+
4. On the Windows Virtual Desktop page, select **Application groups** on the left side of the screen, then select the name of the app group you want to edit.
111+
112+
5. Select **Applications** in the menu on the left side of the screen.
113+
114+
6. Select the application you want to update, then enter a new **Display name**.
115+
116+
7. Select **Save**. The application you edited should now display the updated name.
64117

65118
## Next steps
66119

67120
Now that you've customized the feed for users, you can sign in to a Windows Virtual Desktop client to test it out. To do so, continue to the Connect to Windows Virtual Desktop How-tos:
68121

69-
* [Connect from Windows 10 or Windows 7](connect-windows-7-and-10.md)
70-
* [Connect from a web browser](connect-web.md)
122+
* [Connect with Windows 10 or Windows 7](connect-windows-7-and-10.md)
123+
* [Connect with the web client](connect-web.md)
124+
* [Connect with the Android client](connect-android.md)
125+
* [Connect with the iOS client](connect-ios.md)
126+
* [Connect with the macOS client](connect-macos.md)

0 commit comments

Comments
 (0)