将云配置迁移到本地部署

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

用于迁移您的配置的先决条件

• Citrix 虚拟应用和桌面™ 本地环境，其中至少有一个已注册的 VDA。
• 运行以下版本之一的 Citrix 虚拟应用和桌面 本地环境：
  • 最新的长期服务版本 (LTSR) - 2402。
  • 任何当前版本 (CR) - 2308、2311。
• 在已加入域的计算机上运行自动化配置工具 (ACT) 命令，并安装 .Net 4.7.2 或更高版本。
• 一台安装了 思杰 PowerShell 软件开发工具包的计算机。思杰 PowerShell 软件开发工具包包含在 思杰 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. 安装 (/zh-cn/citrix-virtual-apps-desktops/2503/manage-deployment/migrate.html#download-automated-configuration) 自动化配置。
2. 双击 Auto Config 图标。执行此操作后，将弹出一个 PowerShell 窗口。
3. 运行 New-CvadAcCustomerInfoFile 以创建 CustomerInfo.yml 文件。有关详细信息，请参阅 (/zh-cn/citrix-virtual-apps-desktops/2503/manage-deployment/migrate.html#populate-customer-info-file) [填充客户信息文件]。
4. 运行命令 Backup-CvadAcToFile 以备份您的云配置。

   注意：

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

重要提示：

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

修改 YML 文件

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

将配置导入到本地部署

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

重要提示：

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