将云配置迁移到本地

Last published : Oct 24, 2026
本文介绍了如何备份您的云配置并将其迁移到本地站点。
Related information
迁移配置到 Citrix Cloud™

迁移配置的先决条件

  • 具有至少一个已注册 VDA 的 Citrix Virtual Apps and Desktops™ 本地环境。
  • 运行以下版本之一的 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下载网站。
  • 在本地站点中，我们建议将 ACT 安装在 DDC 上。ACT 可以通过桌面图标启动。
  • 如果打算从标准 Powershell 窗口使用 ACT，请运行以下命令： Import-Module Citrix.AutoConfig.Commands
ACT 不属于系统 PowerShell 路径的一部分，因此必须显式导入。

主要步骤

请按照说明完成将您的云配置迁移到本地环境的操作：
  1. 备份云配置。
  2. 修改 YML 文件。
  3. 将配置导入到本地环境。

备份云配置

  1. 安装 自动化配置。
  2. 双击 Auto Config 图标。将显示一个 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 更改为 OnPrem。环境参数值区分大小写。
ZoneMapping.yml DaaS:CVAD 将您的云资源位置映射到您的本地区域。 它必须是旧区域:新区域
CvadAcSecurity.yml 管理程序: 连接类型: ‘ ‘ 用户名: ‘ ’ 密码: ‘ ‘ 添加管理程序用户名和密码。 如果管理程序是 XenServer，XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

将配置导入到本地

  1. 根据您的要求，在本地站点中运行以下任一命令：
    1. Merge-CvadAcToSite - 如果存在正在运行的本地站点，并且您希望将云配置合并到其中。
    2. Import-CvadAcToSite -Environment OnPrem - 如果本地配置不可用，并且您正在导入云配置以创建一个新的本地配置。
重要提示：
Citrix 建议一次导入一个组件，以避免冲突。