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

最終公開日 : 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 をインストールします。詳細については、「Download 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 にアクセスするサイトへの接続。詳細については、「System and Connectivity Requirements」を参照してください。
注
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」セクションを参照してください。

詳細な移行

注
コンポーネントの移行順序の詳細については、「」を参照してください(/ja-jp/citrix-virtual-apps-desktops/2411/manage-deployment/migrate#component-migration-order)。

コンポーネント全体をリストアする

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