在虚拟桌面上使用同步应用

对于所有受支持的操作系统,OneDrive 同步应用支持:

  • 在会话之间持久存在的虚拟桌面。
  • 使用 Azure 虚拟桌面的非持久性虚拟桌面。
  • 具有 FSLogix 应用 或 FSLogix Office 容器,以及适用于以下所有操作系统的 Microsoft 365 订阅的非持久性虚拟桌面:
    • Windows 11、32 位或 64 位 (支持 VMDK/虚拟机磁盘文件)
    • Windows Server 2025 或更高版本 (支持 VHDX/虚拟硬盘)

注意

通过以下链接查看最新版本: OneDrive、FSLogix 应用 在非持久环境中使用 OneDrive 同步应用需要每台计算机安装同步应用。 对于 Windows Server,还需要 SMB 网络文件共享协议。 OneDrive 同步应用在作为 Citrix 虚拟应用托管的远程应用方案中受支持。 带有 FSLogix 的 OneDrive 同步应用不支持同时运行同一容器的多个实例。

在 Citrix Virtual Apps 中设置 OneDrive

本节介绍如何在 Citrix Virtual Apps 中启用和使用 OneDrive。

先决条件

要在 Citrix Virtual Apps 中启用 OneDrive,您必须具有以下版本的 Windows 和 Citrix Virtual Apps and Desktops (CVAD) :

Windows:

  • Windows 11
  • Windows Server 2025

Citrix 中的数据:

  • CVAD 7 2203 LTSR/长期服务版本 CU1 或更高版本。

  • 默认情况下,VDA/Virtual Delivery Agent 2212 启用 Shellbridge。 所有早期版本都需要手动启用 Shellbridge。

  • 若要启用此功能,在 2203 LTSR TS VDA (2019 服务器、2022 服务器、Windows 10 RDSH/远程桌面会话主机或 Windows 11 RDSH/远程桌面服务主机上) 添加以下注册表详细信息:

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

要确保正确启用该功能,请打开命令窗口 (cmd.exe) 并运行 start ms-settings:printers。 如果启用该功能,将显示打印机设置窗口。

建议将 OneDrive.exe LogoffCheckSysModules添加到.

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

重要

若要支持 OneDrive,必须将 FSLogix 与 Citrix Virtual Apps 结合使用。

如何设置 OneDrive

  1. 每台计算机安装 OneDrive 同步应用。 请参阅 每台计算机安装同步应用。

  2. 安装最新版本的 FSLogix。 请参阅 安装 FSLogix 应用程序。

    注意

    所有非持久性 VDI 环境都需要最新版本的 FSLogix。 确保安装最新版本。 请参阅OneDrive 同步 VM 上的错误FSLogix_unsupported_environment。

  3. 使用以下命令将 OneDrive HKLM\Software\Microsoft\Windows\CurrentVersion\ 添加到:

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

  4. 无提示配置用户帐户。 请参阅 无提示配置用户帐户。

    注意

    如果计算机连接到 Microsoft Entra ID,则静默登录应正常工作。 如果你的计算机未加入 Microsoft Entra,请确保关闭此设置。

在 Omnissa Horizon Virtual Apps 中设置 OneDrive

本节介绍如何在 Omnissa Horizon Virtual Apps 中启用和使用 OneDrive。

先决条件

  • Omnissa Horizon

  • Windows

    • 适用于 Omnissa Horizon 8.x (2006 及更高) (版本 78714) 的 Horizon Agent 和远程体验Windows 10和Windows 11来宾操作系统。 有关更多信息,请参阅本文章。

    • Horizon 8 代理 (78715) 的非Windows 10和 11 来宾操作系统。 有关更多信息,请参阅本文章。

  • FSLogix

  • Omnissa Dynamic Environment Manager (DEM) 或支持用户环境个性化的产品。 计划在上面安装 DEM 的系统必须满足某些软件要求。 有关更多信息,请参阅本文章。

注册表项

以下注册表项有助于在虚拟应用程序场中的多个节点上漫游用户环境。 可以使用 Omnissa 动态环境管理器或类似的用户环境管理工具将注册表项部署到所有场服务器。

  • [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

使用 Horizon Apps 配置 Omnissa 动态环境管理器

  1. 启动 Omnissa Dynamic Environment Manager 管理控制台,选择创建配置文件,然后选择使用应用程序模板。

  2. 选择应用程序模板 (Microsoft Office 2016 和 2019 或 Microsoft 365) ,选择OneDrive for Business,然后单击“下一步”。

  3. 提供文件名和说明,然后选择“ 完成”。

  4. 将先前列出的 必需注册表项 添加到 导入/导出 设置。

使用 Omnissa 动态环境管理器配置 FSLogix

将 FSLogix 与动态环境管理器结合使用将有助于存储 OneDrive 缓存以及 Microsoft 和非 Microsoft 应用程序的保存位置。

有关如何在所有 Horizon 虚拟应用场服务器上配置 FSLogix Office 容器 (ODFC) 的详细信息,请参阅 本文。

  • 在所有 Horizon 虚拟应用场主机上安装 OneDrive 同步应用的每台计算机版本。

  • 在每个 Horizon 场服务器中创建以下条目。 可以使用 DEM 或类似的用户环境管理工具将注册表部署到所有虚拟应用场服务器。

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

    • 类型: REG_SZ

    • 名称:OneDrive

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

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

    • 类型: REG_DWORD

    • 名称:SilentAccountconfig

    • 数据: 1

注意

有时,静默登录需要几秒钟时间。 如果第一次尝试失败,则可能需要第二次尝试。

另请参阅

详细了解 VHDX/虚拟硬盘 和 VHD/虚拟硬盘。

有关创建虚拟硬盘的信息,请参阅管理虚拟硬盘。