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

この記事では、クラウド構成をバックアップし、オンプレミスサイトに移行する方法について説明します。

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

• 少なくとも1つの登録済みVDAを持つCitrix Virtual Apps and Desktops™オンプレミス環境。
• 以下のいずれかのバージョンで実行されているCitrix Virtual Apps and Desktopsオンプレミス環境:
  • 最新の長期サービスリリース (LTSR) バージョン - 2402。
  • いずれかの現在のリリース (CR) バージョン - 2308、2311。
• .Net 4.7.2以降のバージョンがインストールされたドメイン参加済みマシンで、Automated Configuration tool (ACT) コマンドを実行します。
• Citrix PowerShell SDK がインストールされたマシン。パワーシェル SDK は Citrix Delivery Controller™ のインストーラーに含まれています。

注:

• 別のマシンでACTを実行している場合、そのマシンはドメイン参加済みである必要があり、Studioには適切なPowerShellスナップインがインストールされている必要があります。インストーラーを入手するには、Citrix Virtual Apps and DesktopsダウンロードWebサイトにアクセスしてください。
• オンプレミスサイトでは、ACTをDelivery Controllerにインストールすることをお勧めします。ACTはデスクトップアイコンから起動できます。
• 標準のPowerShellウィンドウからACTを使用する場合は、次のコマンドを実行する必要があります。 Import-Module Citrix.AutoConfig.Commands

ACTはシステムPowerShellパスの一部ではないため、明示的にインポートする必要があります。

主要な手順

クラウド構成をオンプレミスに移行するには、以下の手順に従ってください。

1. クラウド構成のバックアップ
2. YMLファイルの変更
3. 構成をオンプレミスにインポート

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

1. (/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/manage-deployment/migrate.html#download-automated-configuration)をインストールします。
2. New-CvadAcCustomerInfoFileを実行して、CustomerInfo.yml ファイルを作成します。詳細については、(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/manage-deployment/migrate.html#populate-customer-info-file)を参照してください。
3. コマンドBackup-CvadAcToFileを実行して、クラウド構成のバックアップを作成します。

   注:

   • 任意のコマンドレットを初めて実行すると、.yml 構成ファイルとログを含むエクスポートフォルダーが作成されます。フォルダーは%HOMEPATH%\Documents\Citrix\AutoConfigにあります。
   • エラーまたは例外が発生した場合は、ログファイルのFixupsセクションを参照してください。
   • Backup-CvadToFileは、パラメーターIncludeByNameまたはExcludeByNameをサポートしていません。

重要:

Citrixは、すべてのコンポーネントをまとめてバックアップすることをお勧めします。

YMLファイルの変更

%HOMEPATH%\Documents\Citrix\AutoConfigにある.ymlファイルを、次の表に示すようにオンプレミスの詳細を含めるように変更します。

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

1. 要件に基づいて、オンプレミスサイトで以下のいずれかのコマンドを実行します:
   1. Merge-CvadAcToSite - オンプレミスサイトが稼働中で、クラウド構成をそれにマージしたい場合。
   2. Import-CvadAcToSite -Environment OnPrem - オンプレミス構成が利用できず、クラウド構成をインポートして新しいものを作成する場合。

重要:

競合を避けるため、Citrixはコンポーネントを一度に1つずつインポートすることを推奨します。