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

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

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

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

注意：

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

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

主要步骤

请遵循以下说明，以顺利完成您的云配置到本地部署环境的迁移：

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

对云端配置进行备份

1. 安装 (/zh-cn/citrix-virtual-apps-desktops/manage-deployment/migrate.html#download-automated-configuration) 自动化配置。
2. 双击 Auto Config 图标。一个 PowerShell 窗口将会自动弹出。
3. 运行 New-CvadAcCustomerInfoFile 以创建 CustomerInfo.yml 文件。有关详细信息，请参阅 (/zh-cn/citrix-virtual-apps-desktops/manage-deployment/migrate.html#populate-customer-info-file) [填充客户信息文件]。
4. 运行命令 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 文件，以包含如下表所述的本地部署详细信息：

将配置导入到本地部署

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

重要提示：

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