产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

将云配置迁移到本地

November 25, 2025
投稿者: 
C

本文介绍了如何备份云配置并将其迁移到本地站点。

迁移配置的必备条件

  • Citrix Virtual Apps and Desktops™ 本地环境，至少包含一个已注册的 VDA。
  • 在下面其中一个版本上运行的 Citrix Virtual Apps and Desktops 本地环境：
    • 最新的长期服务版本 (LTSR) - 2402。
    • 任意当前版本 (CR) - 2308、2311。
  • 在已加入域且安装了 .Net 4.7.2 或更高版本的计算机上运行自动配置工具 (ACT) 命令。
  • 安装了 Citrix PowerShell SDK 的计算机。 PowerShell SDK 可在 Citrix Delivery Controller™ 安装中使用。

注意：

  • 如果您在另一台计算机上运行 ACT，则必须加入域，并且 Studio 必须安装正确的 PowerShell 管理单元。 要获取安装程序，请转到 Citrix Virtual Apps and Desktops 下载 Web 站点。
  • 在本地站点中，我们建议在 Delivery Controller 上安装 ACT。 可以通过桌面图标启动 ACT。
  • 如果计划从标准 Powershell 窗口中使用 ACT，则必须执行以下命令：Import-Module Citrix.AutoConfig.Commands

ACT 不是系统 PowerShell 路径的一部分，因此必须明确导入

关键步骤

请按照说明完成将云配置迁移到本地的操作：

  1. 备份云配置
  2. 修改 YML 文件
  3. 将配置导入到本地

备份云配置

  1. 安装自动配置。
  2. 双击自动配置图标。 此时将显示 PowerShell 窗口。
  3. 运行 New-CvadAcCustomerInfoFile 以创建 CustomerInfo.yml 文件。 有关详细信息，请参阅填充客户信息文件。
  4. 运行命令 Backup-CvadAcToFile 以备份您的云配置。 > 注意： > > - 首次运行任意 cmdlet 后，都会创建一个包含 .yml 配置文件和日志的导出文件夹。 该文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig 中。 > - 如果遇到任何错误或异常，请参阅日志文件中的 Fixups 部分。 > - Backup-CvadToFile 不支持参数 IncludeByName 或 ExcludeByName。

重要：

Citrix 建议将所有组件一起备份。

修改 YML 文件

修改位于 %HOMEPATH%\Documents\Citrix\AutoConfig 下的 .yml 文件，以包含下表中所述的本地详细信息：

YML 文件 参数 说明 示例
CustomerInfo.yml Environment 将环境更改为本地。 环境参数值区分大小写。  
ZoneMapping.yml DaaS:CVAD 将您的云资源位置映射到本地区域。 它必须是 old:new 区域
CvadAcSecurity.yml Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ 添加虚拟机管理程序用户名和密码。 如果虚拟机管理程序为 XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

将配置导入到本地

  1. 根据您的要求，在您的本地站点中运行以下命令之一：
    1. Merge-CvadAcToSite - 如果有一个本地站点正在运行，并且您要将云配置合并到其中。
    2. Import-CvadAcToSite -Environment OnPrem - 如果本地配置不可用，并且您正在导入云配置以创建一个配置。

重要：

Citrix 建议一次导入一个组件以避免冲突。

将云配置迁移到本地
November 25, 2025
投稿者: 
C
November 25, 2025
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.