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

使用自动配置工具进行备份和还原

November 25, 2025
投稿者: 
C

自动配置工具允许您在以下环境中进行按需备份和计划备份：

  • Citrix Virtual Apps and Desktops™
  • DaaS

自动配置工具可用于执行以下操作：

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

用于迁移的自动配置工具

自动配置备份和还原

Citrix Virtual Apps and Desktops

备份配置的必备条件

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

  • 运行自动配置的计算机。 此设备可以是：

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

备份

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

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

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

Restore（还原）

  1. 双击 Auto-Config。

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

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

DaaS

备份配置的必备条件

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

注意

您无法使用自动配置从云端备份 MCS。

备份

请备份以下文件：

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

注意

对于 DaaS 备份，请在具有 Internet 访问权限且管理员可以直接访问的计算机上安装自动配置组件。

  1. 双击自动配置。
  2. 在 PowerShell 窗口中，运行以下命令创建备份：Export-CvadAcToFile

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

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

Restore（还原）

  1. 双击自动配置。

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

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

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

  4. 如果有任何错误或异常，请参阅日志文件中的 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 会话中的自动配置工具相同。

备份

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

Restore（还原）

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

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

使用自动配置工具进行备份和还原
November 25, 2025
投稿者: 
C
November 25, 2025
投稿者: 
C

在本文中

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