Skip to content

Commit 5adf86a

Browse files
authored
Merge pull request #230644 from Heidilohr/work-session-tabs
Reformatting tabs to make page more organized.
2 parents 61f852d + b68594f commit 5adf86a

File tree

1 file changed

+72
-35
lines changed

1 file changed

+72
-35
lines changed

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

Lines changed: 72 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure Virtual Desktop personal desktop assignment type - Azure
33
description: How to configure automatic or direct assignment for an Azure Virtual Desktop personal desktop host pool.
44
author: Heidilohr
55
ms.topic: how-to
6-
ms.date: 03/03/2023
6+
ms.date: 04/18/2023
77
ms.author: helohr
88
ms.custom: devx-track-azurepowershell
99
manager: femila
@@ -74,48 +74,74 @@ To assign a user to the personal desktop host pool, run the following PowerShell
7474
New-AzRoleAssignment -SignInName <userupn> -RoleDefinitionName "Desktop Virtualization User" -ResourceName <appgroupname> -ResourceGroupName $resourceGroupName -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'
7575
```
7676

77+
### Directly assign users to session hosts
78+
79+
#### [Azure portal](#tab/azure)
80+
81+
To directly assign a user to a session host in the Azure portal:
82+
83+
1. Sign in to the [Azure portal](https://portal.azure.com).
84+
85+
1. Enter **Azure Virtual Desktop** into the search bar.
86+
87+
1. Under **Services**, select **Azure Virtual Desktop**.
88+
89+
1. At the Azure Virtual Desktop page, go the menu on the left side of the window and select **Host pools**.
90+
91+
1. Select the host pool you want to assign users to.
92+
93+
1. Next, go to the menu on the left side of the window and select **Application groups**.
94+
95+
1. Select the name of the app group you want to assign users to, then select **Assignments** in the menu on the left side of the window.
96+
97+
1. Select **+ Add**, then select the users or user groups you want to assign to this app group.
98+
99+
1. Select **Assign VM** in the Information bar to assign a session host to a user.
100+
101+
1. Select the session host you want to assign to the user, then select **Assign**. You can also select **Assignment** > **Assign user**.
102+
103+
1. Select the user you want to assign the session host to from the list of available users.
104+
105+
1. When you're done, select **Select**.
106+
107+
#### [PowerShell](#tab/powershell)
108+
77109
To assign a user to a specific session host, run the following PowerShell cmdlet:
78110

79111
```powershell
80112
Update-AzWvdSessionHost -HostPoolName $hostPoolName -Name $sessionHostName -ResourceGroupName $resourceGroupName -AssignedUser <userupn>
81113
```
114+
---
82115

83-
To directly assign a user to a session host in the Azure portal:
116+
## Unassign a personal desktop
84117

85-
1. Sign in to the [Azure portal](https://portal.azure.com).
86-
2. Enter **Azure Virtual Desktop** into the search bar.
87-
3. Under **Services**, select **Azure Virtual Desktop**.
88-
4. At the Azure Virtual Desktop page, go the menu on the left side of the window and select **Host pools**.
89-
5. Select the host pool you want to assign users to.
90-
6. Next, go to the menu on the left side of the window and select **Application groups**.
91-
7. Select the name of the application group you want to assign users to, then select **Assignments** in the menu on the left side of the window.
92-
8. Select **+ Add**, then select the users or user groups you want to assign to this application group.
93-
9. Select **Assign VM** in the Information bar to assign a session host to a user.
94-
10. Select the session host you want to assign to the user, then select **Assign**. You can also select **Assignment** > **Assign user**.
95-
11. Select the user you want to assign the session host to from the list of available users.
96-
12. When you're done, select **Select**.
97-
98-
## Unassign a personal desktop using the Azure portal
118+
#### [Azure portal](#tab/azure)
99119

100120
To unassign a personal desktop in the Azure portal:
101121

102122
1. Sign in to the [Azure portal](https://portal.azure.com).
103-
2. Enter **Azure Virtual Desktop** into the search bar.
104-
3. Under **Services**, select **Azure Virtual Desktop**.
105-
4. At the Azure Virtual Desktop page, go the menu on the left side of the window and select **Host pools**.
106-
5. Select the host pool you want to modify user assignment for.
107-
6. Next, go to the menu on the left side of the window and select **Session hosts**.
108-
7. Select the checkbox next to the session host you want to unassign a user from, select the ellipses at the end of the row, and then select **Unassign user**. You can also select **Assignment** > **Unassign user**.
123+
124+
1. Enter **Azure Virtual Desktop** into the search bar.
125+
126+
1. Under **Services**, select **Azure Virtual Desktop**.
127+
128+
1. At the Azure Virtual Desktop page, go the menu on the left side of the window and select **Host pools**.
129+
130+
1. Select the host pool you want to modify user assignment for.
131+
132+
1. Next, go to the menu on the left side of the window and select **Session hosts**.
133+
134+
1. Select the checkbox next to the session host you want to unassign a user from, select the ellipses at the end of the row, and then select **Unassign user**. You can also select **Assignment** > **Unassign user**.
109135

110136
> [!div class="mx-imgBorder"]
111137
> ![A screenshot of the unassign user menu option from the ellipses menu for unassigning a personal desktop.](media/unassign.png)
112-
138+
113139
> [!div class="mx-imgBorder"]
114140
> ![A screenshot of the unassign user menu option from the assignment menu for unassigning a personal desktop.](media/unassign-2.png)
115141
116-
8. Select **Unassign** when prompted with the warning.
142+
1. Select **Unassign** when prompted with the warning.
117143

118-
## Unassign a personal desktop using PowerShell
144+
#### [PowerShell](#tab/powershell)
119145

120146
To unassign a personal desktop in PowerShell, run the following command:
121147

@@ -130,28 +156,38 @@ $unassignDesktopParams = @{
130156
}
131157
Invoke-AzRestMethod @unassignDesktopParams
132158
```
159+
---
133160

134-
## Reassign a personal desktop using the Azure portal
161+
## Reassign a personal desktop
162+
163+
#### [Azure portal](#tab/azure)
135164

136165
To reassign a personal desktop in the Azure portal:
166+
137167
1. Sign in to the [Azure portal](https://portal.azure.com).
138-
2. Enter **Azure Virtual Desktop** into the search bar.
139-
3. Under **Services**, select **Azure Virtual Desktop**.
140-
4. At the Azure Virtual Desktop page, go the menu on the left side of the window and select **Host pools**.
141-
5. Select the host pool you want to modify user assignment for.
142-
6. Next, go to the menu on the left side of the window and select **Session hosts**.
143-
7. Select the checkbox next to the session host you want to reassign to a different user, select the ellipses at the end of the row, and then select **Assign to a different user**. You can also select **Assignment** > **Assign to a different user**.
168+
169+
1. Enter **Azure Virtual Desktop** into the search bar.
170+
171+
1. Under **Services**, select **Azure Virtual Desktop**.
172+
173+
1. At the Azure Virtual Desktop page, go the menu on the left side of the window and select **Host pools**.
174+
1. Select the host pool you want to modify user assignment for.
175+
176+
1. Next, go to the menu on the left side of the window and select **Session hosts**.
177+
178+
1. Select the checkbox next to the session host you want to reassign to a different user, select the ellipses at the end of the row, and then select **Assign to a different user**. You can also select **Assignment** > **Assign to a different user**.
144179

145180
> [!div class="mx-imgBorder"]
146181
> ![A screenshot of the assign to a different user menu option from the ellipses menu for reassigning a personal desktop.](media/reassign-doc.png)
147182
148183
> [!div class="mx-imgBorder"]
149184
> ![A screenshot of the assign to a different user menu option from the assignment menu for reassigning a personal desktop.](media/reassign.png)
150185
151-
8. Select the user you want to assign the session host to from the list of available users.
152-
9. When you're done, select **Select**.
186+
1. Select the user you want to assign the session host to from the list of available users.
153187

154-
## Reassign a personal desktop using PowerShell
188+
1. When you're done, select **Select**.
189+
190+
#### [PowerShell](#tab/powershell)
155191

156192
Before you start, first define the `$reassignUserUpn` variable by running the following command:
157193

@@ -172,6 +208,7 @@ $reassignDesktopParams = @{
172208
}
173209
Invoke-AzRestMethod @reassignDesktopParams
174210
```
211+
---
175212

176213
## Give session hosts in a personal host pool a friendly name
177214

0 commit comments

Comments
 (0)