クラウド構成をオンプレミスに移行する

最終公開日 : Oct 24, 2026
この記事では、クラウド構成をバックアップし、オンプレミスサイトに移行する方法について説明します。
Related information
構成をCitrix Cloud™に移行する

構成を移行するための前提条件

  • Citrix Virtual Apps and Desktops™ オンプレミス環境（登録済みVDAが1つ以上あること）。
  • 以下のいずれかのバージョンで実行されているCitrix Virtual Apps and Desktopsオンプレミス環境:
    • 最新のLong-Term Service Release (LTSR) バージョン - 2402。
    • いずれかのCurrent Releases (CR) バージョン - 2308、2311。
  • .Net 4.7.2以降のバージョンがインストールされたドメイン参加済みマシンで、Automated Configuration tool (ACT) コマンドを実行します。
  • Citrix PowerShell SDKがインストールされたマシン。PowerShell SDKは、Citrix Delivery Controller™のインストール可能ファイルに含まれています。
注：
  • 別のマシンでACTを実行している場合は、そのマシンがドメインに参加しており、Studioに適切なPowerShellスナップインがインストールされている必要があります。インストーラーを入手するには、Citrix Virtual Apps and DesktopsダウンロードWebサイトにアクセスしてください。
  • オンプレミスサイトでは、ACTをDDCにインストールすることをお勧めします。ACTはデスクトップアイコンから起動できます。
  • ACTを標準のPowerShellウィンドウから使用する場合は、次のコマンドを実行します。 Import-Module Citrix.AutoConfig.Commands
ACTはシステムPowerShellパスの一部ではないため、明示的にインポートする必要があります。

主要な手順

クラウド構成をオンプレミスに移行するには、以下の手順に従ってください。
  1. クラウド構成をバックアップします。
  2. YMLファイルを変更します。
  3. 構成をオンプレミスにインポートします。

クラウド構成のバックアップ

  1. Automated Configurationをインストールします.
  2. Auto Configアイコンをダブルクリックします。PowerShellウィンドウが表示されます。
  3. CustomerInfo.ymlファイルを作成するには、New-CvadAcCustomerInfoFileを実行します。詳細については、(/ja-jp/citrix-daas/backup-migrate-configuration/migrate.html#populate-customer-info-file)を参照してください。
  4. クラウド構成のバックアップを作成するには、コマンドBackup-CvadAcToFileを実行します。
    注：
    • 任意のコマンドレットを初めて実行すると、.yml構成ファイルとログを含むバックアップフォルダーが作成されます。フォルダーは%HOMEPATH%\Documents\Citrix\AutoConfigにあります。
    • エラーまたは例外が発生した場合は、ログファイルのFixupsセクションを参照してください。
    • Backup-CvadToFileは、パラメーターIncludeByNameまたはExcludeByNameをサポートしていません。
重要：
Citrixでは、すべてのコンポーネントをまとめてバックアップすることをお勧めします。

YMLファイルを変更する

%HOMEPATH%\Documents\Citrix\AutoConfigにある.ymlファイルを、次の表に示すようにオンプレミスの詳細を含めるように変更します。
YMLファイル パラメーター 説明 例
CustomerInfo.yml 環境 環境をOnPremに変更します。環境パラメーターの値は大文字と小文字を区別します。
ZoneMapping.yml DaaS:CVAD クラウドのリソースの場所をオンプレミスのゾーンにマッピングします。 old:newゾーンである必要があります
CvadAcSecurity.yml ハイパーバイザー: 接続タイプ: ‘ ‘ ユーザー名: ‘ ’ パスワード: ‘ ‘ ハイパーバイザーのユーザー名とパスワードを追加します。 ハイパーバイザーがXenServerの場合、XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

オンプレミスに構成をインポートする

  1. 要件に基づいて、オンプレミスサイトで次のいずれかのコマンドを実行します。
    1. Merge-CvadAcToSite - オンプレミスサイトが稼働しており、クラウド構成をそれにマージしたい場合。
    2. Import-CvadAcToSite -Environment OnPrem - オンプレミス構成が利用できず、クラウド構成をインポートして新しいものを作成する場合。
重要:
競合を避けるため、Citrixでは一度に1つのコンポーネントをインポートすることをお勧めします。