Upravit

Sdílet prostřednictvím

Use the sync app on virtual desktops

For all supported operating systems, the OneDrive sync app supports:

  • Virtual desktops that persist between sessions.
  • Non-persistent virtual desktops that use Azure Virtual Desktop.
  • Non-persistent virtual desktops that have FSLogix Apps or FSLogix Office Container, and a Microsoft 365 subscription for all of the following operating systems:
    • Windows 10 and 11, 32-bit or 64-bit (supports VMDK/Virtual Machine Disk files)
    • Windows Server 2022 (supports VHDX/Virtual Hard Disk)
    • Windows Server 2019 (supports VHDX/Virtual Hard Disk)
    • Windows Server 2016 (supports VHDX/Virtual Hard Disk)
    • Windows Server 2012 R2 (supports VHDX/Virtual Hard Disk)

Note

It is not supported to roam the OneDrive registry hive as part of a non-persistent VDI environment. Do not roam HKEY_CURRENT_USER\Software\Microsoft\OneDrive\ in your non-persistent VDI user profiles.

Note

The minimum supported versions are: OneDrive 19.174.0902.0013 and FSLogix Apps 2.9.7653.47581.

Using the OneDrive sync app with non-persistent environments requires that you install the sync app per machine.

For Windows Server, the SMB network file sharing protocol is also required.

The OneDrive sync app is supported in a remote app scenario hosted as a Citrix Virtual App.

The OneDrive sync app with FSLogix does not support running multiple instances of the same container simultaneously.

Set up OneDrive in Citrix Virtual Apps

This section describes how to enable and use OneDrive in Citrix Virtual Apps.

Prerequisites

To enable OneDrive in Citrix Virtual Apps, you must have the following versions of Windows and Citrix Virtual Apps and Desktops (CVAD):

Windows:

  • Windows 11: KB5014019
  • Windows Server 2022: KB5014021
  • Windows 10: KB5014023
  • Windows Server 2019: KB5014022

Citrix:

  • CVAD 7 2203 LTSR/Long Tern Service Release CU1 or later.

  • VDA/Virtual Delivery Agent 2212 enables Shellbridge by default. All earlier versions require Shellbridge to be enabled manually.

  • To enable this feature, On 2203 LTSR TS VDA (2019 Server, 2022 Server, Windows 10 RDSH/Remote Desktop Session Host, or Windows 11 RDSH/Remote Desktop Service Host) add the following registry details:

    • HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Citrix Virtual Desktop Agent
    • Name: Shellbridge
    • Type: REG_DWORD
    • Value: 1

To ensure that the feature is correctly enabled, open a command window (cmd.exe) and run start ms-settings:printers. If the feature is enabled, the printer setting window is displayed.

We recommend adding OneDrive.exe to LogoffCheckSysModules.

  • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI
  • Value Name:LogoffCheckSysModules
  • Type:REG_SZ
  • String:OneDrive.exe, Microsoft.Sharepoint.exe

Important

FSLogix must be used in conjunction with Citrix Virtual Apps for OneDrive to be supported.

How to set up OneDrive

  1. Install OneDrive Sync app per machine. See Install the sync app per-machine.

  2. Install the latest version of FSLogix. See Install FSLogix Applications.

    Note

    All non-persistent VDI environments require the latest version of FSLogix. Ensure you install the latest version. See OneDrive sync error FSLogix_unsupported_environment on VMs.

  3. Add OneDrive to HKLM\Software\Microsoft\Windows\CurrentVersion\ by using the following command:

    REG ADD HKLM\Software\Microsoft\Windows\CurrentVersion\Run /v OneDrive /t REG_SZ /d "\"C:\Program Files\Microsoft OneDrive\OneDrive.exe\" /background"

  4. Silently configure user accounts. See Silently configure user accounts.

    Note

    Silent sign-in should work if your machine is connected to Microsoft Entra ID. Make sure to turn off this setting if your computer is not Microsoft Entra joined.

Set up OneDrive in Omnissa Horizon Virtual Apps

This section describes how to enable and use OneDrive in Omnissa Horizon Virtual Apps.

Prerequisites

  • Omnissa Horizon

  • Windows

    • Windows 10 and Windows 11 Guest Operating Systems for Horizon Agent and Remote Experience, for Omnissa Horizon 8.x (2006 and later) (78714)

    • Non-Windows 10 and 11 Guest Operating Systems for Horizon 8 Agent (78715)

  • FSLogix

  • Omnissa Dynamic Environment Manager (DEM) or a product which enables user environment personalization. The system on which you plan to install DEM must meet certain software requirements. For more info refer to this article.

Registry Keys

The following registry keys help to roam the user environment on multiple nodes in the virtual application farm. Omnissa Dynamic Environment Manager or a similar user environment management tool can be used to deploy the registry keys to all farm servers.

  • [IncludeRegistryTrees]

    • HKCU\Software\Microsoft\Office

    • HKCU\Software\Microsoft\Internet Explorer

    • HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings

    • HKCU\Software\Microsoft\Windows\CurrentVersion\Shell Extensions\Cached

    • HKCU\Software\Microsoft\OneDrive

  • [IncludeFolderTrees]

    • <Appdata>\Microsoft\Windows\Recent

    • <Appdata>\Microsoft\crypto

    • <Appdata>\SystemCertificates

    • <LocalAppdata>\Microsoft\IdentityCache

    • <LocalAppdata>\Microsoft\Internet Explorer

    • <LocalAppdata>\Microsoft\Windows\INetCache

Configure Omnissa Dynamic Environment Manager with Horizon Apps

  1. Launch the Omnissa Dynamic Environment Manager management console, select Create Config File and select Use an Application Template.

  2. Select the application template (Microsoft Office 2016 and 2019, or Microsoft 365), Select OneDrive for Business and click Next.

  3. Provide the file name and description and select Finish.

  4. Add the previously listed required registry keys to Import / Export settings.

Configure FSLogix with Omnissa Dynamic Environment Manager

Configuring FSLogix in combination with Dynamic Environment Manager will help with store OneDrive cache and the save location for Microsoft and non-Microsoft applications.

For more info on how to configure FSLogix Office Container (ODFC) on all Horizon Virtual App farm servers, refer to this article.

  • Install the per-machine version of the OneDrive sync app on all the Horizon Virtual App farm hosts.

  • Create the following entries in each Horizon farm servers. You can use DEM or similar user environment management tool to deploy the registry to all virtual app farm servers.

    • Key: HKLM\Software\Microsoft\Windows\CurrentVersion\Run

    • Type: REG_SZ

    • Name: OneDrive

    • Data: "C:\Program Files\Microsoft OneDrive\OneDrive.exe"/background

    • Key: HKLM\Software\Policies\Microsoft\OneDrive

    • Type: REG_DWORD

    • Name: SilentAccountconfig

    • Data: 1

Note

Sometimes the silent login will take several seconds. If the first attempt fails, a second attempt might be required.

See also

Learn more about VHDX/Virtual Hard Disk and VHD/Virtual Hard Disk.

For info about creating virtual hard disks, see Manage virtual hard disks.