Skip to content

Commit 18db93b

Browse files
authored
Merge pull request #228418 from Heidilohr/work-apps-change3
Turning "app groups" into "application groups," "remote app groups" into "RemoteApp application groups."
2 parents 018cb51 + 5d68b20 commit 18db93b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+163
-163
lines changed

articles/virtual-desktop/app-attach-azure-portal.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -93,22 +93,22 @@ To publish the apps:
9393
2. Select the application group you want to publish the apps to.
9494

9595
>[!NOTE]
96-
>MSIX applications can be delivered with MSIX app attach to both remote app and desktop app groups. When a MSIX package is assigned to a remote app group and desktop app group from the same host pool the desktop app group will be displayed in the feed.
96+
>MSIX applications can be delivered with MSIX app attach to both remote app and desktop application groups. When a MSIX package is assigned to a RemoteApp application group and Desktop application group from the same host pool the Desktop application group will be displayed in the feed.
9797
98-
3. Once you're in the app group, select the **Applications** tab. The **Applications** grid will display all existing apps within the app group.
98+
3. Once you're in the application group, select the **Applications** tab. The **Applications** grid will display all existing apps within the application group.
9999

100100
4. Select **+ Add** to open the **Add application** tab.
101101

102102
> [!div class="mx-imgBorder"]
103103
> ![A screenshot of the user selecting + Add to open the add application tab](media/select-add.png)
104104
105105
5. For **Application source**, choose the source for your application.
106-
- If you're using a Desktop app group, choose **MSIX package**.
106+
- If you're using a Desktop application group, choose **MSIX package**.
107107

108108
> [!div class="mx-imgBorder"]
109109
> ![A screenshot of a customer selecting MSIX package from the application source drop-down menu. MSIX package is highlighted in red.](media/select-source.png)
110110
111-
- If you're using a remote app group, choose one of the following options:
111+
- If you're using a RemoteApp application group, choose one of the following options:
112112

113113
- Start menu
114114
- App path
@@ -122,16 +122,16 @@ To publish the apps:
122122

123123
- For **Description**, enter a short description of the app package.
124124

125-
- If you're using a remote app group, you can also configure these options:
125+
- If you're using a RemoteApp application group, you can also configure these options:
126126

127127
- **Icon path**
128128
- **Icon index**
129129

130130
6. When you're done, select **Save**.
131131

132-
## Assign a user to an app group
132+
## Assign a user to an application group
133133

134-
After assigning MSIX apps to an app group, you'll need to grant users access to them. You can assign access by adding users or user groups to an app group with published MSIX applications. Follow the instructions in [Manage app groups with the Azure portal](manage-app-groups.md) to assign your users to an app group.
134+
After assigning MSIX apps to an application group, you'll need to grant users access to them. You can assign access by adding users or user groups to an application group with published MSIX applications. Follow the instructions in [Manage application groups with the Azure portal](manage-app-groups.md) to assign your users to an application group.
135135

136136
## Change MSIX package state
137137

articles/virtual-desktop/app-attach-powershell.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Here's what you need to configure MSIX app attach:
1818

1919
- A functioning Azure Virtual Desktop deployment. To learn how to deploy Azure Virtual Desktop (classic), see [Create a tenant in Azure Virtual Desktop](./virtual-desktop-fall-2019/tenant-setup-azure-active-directory.md). To learn how to deploy Azure Virtual Desktop with Azure Resource Manager integration, see [Create a host pool with the Azure portal](./create-host-pools-azure-marketplace.md).
2020
- A Azure Virtual Desktop host pool with at least one active session host.
21-
- A Desktop remote app group.
21+
- A Desktop or RemoteApp application group.
2222
- The MSIX packaging tool.
2323
- An MSIX-packaged application expanded into an MSIX image that's uploaded into a file share.
2424
- A file share in your Azure Virtual Desktop deployment where the MSIX package will be stored.
@@ -190,42 +190,42 @@ To remove the package, run this cmdlet:
190190
Remove-AzWvdMsixPackage -FullName $obj.PackageFullName -HostPoolName $hp -ResourceGroupName $rg
191191
```
192192

193-
## Publish MSIX apps to an app group
193+
## Publish MSIX apps to an application group
194194

195-
You can only follow the instructions in this section if you've finished following the instructions in the previous sections. If you have a host pool with an active session host, at least one Desktop app group, and have added an MSIX package to the host pool, you're ready to go.
195+
You can only follow the instructions in this section if you've finished following the instructions in the previous sections. If you have a host pool with an active session host, at least one Desktop application group, and have added an MSIX package to the host pool, you're ready to go.
196196

197-
To publish an app from the MSIX package to an app group, you'll need to find its name, then use that name in the publishing cmdlet.
197+
To publish an app from the MSIX package to an application group, you'll need to find its name, then use that name in the publishing cmdlet.
198198

199199
To publish an app:
200200

201-
Run this cmdlet to list all available app groups:
201+
Run this cmdlet to list all available application groups:
202202

203203
```powershell
204204
Get-AzWvdApplicationGroup -ResourceGroupName $rg -SubscriptionId $subId
205205
```
206206

207-
When you've found the name of the app group you want to publish apps to, use its name in this cmdlet:
207+
When you've found the name of the application group you want to publish apps to, use its name in this cmdlet:
208208

209209
```powershell
210210
$grName = "<AppGroupName>"
211211
```
212212

213213
Finally, you'll need to publish the app.
214214

215-
- To publish MSIX application to a desktop app group, run this cmdlet:
215+
- To publish MSIX application to a desktop application group, run this cmdlet:
216216

217217
```powershell
218218
New-AzWvdApplication -ResourceGroupName $rg -SubscriptionId $subId -Name PowerBi -ApplicationType MsixApplication -ApplicationGroupName $grName -MsixPackageFamilyName $obj.PackageFamilyName -CommandLineSetting 0
219219
```
220220

221-
- To publish the app to a remote app group, run this cmdlet instead:
221+
- To publish the app to a RemoteApp application group, run this cmdlet instead:
222222

223223
```powershell
224224
New-AzWvdApplication -ResourceGroupName $rg -SubscriptionId $subId -Name PowerBi -ApplicationType MsixApplication -ApplicationGroupName $grName -MsixPackageFamilyName $obj.PackageFamilyName -CommandLineSetting 0 -MsixPackageApplicationId $obj.PackageApplication.AppId
225225
```
226226

227227
>[!NOTE]
228-
>If a user is assigned to both a remote app group and a desktop app group in the same host pool, when the user connects to their remote desktop, they will see MSIX apps from both groups.
228+
>If a user is assigned to both a RemoteApp application group and a desktop application group in the same host pool, when the user connects to their remote desktop, they will see MSIX apps from both groups.
229229
230230
## Next steps
231231

articles/virtual-desktop/automatic-migration.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Before you use the migration module, make sure you have the following things rea
3434
- PowerShell or PowerShell ISE to run the scripts you'll see in this article. The Microsoft.RdInfra.RDPowershell module doesn't work in PowerShell Core.
3535

3636
>[!IMPORTANT]
37-
>Migration only creates service objects in the US geography. If you try to migrate your service objects to another geography, it won't work. Also, if you have more than 500 app groups in your Azure Virtual Desktop (classic) deployment, you won't be able to migrate. You'll only be able to migrate if you rebuild your environment to reduce the number of app groups within your Azure Active Directory (Azure AD) tenant.
37+
>Migration only creates service objects in the US geography. If you try to migrate your service objects to another geography, it won't work. Also, if you have more than 500 application groups in your Azure Virtual Desktop (classic) deployment, you won't be able to migrate. You'll only be able to migrate if you rebuild your environment to reduce the number of application groups within your Azure Active Directory (Azure AD) tenant.
3838
3939
## Prepare your PowerShell environment
4040

@@ -164,8 +164,8 @@ To migrate your Azure virtual Desktop (classic) resources to Azure Resource Mana
164164

165165
You'll also need to specify a user assignment mode for the existing user assignments:
166166

167-
- Use **Copy** to copy all user assignments from your old app groups to Azure Resource Manager application groups. Users will be able to see feeds for both versions of their clients.
168-
- Use **None** if you don't want to change the user assignments. Later, you can assign users or user groups to app groups with the Azure portal, PowerShell, or API. Users will only be able to see feeds using the Azure Virtual Desktop (classic) clients.
167+
- Use **Copy** to copy all user assignments from your old application groups to Azure Resource Manager application groups. Users will be able to see feeds for both versions of their clients.
168+
- Use **None** if you don't want to change the user assignments. Later, you can assign users or user groups to application groups with the Azure portal, PowerShell, or API. Users will only be able to see feeds using the Azure Virtual Desktop (classic) clients.
169169

170170
You can only copy 2,000 user assignments per subscription, so your limit will depend on how many assignments are already in your subscription. The module calculates the limit based on how many assignments you already have. If you don't have enough assignments to copy, you'll get an error message that says "Insufficient role assignment quota to copy user assignments. Rerun command without the -CopyUserAssignments switch to migrate."
171171

@@ -179,20 +179,20 @@ To migrate your Azure virtual Desktop (classic) resources to Azure Resource Mana
179179

180180
- A resource group called "Tenantname," which contains your workspace.
181181

182-
- A resource group called "Tenantname_originalHostPoolName," which contains the host pool and desktop app groups.
182+
- A resource group called "Tenantname_originalHostPoolName," which contains the host pool and desktop application groups.
183183

184-
- Any users you published to the newly created app groups.
184+
- Any users you published to the newly created application groups.
185185

186186
- Virtual machines will be available in both existing and new host pools to avoid user downtime during the migration process. This lets users connect to the same user session.
187187

188188
Since these new Azure service objects are Azure Resource Manager objects, the module can't set Role-based Access Control (RBAC) permissions or diagnostic settings on them. Therefore, you'll need to update the RBAC permissions and settings for these objects manually.
189189

190-
Once the module validates the initial user connections, you can also publish the app group to more users or user groups, if you'd like.
190+
Once the module validates the initial user connections, you can also publish the application group to more users or user groups, if you'd like.
191191

192192
>[!NOTE]
193-
>After migration, if you move app groups to a different resource group after assigning permissions to users, it will remove all RBAC roles. You'll need to reassign users RBAC permissions all over again.
193+
>After migration, if you move application groups to a different resource group after assigning permissions to users, it will remove all RBAC roles. You'll need to reassign users RBAC permissions all over again.
194194
195-
4. If you want to delete all Azure Virtual Desktop (classic) service objects, run **Complete-RdsHostPoolMigration** to finish the migration process. This cmdlet will delete all Azure Virtual Desktop (classic) objects, leaving only the new Azure objects. Users will only be able to see the feed for the newly created app groups on their clients. Once this command is done, you can safely delete the Azure Virtual Desktop (classic) tenant to finish the process.
195+
4. If you want to delete all Azure Virtual Desktop (classic) service objects, run **Complete-RdsHostPoolMigration** to finish the migration process. This cmdlet will delete all Azure Virtual Desktop (classic) objects, leaving only the new Azure objects. Users will only be able to see the feed for the newly created application groups on their clients. Once this command is done, you can safely delete the Azure Virtual Desktop (classic) tenant to finish the process.
196196

197197
For example:
198198

@@ -206,7 +206,7 @@ To migrate your Azure virtual Desktop (classic) resources to Azure Resource Mana
206206
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
207207
```
208208
209-
This will delete all service objects created by Azure Virtual Desktop (classic). You will be left with just the new Azure objects and users will only be able to see the feed for the newly created app groups on their clients. Once you are done finalizing your migration, you need to explicitly delete the tenant in Azure Virtual Desktop (classic).
209+
This will delete all service objects created by Azure Virtual Desktop (classic). You will be left with just the new Azure objects and users will only be able to see the feed for the newly created application groups on their clients. Once you are done finalizing your migration, you need to explicitly delete the tenant in Azure Virtual Desktop (classic).
210210
211211
5. If you've changed your mind about migrating and want to revert the process, run the **Revert-RdsHostPoolMigration** cmdlet.
212212

articles/virtual-desktop/azure-ad-joined-session-hosts.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,14 +45,14 @@ You can deploy Azure AD-joined VMs directly from the Azure portal when you [crea
4545
4646
### Assign user access to host pools
4747

48-
After you've created your host pool, you must assign users access to their resources. To grant access to resources, add each user to the app group. Follow the instructions in [Manage app groups](manage-app-groups.md) to assign user access to apps and desktops. We recommend that you use user groups instead of individual users wherever possible.
48+
After you've created your host pool, you must assign users access to their resources. To grant access to resources, add each user to the application group. Follow the instructions in [Manage application groups](manage-app-groups.md) to assign user access to apps and desktops. We recommend that you use user groups instead of individual users wherever possible.
4949

5050
For Azure AD-joined VMs, you'll need to do two extra things on top of the requirements for Active Directory or Azure Active Directory Domain Services-based deployments:
5151

5252
- Assign your users the **Virtual Machine User Login** role so they can sign in to the VMs.
5353
- Assign administrators who need local administrative privileges the **Virtual Machine Administrator Login** role.
5454

55-
To grant users access to Azure AD-joined VMs, you must [configure role assignments for the VM](../active-directory/devices/howto-vm-sign-in-azure-ad-windows.md#configure-role-assignments-for-the-vm). You can assign the **Virtual Machine User Login** or **Virtual Machine Administrator Login** role either on the VMs, the resource group containing the VMs, or the subscription. We recommend assigning the Virtual Machine User Login role to the same user group you used for the app group at the resource group level to make it apply to all the VMs in the host pool.
55+
To grant users access to Azure AD-joined VMs, you must [configure role assignments for the VM](../active-directory/devices/howto-vm-sign-in-azure-ad-windows.md#configure-role-assignments-for-the-vm). You can assign the **Virtual Machine User Login** or **Virtual Machine Administrator Login** role either on the VMs, the resource group containing the VMs, or the subscription. We recommend assigning the Virtual Machine User Login role to the same user group you used for the application group at the resource group level to make it apply to all the VMs in the host pool.
5656

5757
## Access Azure AD-joined VMs
5858

articles/virtual-desktop/cli-powershell.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,4 +135,4 @@ Some PowerShell cmdlets require you to provide the object ID of Azure Virtual De
135135
Now that you know how to use Azure CLI and Azure PowerShell with Azure Virtual Desktop, here are some articles that use them:
136136

137137
- [Create an Azure Virtual Desktop host pool with PowerShell or the Azure CLI](create-host-pools-powershell.md)
138-
- [Manage app groups using PowerShell or the Azure CLI](manage-app-groups-powershell.md)
138+
- [Manage application groups using PowerShell or the Azure CLI](manage-app-groups-powershell.md)

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -88,8 +88,8 @@ To directly assign a user to a session host in the Azure portal:
8888
4. At the Azure Virtual Desktop page, go the menu on the left side of the window and select **Host pools**.
8989
5. Select the host pool you want to assign users to.
9090
6. Next, go to the menu on the left side of the window and select **Application groups**.
91-
7. 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.
92-
8. Select **+ Add**, then select the users or user groups you want to assign to this app group.
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.
9393
9. Select **Assign VM** in the Information bar to assign a session host to a user.
9494
10. Select the session host you want to assign to the user, then select **Assign**. You can also select **Assignment** > **Assign user**.
9595
11. Select the user you want to assign the session host to from the list of available users.

0 commit comments

Comments
 (0)