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

最終公開日 : 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ツール

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 を実行します。
コマンドの完全なリストについては、「バックアップと復元用の自動構成ツールコマンドレット」を参照してください。