Merge pull request #291079 from dknappettmsft/avd-onedrive-remoteapp-updates

AVD OneDrive RemoteApp updates

Author: JamesJBarnett

articles/virtual-desktop/TOC.yml

@@ -310,7 +310,7 @@
             - name: Use Microsoft Teams
               displayName: applications, apps, webrtc
               href: teams-on-avd.md
-            - name: Use OneDrive with RemoteApp
+            - name: Launch OneDrive with RemoteApp
               displayName: applications, apps
               href: onedrive-remoteapp.md
     - name: Migrate from classic

articles/virtual-desktop/autoscale-create-assign-scaling-plan.md

@@ -484,7 +484,7 @@ To configure a time limit policy using Intune:
 
 To configure a time limit policy using Group Policy:
 
-1. Open the **Group Policy Management** console on device you use to manage the Active Directory domain.
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
 1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 

articles/virtual-desktop/clipboard-transfer-direction-data-types.md

@@ -98,9 +98,9 @@ To configure the clipboard using Group Policy in an Active Directory domain, fol
 
 1. Browse to one of the following policy sections. Use the policy section in **Computer Configuration** to the session host you target, and use the policy section in **User Configuration** applies to specific users you target.
 
-   - Machine: `Computer Configuration\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Device and Resource Redirection`
+   - Machine: `Computer Configuration\Policies\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Device and Resource Redirection`
 
-   - User: `User Configuration\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Device and Resource Redirection`
+   - User: `User Configuration\Policies\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Device and Resource Redirection`
 
    :::image type="content" source="media/redirection-remote-desktop-protocol/redirection-configuration-group-policy.png" alt-text="A screenshot showing the device and resource redirection options in the Group Policy editor.":::
 

articles/virtual-desktop/configure-rdp-shortpath.md

@@ -119,7 +119,7 @@ To enable the RDP Shortpath listener on your session hosts using Group Policy in
 
 1. Make the administrative template for Azure Virtual Desktop available in your domain by following the steps in [Use the administrative template for Azure Virtual Desktop](administrative-template.md?tabs=group-policy-domain).
 
-1. Open the **Group Policy Management** console on device you use to manage the Active Directory domain.
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
 1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 
@@ -408,7 +408,7 @@ To limit the port range used with STUN and TURN using Group Policy in an Active
 
 1. Make the administrative template for Azure Virtual Desktop available in your domain by following the steps in [Use the administrative template for Azure Virtual Desktop](administrative-template.md?tabs=group-policy-domain).
 
-1. Open the **Group Policy Management** console on device you use to manage the Active Directory domain.
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
 1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 

articles/virtual-desktop/graphics-chroma-value-increase-4-4-4.md

@@ -75,7 +75,7 @@ To increase the chroma value to 4:4:4 using Microsoft Intune:
 
 To increase the chroma value to 4:4:4 using Group Policy:
 
-1. Open the **Group Policy Management** console on device you use to manage the Active Directory domain.
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
 1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 

articles/virtual-desktop/graphics-enable-gpu-acceleration.md

@@ -158,7 +158,7 @@ To enable GPU-accelerated application rendering using Intune:
 
 To enable GPU-accelerated application rendering using Group Policy:
 
-1. Open the **Group Policy Management** console on device you use to manage the Active Directory domain.
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
 1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 

articles/virtual-desktop/media/onedrive-remoteapp/remote-session-environment-group-policy.png

@@ -125,7 +125,7 @@ Here's an example to migrate a specific MSIX package added to a host pool from M
    Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, Name
    ```
 
-   The output is similar to the following output:
+   The output is similar to the following example:
 
    ```output
    DisplayName Name

articles/virtual-desktop/msix-app-attach-migration.md

@@ -259,7 +259,7 @@ To enable the multimedia redirection browser extension using Group Policy:
 
 1. Download and install the Microsoft Edge administrative template by following the directions in [Configure Microsoft Edge policy settings on Windows devices](/deployedge/configure-microsoft-edge#1-download-and-install-the-microsoft-edge-administrative-template).
 
-1. Open the **Group Policy Management** console on device you use to manage the Active Directory domain.
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
 1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 
@@ -308,7 +308,7 @@ To enable the multimedia redirection browser extension using Group Policy:
        - **Local location**: `C:\Windows\PolicyDefinitions\en-US\`
        - **Central Store**: `\\contoso.com\SYSVOL\contoso.com\Policies\PolicyDefinitions\en-US`
 
-1. Open the **Group Policy Management** console on device you use to manage the Active Directory domain.
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
 1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 

articles/virtual-desktop/multimedia-redirection-video-playback-calls.md

@@ -1,22 +1,23 @@
 ---
-title: Use Microsoft OneDrive with a RemoteApp - Azure Virtual Desktop
-description: Learn how to use Microsoft OneDrive with a RemoteApp in Azure Virtual Desktop.
+title: Launch Microsoft OneDrive with a RemoteApp - Azure Virtual Desktop
+description: Learn how to launch Microsoft OneDrive with a RemoteApp in Azure Virtual Desktop.
 ms.topic: how-to
 author: dknappettmsft
 ms.author: daknappe
-ms.date: 09/09/2024
+ms.date: 11/26/2024
 ---
 
-# Use Microsoft OneDrive with a RemoteApp in Azure Virtual Desktop 
+# Launch Microsoft OneDrive with a RemoteApp in Azure Virtual Desktop 
 
-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.
+You can Launch 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.
 
-> [!IMPORTANT]
-> 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.
+In the settings for OneDrive, there's the option **Start OneDrive when I sign in to Windows**, which ordinarily starts OneDrive when a user signs in. However, this setting doesn't work with RemoteApp in Azure Virtual Desktop. Instead, you configure OneDrive to launch by configuring a registry value. You also enable an enhanced shell experience for RemoteApp sessions, offering support for default file associations, `Run/RunOnce` registry keys, and more.
+
+This article describes how to configure OneDrive to automatically launch alongside a RemoteApp in Azure Virtual Desktop.
 
 ## User experience
 
-Once configured, when a user launches a RemoteApp, the OneDrive icon is integrated in the taskbar of their local Windows device. If a user launches another RemoteApp from the same host pool on the same session host, the same instance of OneDrive is used and another doesn't start.
+When a user launches a RemoteApp, OneDrive is also launched and the OneDrive icon is integrated in the taskbar of their local Windows device. If a user launches another RemoteApp from the same host pool on the same session host, it uses the same instance of OneDrive and another doesn't start.
 
 If your session hosts are joined to Microsoft Entra ID, you can [silently configure user accounts](/sharepoint/use-silent-account-configuration) so users are automatically signed in to OneDrive and start synchronizing straight away. Otherwise, users need to sign in to OneDrive on first use.
 
@@ -26,52 +27,72 @@ When a user closes or disconnects from the last RemoteApp they're using on the s
 
 ## Prerequisites
 
-Before you can use OneDrive with a RemoteApp in Azure Virtual Desktop, you need:
+Before you can use OneDrive with a RemoteApp in Azure Virtual Desktop:
 
-- Session hosts in a host pool that:
+- Your session hosts must be running Windows 11 Enterprise, version 22H2 or 23H2 with the [2024-07 Cumulative Update for Windows 11 (KB5040442)](https://support.microsoft.com/kb/KB5040442) or later installed.
 
-    - 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.
-    
-    - Have the latest version of FSLogix installed. For more information, see [Install FSLogix applications](/fslogix/how-to-install-fslogix).
+- If you're using FSLogix, install the latest version of FSLogix on your session hosts. For more information, see [Install FSLogix applications](/fslogix/how-to-install-fslogix).
+
+- Use Windows App on Windows or the Remote Desktop client on Windows to connect to a remote session. Other platforms aren't supported.
 
 ## Configure OneDrive to launch with a RemoteApp
 
-To configure OneDrive to launch with a RemoteApp in Azure Virtual Desktop, follow these steps:
+To configure OneDrive to launch with a RemoteApp in Azure Virtual Desktop, you need to enable an enhanced shell experience for RemoteApp sessions using Group Policy and set a registry value to launch OneDrive when a user connects to a RemoteApp. The Group Policy setting isn't available in Microsoft Intune.
 
 1. Download and install the latest version of the [OneDrive sync app](https://www.microsoft.com/microsoft-365/onedrive/download) per-machine on your session hosts. For more information, see [Install the sync app per-machine](/sharepoint/per-machine-installation).
 
 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.
 
-1. On your session hosts:
+1. The Group Policy settings are only available in Windows 11, version 22H2 or 23H2 with the [2024-07 Cumulative Update for Windows 11 (KB5040442)](https://support.microsoft.com/kb/KB5040442) or later installed. You need to copy the administrative template files `C:\Windows\PolicyDefinitions\terminalserver.admx` and `C:\Windows\PolicyDefinitions\en-US\terminalserver.adml` from a session host to the same location on your domain controllers or the [Group Policy Central Store](/troubleshoot/windows-client/group-policy/create-and-manage-central-store), depending on your environment. In the file path for `terminalserver.adml` replace `en-US` with the appropriate language code if you're using a different language.
 
-    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. 
+1. Open the **Group Policy Management** console on a device you use to manage the Active Directory domain.
 
-    2. Set the following policy: 
-    
-          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 
+1. Create or edit a policy that targets the computers providing a remote session you want to configure.
 
-    3. Set the following registry value:
+1. Navigate to **Computer Configuration** > **Policies** > **Administrative Templates** > **Windows Components** > **Remote Desktop Services** > **Remote Desktop Session Host** > **Remote Session Environment**.
 
-       - **Key**: `HKLM\Software\Microsoft\Windows\CurrentVersion\Run`
-       - **Type**: `REG_SZ`
-       - **Name**: `OneDrive`
-       - **Data**: `"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background`
+   :::image type="content" source="media/onedrive-remoteapp/remote-session-environment-group-policy.png" alt-text="A screenshot showing the remote session environment options in the Group Policy editor." lightbox="media/onedrive-remoteapp/remote-session-environment-group-policy.png":::
 
-       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:
-    
-       ```powershell
-       New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" -Name OneDrive -PropertyType String -Value '"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background' -Force
-       ```
+1. Double-click the policy setting **Enable enhanced shell experience for RemoteApp** to open it. Select **Enabled**, then select **OK**. 
+
+1. Set the following registry value:
+
+   - **Key**: `HKLM\Software\Microsoft\Windows\CurrentVersion\Run`
+   - **Type**: `REG_SZ`
+   - **Name**: `OneDrive`
+   - **Data**: `"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background`
+
+   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:
+
+   ```powershell
+   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" -Name OneDrive -PropertyType String -Value '"C:\Program Files\Microsoft OneDrive\OneDrive.exe" /background' -Force
+   ```
 
-    4. Ensure the Stack on the session host is version 2404.16770 or higher.
+1. Ensure the side-by-side stack on the session host is version 1.0.2404.16770 or higher. To check the version, run the following command from Command Prompt or PowerShell.
+
+   ```cmd
+   qwinsta
+   ```
 
-    5. Reboot your session host.
+   The output includes a line beginning with `rdp-sxs` followed by a number, where the number correlates to the version number of the side-by-side stack, as shown in the following example. You can find a list of the version numbers at [What's new in the Azure Virtual Desktop SxS Network Stack](whats-new-sxs.md).
+
+   ```output
+   SESSIONNAME               USERNAME                 ID  STATE   TYPE        DEVICE
+   services                                            0  Disc
+   console                                             1  Conn
+   rdp-tcp                                         65537  Listen
+   rdp-sxs240705700                                65538  Listen
+   ```
+
+1. Restart the session hosts to apply the changes.
 
 ## Test OneDrive with a RemoteApp
 
 To test OneDrive with a RemoteApp, follow these steps:
 
-1. Connect to a RemoteApp from the host pool and check that the OneDrive icon can be seen on the task bar of your local Windows device.
+1. Use a supported version of Windows App or the Remote Desktop client to connect to a RemoteApp from the host pool withe the session hosts you configured.
+
+1. Check that the OneDrive icon can be seen on the task bar of your local Windows device. Hover over the icon to show the tooltip and ensure it includes the word **Remote**, which differentiates it from a local instance of OneDrive.
 
 1. Check that OneDrive is synchronizing files by opening the OneDrive Action Center. Sign in to OneDrive if you weren't automatically signed in.