Citrix Virtual Apps and Desktops

将云配置迁移到本地部署

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

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

  • Citrix 虚拟应用和桌面™ 本地部署环境,其中至少包含一个已注册的 VDA。
  • 运行以下版本之一的 Citrix 虚拟应用和桌面 本地部署环境:
    • 最新的长期服务版本 (LTSR) - 2402。
    • 任何当前版本 (CR) - 2308、2311。
  • 在已加入域的计算机上运行自动化配置工具 (ACT) 命令,并安装 .Net 4.7.2 或更高版本。
  • 一台安装了 Citrix PowerShell 软件开发工具包的计算机。PowerShell 软件开发工具包包含在 Citrix Delivery 控制器™ 安装程序中。

注意:

  • 如果您在其他计算机上运行 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。环境参数值区分大小写。  
ZoneMapping.yml DaaS:CVAD 将您的云资源位置映射到您的本地区域。 必须是旧:新区域
CvadAcSecurity.yml 虚拟机监控程序: 连接类型: ‘ ‘ 用户名: ‘ ’ 密码: ‘ ‘ 添加管理程序用户名和密码。 如果管理程序是 XenServer,则 XenServer 的连接类型为 ‘XenServer’,用户名为 ‘root’,密码为 ‘ ‘

将配置导入到本地部署

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

重要提示:

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

将云配置迁移到本地部署