自動構成ツールを使用したバックアップと復元

最終公開日 : Nov 13, 2026
自動構成ツールを使用すると、以下の環境でオンデマンドおよびスケジュールされたバックアップを実行できます。
  • シトリックス バーチャルアプリ アンド デスクトップ™
  • DaaS
自動構成ツールは、以下の目的で使用できます。
  • バックアップと復元(オンデマンドおよびスケジュールされたバックアップ)
  • 移行(オンデマンドバックアップ)

移行のための自動構成ツール

自動構成のバックアップと復元

シトリックス バーチャルアプリ™ アンド デスクトップ

構成をバックアップするための前提条件

  • Citrix Virtual Apps and Desktops のすべてのバージョン。
  • Auto Config を実行するマシン。このデバイスは次のいずれかです。
    • デリバリーコントローラー™
    • .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>
  3. コマンドを実行した後、エクスポートの状態を確認し、ログフォルダーが次の場所にあることを確認します: %HOMEPATH%\Documents\Citrix\AutoConfig。
  4. エラーまたは例外がある場合は、ログファイルの「Fixups」セクションを参照してください。

DaaS

構成をバックアップするための前提条件

  • アクティブなリソースの場所とコネクタがインストールされているDaaS環境。
  • Citrix Cloudにアクセスするサイトへの接続。詳細については、システムおよび接続要件を参照してください。
注
Automated Configurationツールを使用して、クラウドからMCSをバックアップすることはできません。

バックアップ

次のファイルをバックアップします。
  • お客様ID、クライアントID、およびシークレットキー情報を含むCustomerInfo.ymlファイル。お客様ID、クライアントID、およびシークレットキーを取得するプロセスについて詳しくは、お客様ID、クライアントID、およびシークレットキーの生成を参照してください。この情報をCustomerInfo.ymlファイルに追加する方法については、顧客情報ファイルの入力を参照してください。
  • クラウド内のリソースロケーションをマッピングする情報を含むZoneMapping.ymlファイル。ゾーンをマッピングする方法について詳しくは、ゾーンマッピングファイルの入力を参照してください。
  • ホスト接続に関する情報を含むCvadAcSecurity.ymlファイル。
  1. Automated Configurationをインストールします。詳しくは、Automated Configurationのインストールを参照してください。
注
DaaSのバックアップの場合、インターネットアクセスがあり、管理者が直接アクセスできるマシンにAutomated Configurationをインストールします。
  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>
  3. コマンドを実行した後、エクスポートの状態を確認し、ログフォルダーは %HOMEPATH%\Documents\Citrix\AutoConfig にあります。
  4. エラーまたは例外がある場合は、ログファイルの「Fixups」セクションを参照してください。

詳細な移行

注
コンポーネントの移行順序の詳細については、「コンポーネントの移行順序」を参照してください。

コンポーネント全体の復元

コンポーネントを復元するには、1つ以上のパラメーターを選択する必要があります。
たとえば、デリバリーグループとマシンカタログのコンポーネント全体を復元するには、次のコマンドを実行します。
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs

コンポーネントメンバーの復元

1つ以上のコンポーネントメンバーを復元するには、IncludeByName 機能を使用します。選択したコンポーネントとインクルージョンリストとともに、Restorefolder パラメーターを指定して Restore コマンドレットを呼び出す必要があります。
たとえば、バックアップから2つのグループポリシーを復元するには、次のコマンドを実行します。
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -GroupPolicies -IncludeByName Policy1,Policy2

クラウドサイト構成全体の復元

すべてのコンポーネントまたはクラウドサイト全体を復元するには、次のコマンドを実行します。
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

バックアップと復元のためのAutomated Configurationツール

自動構成ツールのコマンドは、Web Studio が使用するバックアップおよび復元 API をトリガーします。
BckRstr コマンドレットはコンソールにログを記録します。ログ情報を含むフォルダーは \Documents\Citrix\AutoConfig に作成されません。
注:
Citrix Virtual Apps and Desktops および Citrix DaaS™ で構成をバックアップするための前提条件は、PowerShell セッションの自動構成ツールと同じです。

バックアップ

Delivery Controller で新しいバックアップアクションを開始するには、PowerShell ウィンドウで New-BckRstrBackup を実行します。

復元

既存のバックアップから単一コンポーネントのメンバーを復元するには、PowerShell ウィンドウで Restore-BckRstrBackups を実行します。
コマンドの完全なリストについては、「自動構成ツールによるバックアップと復元用のコマンドレット」を参照してください。