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

将云配置迁移到本地

March 18, 2026
投稿者: 
C

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

迁移配置的先决条件

  • 具有至少一个已注册 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 安装在 Delivery Controller 上。ACT 可以通过桌面图标启动。
  • 如果打算从标准 PowerShell 窗口使用 ACT，则必须执行以下命令： Import-Module Citrix.AutoConfig.Commands

ACT 不属于系统 PowerShell 路径，因此必须显式导入。

主要步骤

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

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

备份云配置

  1. 安装 自动化配置。
  2. 运行 New-CvadAcCustomerInfoFile 以创建 CustomerInfo.yml 文件。有关详细信息，请参阅填充客户信息文件。
  3. 运行命令 Backup-CvadAcToFile 以备份您的云配置。

    注意：

    • 首次运行任何 cmdlet 后，将创建一个包含 .yml 配置文件和日志的导出文件夹。该文件夹位于 %HOMEPATH%\Documents\Citrix\AutoConfig。
    • 如果遇到任何错误或异常，请参阅日志文件中的 Fixups 部分。
    • Backup-CvadToFile 不支持 IncludeByName 或 ExcludeByName 参数。

重要提示：

Citrix 建议同时备份所有组件。

修改 YML 文件

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

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

将配置导入本地

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

重要提示：

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

将云配置迁移到本地
March 18, 2026
投稿者: 
C
March 18, 2026
投稿者: 
C

在本文中

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