製品ドキュメント
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDFを表示

Cloud構成のオンプレミスへの移行

March 18, 2026
寄稿者: 
C

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

構成移行の前提条件

  • Citrix Virtual Apps and Desktops™ オンプレミス環境（少なくとも1つの登録済みVDAを含む）
  • 以下のいずれかのバージョンで実行されているCitrix Virtual Apps™ and Desktops オンプレミス環境：
    • 最新のLong-Term Service Release (LTSR) バージョン - 2402
    • いずれかのCurrent Releases (CR) バージョン - 2308、2311
  • Automated Configurationツール (ACT) コマンドを、.Net 4.7.2以降のバージョンがインストールされたドメイン参加済みマシンで実行します。
  • Citrix PowerShell SDKがインストールされたマシン。PowerShell SDKはCitrix Delivery Controller™のインストール可能ファイルに含まれています。

注：

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

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

主な手順

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

  1. Cloud構成のバックアップ
  2. YMLファイルの変更
  3. 構成のオンプレミスへのインポート

Cloud構成のバックアップ

  1. Automated Configurationのインストール。
  2. New-CvadAcCustomerInfoFileを実行して、CustomerInfo.ymlファイルを作成します。詳細については、「顧客情報ファイルの入力」を参照してください。
  3. Backup-CvadAcToFileコマンドを実行して、Cloud構成のバックアップを作成します。

    注：

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

重要：

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

YMLファイルの変更

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

| YMLファイル | パラメーター | 説明 | 例 | |———–|———–|–|–| | CustomerInfo.yml | Environment | EnvironmentをOnPremに変更します。Environmentパラメーターの値は大文字と小文字を区別します。 | | | ZoneMapping.yml | DaaS:CVAD | Cloudリソースの場所をオンプレミスゾーンにマッピングします。 | old:newゾーンである必要があります | | CvadAcSecurity.yml | Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ | ハイパーバイザーのユーザー名とパスワードを追加します。 | ハイパーバイザーがXenServerの場合、XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘ |

構成のオンプレミスへのインポート

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

重要：

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

Cloud構成のオンプレミスへの移行
March 18, 2026
寄稿者: 
C
March 18, 2026
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.