使用自动化配置工具进行备份和恢复
自动化配置工具使您能够在以下环境中执行按需和计划的备份:
- Citrix 虚拟应用和桌面™
- 桌面即服务 (DaaS)
自动化配置工具可用于以下目的:
- 备份和恢复(按需和计划备份)
- 迁移(按需备份)
用于迁移的自动化配置工具

Citrix 虚拟应用和桌面
备份您的配置所需满足的先决条件
- 所有版本的 Citrix 虚拟应用和桌面。
-
运行自动配置的计算机。此设备可以是:
- 交付控制器™
- A domain joined machine with .NET Framework 4.7.2 or later and the Citrix PowerShell SDK. For Citrix PowerShell, you must install Web Studio.
备份
- 安装 自动化配置。有关详细信息,请参阅下载 自动化配置。
- 双击 自动配置。
- 在 PowerShell 窗口中,运行命令
Backup-CvadAcToFile以导出所有组件。导出本地配置不会对其进行修改。
首次运行该命令后,此过程会在以下位置创建包含 .yml 配置文件的文件夹:
%HOMEPATH%\Documents\Citrix\AutoConfig。
该文件夹包含最近导出的备份文件,并且每个以前的备份都存储在一个子文件夹中。
还原
- Double-click Auto-Config.
-
运行以下命令执行还原:
Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files> <!--NeedCopy--> - 运行命令后,验证导出状态,日志文件夹位于:
%HOMEPATH%\Documents\Citrix\AutoConfig。 - 如果存在任何错误或异常,请参阅日志文件中的 Fixups 部分。
桌面即服务
备份您的配置所需的先决条件
- 具有活动资源位置和已安装连接器的 DaaS 环境。
- 连接到访问 Citrix Cloud 的站点。有关详细信息,请参阅 系统和连接要求。
注意
您无法使用自动化配置工具从云中备份 MCS。
备份
将备份以下文件:
- 包含您的客户 ID、客户端 ID 和密钥信息的
CustomerInfo.yml文件。有关检索客户 ID、客户端 ID 和密钥过程的更多信息,请参阅 生成客户 ID、客户端 ID 和密钥。有关如何将此信息添加到CustomerInfo.yml文件的信息,请参阅 填充客户信息文件。 - 包含云中资源位置映射信息的
ZoneMapping.yml文件。有关如何映射区域的更多信息,请参阅 填充区域映射文件。 - 包含主机连接信息的
CvadAcSecurity.yml文件。
- 安装自动化配置工具。有关详细信息,请参阅 安装自动化配置工具。
注意
对于 DaaS 备份,请将自动化配置工具安装在具有 Internet 访问权限且管理员可以直接访问的计算机上。
- 双击 自动配置。
- 在 PowerShell 窗口中,运行以下命令进行备份:
Export-CvadAcToFile
首次运行该命令后,该过程会在以下位置创建一个包含 .yml 配置文件的新文件夹:
%HOMEPATH%\Documents\Citrix\AutoConfig
该文件夹包含最近导出的备份文件,每个以前的备份都存储在一个子文件夹中。
还原
- 双击 自动配置。
-
在 PowerShell 窗口中,运行以下命令执行还原:
Restore-CvadAcToSite -RestoreFolder <folder path of the backup files> <!--NeedCopy--> -
运行命令后,验证导出状态,您可以在
%HOMEPATH%\Documents\Citrix\AutoConfig找到日志文件夹。 - 如果有任何错误或异常,请参阅日志文件中的 Fixups 部分。
精细化迁移功能
注意
有关组件迁移顺序的更多信息,请参阅 组件迁移顺序。
恢复完整的组件
要还原组件,您必须选择一个或多个参数。
例如,要还原整个交付组和计算机目录组件,请运行以下命令:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs
<!--NeedCopy-->
还原组件的成员
要还原一个或多个组件成员,请使用 IncludeByName 功能。您必须使用 Restorefolder 参数以及所选组件和包含列表来调用 Restore cmdlet。
例如,要从备份中还原两个组策略:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -GroupPolicies -IncludeByName Policy1,Policy2
<!--NeedCopy-->
还原完整的云站点配置信息
要还原所有组件或整个云站点,请运行以下命令:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
<!--NeedCopy-->
用于备份和恢复的自动化配置工具
自动化配置工具命令会触发 Web Studio 使用的备份和恢复 API。
BckRstr cmdlet 会记录到控制台。不会在 \Documents\Citrix\AutoConfig 中创建包含日志信息的文件夹。
注意:
在 Citrix Virtual Apps and Desktops 和 Citrix DaaS™ 中备份您的配置的先决条件,与在 PowerShell 会话中使用的自动化配置工具的先决条件是相同的。
备份
要在交付控制器上启动新的备份操作,请在 PowerShell 窗口中运行 New-BckRstrBackup。
恢复
要从现有备份中恢复单个组件的成员,请在 PowerShell 窗口中运行 Restore-BckRstrBackups。
有关命令的完整列表,请参阅用于备份和恢复的自动化配置工具 cmdlet。