Skip to content

Commit ea9511b

Browse files
authored
Merge pull request #286454 from sipastak/avd-onedrive-ga
OneDrive support for AVD RemoteApps GA
2 parents a339335 + 6ffb82f commit ea9511b

File tree

1 file changed

+29
-25
lines changed

1 file changed

+29
-25
lines changed

articles/virtual-desktop/onedrive-remoteapp.md

Lines changed: 29 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -4,21 +4,15 @@ description: Learn how to use Microsoft OneDrive with a RemoteApp in Azure Virtu
44
ms.topic: how-to
55
author: dknappettmsft
66
ms.author: daknappe
7-
ms.date: 10/11/2023
7+
ms.date: 09/09/2024
88
---
99

10-
# Use Microsoft OneDrive with a RemoteApp in Azure Virtual Desktop (preview)
10+
# Use Microsoft OneDrive with a RemoteApp in Azure Virtual Desktop
1111

12-
> [!IMPORTANT]
13-
> Using Microsoft OneDrive with a RemoteApp in Azure Virtual Desktop is currently in PREVIEW.
14-
> 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.
15-
16-
You can use Microsoft OneDrive alongside a RemoteApp in Azure Virtual Desktop (preview), allowing users to access and synchronize their files while using a RemoteApp. When a user connects to a RemoteApp, OneDrive can automatically launch as a companion to the RemoteApp. This article describes how to configure OneDrive to automatically launch alongside a RemoteApp in Azure Virtual Desktop.
12+
You can use Microsoft OneDrive alongside a RemoteApp in Azure Virtual Desktop, allowing users to access and synchronize their files while using a RemoteApp. When a user connects to a RemoteApp, OneDrive can automatically launch as a companion to the RemoteApp. This article describes how to configure OneDrive to automatically launch alongside a RemoteApp in Azure Virtual Desktop.
1713

1814
> [!IMPORTANT]
19-
> - You should only use OneDrive with a RemoteApp for testing purposes as it requires an Insider Preview build of Windows 11 for your session hosts.
20-
>
21-
> - You can't use the setting **Start OneDrive automatically when I sign in to Windows** in the OneDrive preferences, which starts OneDrive when a user signs in. Instead, you need to configure OneDrive to launch by configuring a registry value, which is described in this article.
15+
> You can't use the setting **Start OneDrive automatically when I sign in to Windows** in the OneDrive preferences, which starts OneDrive when a user signs in. Instead, you need to configure OneDrive to launch by configuring a registry value, which is described in this article.
2216
2317
## User experience
2418

@@ -34,13 +28,11 @@ When a user closes or disconnects from the last RemoteApp they're using on the s
3428

3529
Before you can use OneDrive with a RemoteApp in Azure Virtual Desktop, you need:
3630

37-
- A pooled host pool that is configured as a [validation environment](configure-validation-environment.md).
38-
39-
- Session hosts in the host pool that:
31+
- Session hosts in a host pool that:
4032

41-
- Are running Windows 11 Insider Preview Enterprise multi-session, version 22H2, build 25905 or later. To get Insider Preview builds for multi-session, you need to start with a non-Insider build, join session hosts to the Windows Insider Program, then install the preview build. For more information on the Windows Insider Program, see [Get started with the Windows Insider Program](/windows-insider/get-started) and [Manage Insider Preview builds across your organization](/windows-insider/business/manage-builds). Intune [doesn't support update rings with multi-session](/mem/intune/fundamentals/azure-virtual-desktop-multi-session#additional-configurations-that-arent-supported-on-windows-10-or-windows-11-enterprise-multi-session-vms).
42-
43-
- Have the latest version of FSLogix installed. For more information, see [Install FSLogix applications](/fslogix/how-to-install-fslogix).
33+
- Are running Windows 11, version 23H2 with cumulative and noncumulative updates for Windows 11 ([KB5039302](https://support.microsoft.com/en-us/topic/june-25-2024-kb5039302-os-builds-22621-3810-and-22631-3810-preview-0ab34e3f-bca9-4a52-a1a4-404bf8162f58)) or later installed.
34+
35+
- Have the latest version of FSLogix installed. For more information, see [Install FSLogix applications](/fslogix/how-to-install-fslogix).
4436

4537
## Configure OneDrive to launch with a RemoteApp
4638

@@ -50,18 +42,30 @@ To configure OneDrive to launch with a RemoteApp in Azure Virtual Desktop, follo
5042

5143
1. If your session hosts are joined to Microsoft Entra ID, [silently configure user accounts](/sharepoint/use-silent-account-configuration) for OneDrive on your session hosts, so users are automatically signed in to OneDrive.
5244

53-
1. On your session hosts, set the following registry value:
45+
1. On your session hosts:
46+
47+
1. Install the latest Windows Update (ensure that [KB Article 5039302](https://support.microsoft.com/en-us/topic/june-25-2024-kb5039302-os-builds-22621-3810-and-22631-3810-preview-0ab34e3f-bca9-4a52-a1a4-404bf8162f58) is included) on the session host.
48+
49+
2. Set the following policy:
50+
51+
Local Computer Policy\Computer Configuration\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Remote Session Environment\Enable enhanced shell experience for RemoteApp
52+
53+
3. Set the following registry value:
5454

55-
- **Key**: `HKLM\Software\Microsoft\Windows\CurrentVersion\Run`
56-
- **Type**: `REG_SZ`
57-
- **Name**: `OneDrive`
58-
- **Data**: `"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background`
55+
- **Key**: `HKLM\Software\Microsoft\Windows\CurrentVersion\Run`
56+
- **Type**: `REG_SZ`
57+
- **Name**: `OneDrive`
58+
- **Data**: `"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background`
5959

60-
You can configure the registry using an enterprise deployment tool such as Intune, Configuration Manager, or Group Policy. Alternatively, to set this registry value using PowerShell, open PowerShell as an administrator and run the following command:
60+
You can configure the registry using an enterprise deployment tool such as Intune, Configuration Manager, or Group Policy. Alternatively, to set this registry value using PowerShell, open PowerShell as an administrator and run the following command:
61+
62+
```powershell
63+
New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" -Name OneDrive -PropertyType String -Value '"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background' -Force
64+
```
65+
66+
4. Ensure the Stack on the session host is version 2404.16770 or higher.
6167
62-
```powershell
63-
New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" -Name OneDrive -PropertyType String -Value '"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background' -Force
64-
```
68+
5. Reboot your session host.
6569
6670
## Test OneDrive with a RemoteApp
6771

0 commit comments

Comments
 (0)