产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

使用 Automated Configuration 工具进行备份和还原

March 25, 2026
投稿者: 
C C

Automated Configuration 工具允许您在以下环境中执行按需和计划备份：

  • Citrix Virtual Apps and Desktops™
  • DaaS

Automated Configuration 工具可用于以下目的：

  • 备份和还原（按需和计划备份）
  • 迁移（按需备份）

用于迁移的 Automated Configuration 工具

自动配置备份和还原

Citrix Virtual Apps™ 和 Desktops

备份配置的先决条件

  • 所有版本的 Citrix Virtual Apps and Desktops。

  • 运行 Auto Config 的计算机。此设备可以是：

    • Delivery Controller™
    • 具有 .NET Framework 4.7.2 或更高版本以及 Citrix PowerShell SDK 的已加入域的计算机。对于 Citrix PowerShell，您必须安装 Web Studio。

备份

  1. 安装 Automated Configuration。有关详细信息，请参阅下载 Automated Configuration。
  2. 双击 Auto-Config。
  3. 在 PowerShell 窗口中，运行命令 Backup-CvadAcToFile 以导出所有组件。导出本地配置不会对其进行修改。

首次运行该命令后，此过程会在以下位置创建包含 .yml 配置文件的文件夹： %HOMEPATH%\Documents\Citrix\AutoConfig

该文件夹包含最近导出的备份文件，并且每个以前的备份都存储在一个子文件夹中。

还原

  1. 双击 Auto-Config。

  2. 运行以下命令执行还原：

    Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files>
<!--NeedCopy-->
  3. 运行该命令后，验证导出状态，日志文件夹位于：%HOMEPATH%\Documents\Citrix\AutoConfig。
  4. 如果存在任何错误或异常，请参阅日志文件中的“修复”部分。

DaaS

备份配置的先决条件

  • 具有活动资源位置和已安装 Connector 的 DaaS 环境。
  • 连接到访问 Citrix Cloud 的站点。有关详细信息，请参阅系统和连接要求。

注意

您无法使用 Automated Configuration 从云中备份 MCS。

备份

备份以下文件：

  • CustomerInfo.yml 文件，其中包含您的客户 ID、客户端 ID 和密钥信息。有关检索客户 ID、客户端 ID 和密钥过程的详细信息，请参阅生成客户 ID、客户端 ID 和密钥。有关如何将此信息添加到 CustomerInfo.yml 文件的信息，请参阅填充客户信息文件。
  • ZoneMapping.yml 文件，其中包含映射云中资源位置的信息。有关如何映射区域的详细信息，请参阅填充区域映射文件。
  • CvadAcSecurity.yml 文件，其中包含主机连接信息。
  1. 安装 Automated Configuration。有关详细信息，请参阅安装 Automated Configuration。

注意

对于 DaaS 备份，请将 Automated Configuration 安装在具有 Internet 访问权限且管理员可以直接访问的计算机上。

  1. 双击 Auto Config。
  2. 在 PowerShell 窗口中，运行以下命令进行备份：Export-CvadAcToFile

首次运行该命令后，此过程会在以下位置创建包含 .yml 配置文件的文件夹： %HOMEPATH%\Documents\Citrix\AutoConfig

该文件夹包含最近导出的备份文件，并且每个以前的备份都存储在一个子文件夹中。

还原

  1. 双击 Auto Config。

  2. 在 PowerShell 窗口中，运行以下命令执行还原：

    Restore-CvadAcToSite -RestoreFolder <folder path of the backup files>
<!--NeedCopy-->

  3. 运行该命令后，验证导出状态，您可以在 %HOMEPATH%\Documents\Citrix\AutoConfig 找到日志文件夹。

  4. 如果存在任何错误或异常，请参阅日志文件中的“修复”部分。

粒度迁移

注意

有关组件迁移顺序的详细信息，请参阅组件迁移顺序。

还原整个组件

要还原组件，您必须选择一个或多个参数。

例如，要还原整个交付组和计算机目录组件，请运行以下命令：

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-->

用于备份和还原的 Automated Configuration 工具

Automated Configuration 工具命令会触发 Web Studio 使用的备份和还原 API。

BckRstr cmdlet 会记录到控制台。不会在 \Documents\Citrix\AutoConfig 中创建包含日志记录信息的文件夹。

注意：

在 PowerShell 会话中，Citrix Virtual Apps and Desktops 和 Citrix DaaS™ 中备份配置的先决条件与 Automated Configuration 工具的先决条件相同。

备份

要在 Delivery Controller 上启动新的备份操作，请在 PowerShell 窗口中运行 New-BckRstrBackup。

还原

要从现有备份中还原单个组件的成员，请在 PowerShell 窗口中运行 Restore-BckRstrBackups。

有关命令的完整列表，请参阅用于备份和还原的 Automated Configuration 工具 cmdlet。

使用 Automated Configuration 工具进行备份和还原
March 25, 2026
投稿者: 
C C
March 25, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.