Citrix Virtual Apps and Desktops

将云配置迁移到本地部署环境

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

迁移您的配置所需的先决条件

  • 思杰虚拟应用和桌面™ 本地环境,至少包含一个已注册的 VDA。
  • 运行以下版本之一的思杰虚拟应用和桌面™ 本地环境:
    • 最新的长期服务版本 (LTSR) - 2402。
    • 任何当前版本 (CR) - 2308、2311。
  • 在已加入域的计算机上运行自动化配置工具 (ACT) 命令,并安装 .Net 4.7.2 或更高版本。
  • A machine with the Citrix PowerShell SDK. PowerShell SDK is available within the Citrix Delivery Controller™ installable.

注意:

  • 如果您在其他计算机上运行 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 does not support the parameters IncludeByName or ExcludeByName.

重要提示:

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

修改 YML 文件

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

YML 文件 参数名称 详细描述 示例
客户信息.yml 部署环境 将 Environment 更改为 OnPrem。环境参数值区分大小写。  
区域映射.yml DaaS:CVAD 将您的云资源位置映射到您的本地区域。 必须是旧区域:新区域
Citrix 虚拟应用和桌面访问控制安全.yml 管理程序: 连接类型: ‘ ‘ 用户名: ‘ ’ 密码: ‘ ‘ 添加管理程序用户名和密码。 If the hypervisor is XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

将配置导入到本地部署环境

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

重要提示:

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

将云配置迁移到本地部署环境