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

思杰虚拟应用和桌面
备份您的配置所需满足的先决条件
- 所有版本的思杰虚拟应用和桌面。
-
运行 Auto Config 的计算机。此设备可以是:
- 交付控制器™
- 一台已加入域的计算机,安装了 .NET 框架 4.7.2 或更高版本以及思杰 PowerShell SDK。对于思杰 PowerShell,您必须安装 Web Studio。
备份
- 安装自动化配置。有关详细信息,请参阅下载自动化配置。
- 双击 自动配置。
- 在 PowerShell 窗口中,运行命令
Backup-CvadAcToFile以导出所有组件。导出本地配置不会对其进行修改。
首次运行该命令后,该过程会在以下位置创建一个包含 .yml 配置文件的文件夹:
%HOMEPATH%\Documents\Citrix\AutoConfig。
该文件夹包含最近导出的备份文件,并且每个以前的备份都存储在一个子文件夹中。
还原
- 双击 自动配置。
-
运行以下命令以执行还原:
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 访问权限且管理员也具有直接访问权限的计算机上安装 Automated Configuration。
- 双击自动配置。
- 在 PowerShell 窗口中,运行以下命令进行备份:
Export-CvadAcToFile
首次运行该命令后,该过程会在以下位置创建一个包含 .yml 配置文件的文件夹:
%HOMEPATH%\Documents\Citrix\AutoConfig
该文件夹包含最近导出的备份文件,每个以前的备份都存储在一个子文件夹中。
还原
- 双击自动配置。
-
在 PowerShell 窗口中,运行以下命令执行还原:
Restore-CvadAcToSite -RestoreFolder <folder path of the backup files> <!--NeedCopy--> -
运行命令后,验证导出状态,您可以在
%HOMEPATH%\Documents\Citrix\AutoConfig找到日志文件夹。 - 如果存在任何错误或异常,请参阅日志文件中的“修复”部分。
精细化迁移
注意
有关组件迁移顺序的更多信息,请参阅组件迁移顺序。
恢复完整的组件
要还原组件,您必须选择一个或多个参数。
例如,要还原整个交付组和计算机目录组件,请运行以下命令:
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 虚拟应用和桌面 和 Citrix DaaS™ 中备份配置的先决条件与 PowerShell 会话中的自动化配置工具相同。
备份
要在交付控制器上启动新的备份操作,请在 PowerShell 窗口中运行 New-BckRstrBackup。
恢复
要从现有备份中恢复单个组件的成员,请在 PowerShell 窗口中运行 Restore-BckRstrBackups。
有关命令的完整列表,请参阅 用于备份和恢复的自动化配置工具 cmdlet。