概念実証:自動構成ツール

概要

自動構成ツールは、Citrix Virtual Appsおよびデスクトップサービス(CVADS) への構成の移行とエクスポートを容易にします 。この概念実証ガイドでは、このツールの使用方法を段階的に説明しています。

管理者は、 Citrix Virtual Apps and Desktop Service (CVADS)の機能と利点を簡単にテストして確認することができます。同時に、既存のオンプレミス環境を実行できるほか、クラウドリージョン間の移動、既存の構成のバックアップ、その他のユースケースも容易に行えます。自動構成のダウンロードリンクには、 追加情報、 およびこれらのユースケースカスタマイズでの詳細なドキュメントも含まれています。

Citrix Virtual Apps and Desktops の自動構成ツールは何ですか?

このツールは、1つ以上のオンプレミスサイトからCitrix Cloud上でホストされているCitrix Virtual AppsおよびデスクトップサービスCVADS )へのCVAD構成(ポリシー、アプリケーション、カタログなど)の移行を自動化できるように設計されています。また、 **異なるクラウドリージョンまたはテナント間で情報を移行する場合にも使用できます**。

このツールを複数回実行することで、移行を段階的に実行できるため、管理者は必要な構成状態を容易に達成できます。

このツールを使用する理由

大規模環境や複雑な環境を担当するIT管理者は、移行が面倒なプロセスであることがよくあります。彼らはしばしば、このタスクを正常に達成するために独自のツールを書くことになります。なぜなら、それは彼らのユースケースに特有になる傾向があるからです。

Citrixは、自動化を通じてユースケースに対応するツールを提供することで、このプロセスを容易にしたいと考えています。管理者は、 Citrix Cloudで現在の構成を簡単にテストし 、現在の環境を維持しながら、 CVADSが提供するメリットを活用できます 。このようなメリットには、Citrixがバックエンドとコントロールプレーンの一部を管理する場合の管理オーバーロードの軽減、 Citrix Cloudコンポーネントの自動更新およびカスタマイズが可能です

このツールはどのように実装されていますか?

Citrix は、業界標準の構成をコードとして活用し、移行プロセスの自動化に役立つメカニズムを提供します。このツールは、1 つ以上のオンプレミスサイトを構成ファイルのコレクションとして検出し、エクスポートします。管理者は必要に応じて編集し、これらのファイルの構成を CVADS にインポートできます。

このコードは移行に限定されるものではなく、Citrixサイトの構成を作成する将来のものです。そのため、 さまざまなユースケースに適用できます。災害復旧、開発/テスト/ステージングから本番サイトへの同期、地理的(GEO)移動、およびその他のいくつかのシナリオがサポートされています。パブリッククラウドプロバイダーを使用する管理者の場合、これにより、オブジェクトの組み合わせを自動的に作成できます (Microsoft Azure ARM テンプレートおよび AWS CloudFormation と並行)。

前提条件

オンプレミス環境

  • Citrix Virtual Apps and Desktops(CVAD) オンプレミス環境で、少なくとも1つのVDAが登録されています
  • 次のバージョンのいずれかで実行されている CVAD オンプレミス環境: 長期サービスリリース (LTSR) バージョン、最新の CU (7.6、7.15、1912)、または対応する最新の 2 つの最新リリース (CR) バージョン (例:2003、2006) のいずれか。
  • 自動構成ツールのコマンドを実行するドメイン参加マシンでは.NET 4.7.2 以降が実行されている必要があります
  • DDCに自動的にインストールされるCitrix PowerShell SDKを搭載したマシン注: 別のマシンでツールを実行する場合は、ドメインに参加している必要があり、 Studio に正しい PowerShell スナップインがインストールされている必要があります 。このインストーラは、 対応するバージョンの製品 ISO インストールメディアにあります。このメディアはCitrixダウンロード > Citrix Virtual Apps and Desktops Web サイトから入手できます。
  • 公式ダウンロードサイトから自動構成ツール MSI をダウンロードします

クラウド関連のコンポーネント

  • 有効な CVADS ライセンスまたは Workspace プレミアムプラスライセンス
  • 管理者は、クラウドポータルにログインして、 リソースの場所名カスタマー ID、クライアントシークレット(アプリ ID**とシークレットキー**)を取得できる必要があります。
  • 既存のCitrix Cloudリソースの場所には少なくとも1つのCloud Connectorがあり、これは緑(正常)としてマークされ、オンプレミスセットアップと同じドメインの一部です。注: 冗長性と高可用性のために、 2つ以上のCloud Connectorをお勧めします。Cloud Connectorの設定方法については、「このガイド」を参照してください。

この概念実証ガイドでは、

  1. オンプレミスの前提条件を完了する
  2. オンプレミスのサイト構成を YAML (.yml) ファイルにエクスポートする
  3. クラウドの前提条件を完了する
  4. 異なるプロビジョニング方法 (Provisioning Services (PVS) とマシン作成サービス (MCS)) を使用する場合にサイト構成をインポートするための必要条件を完了します。
  5. サイト構成をクラウドにインポートする(必要なファイルを編集して)
  6. トラブルシューティングのヒントと詳細情報の入手先

オンプレミスサイトからエクスポートするための完全な前提条件

これらの手順は、DDC または自動構成ツールを実行するドメイン参加マシンで実行する必要があります

  1. 最新の自動構成ツール MSI を、 オンプレミス DDC またはドメイン参加マシンにダウンロードします。注: 別のマシンから実行する方法の詳細については、「 前提条件」セクションを参照してください 。ツールはここからダウンロードできます。 注: 別のマシンから実行する方法の詳細については、前提条件セクションを参照してください。
  2. AutoConfig_PowerShell_x64.msi インストーラを右クリックし、[ インストール] をクリックして、 オンプレミス DDCMSIを実行します。 Pre-requisites
  3. 使用許諾契約書を読み 、条件に同意する場合はチェックボックスをオンにします。次に、[ インストール] をクリックします。 Pre-requisites
  4. ファイルがコピーされ、インストールが完了するまで進行状況バーが表示されます。 Pre-requisites

  5. MSIの実行後 、正常に完了したことを示すウィンドウがポップアップします。[ 完了 ] をクリックして MSI セットアップウィンドウを閉じますPre-requisites
  • 注: 正常に実行されると、 MSIC:\Users\<username>\Documents\Citrix\AutoConfig<!--NeedCopy--> にある対応するフォルダ構造 、および PowerShell コマンドプロンプトを起動するAuto Configというデスクトップアイコンを作成します。このツールは、後続のステップで使用されるツールです。

オンプレミスのサイト構成をエクスポートする

``` PowerShell コマンドを使用して、既存のオンプレミス構成をエクスポートし、 *必要な.yml* ファイルを取得できます。これらのファイルは、 **必要な構成をCitrix Cloudにインポートするために使用されます**。

1.  前の手順で **MSI** インストーラを実行すると、 **デスクトップに自動構成ショートカットが自動的に作成されます** 。このショートカットを右クリックし、\[ **管理者として実行\] をクリックします。**
2.  ```Export-CvadAcToFile<!--NeedCopy-->
```コマンドを実行します。このコマンドは、ポリシー、手動でプロビジョニングされたカタログ、およびデリバリーグループをエクスポートします。また、アプリケーション、アプリケーションフォルダ、アイコン、ゾーンマッピング、タグ、およびその他の項目もエクスポートされます。**注:******MCSおよびPVSのマシンカタログおよびデリバリーグループについては**** 、このガイドの[さまざまなプロビジョニング方法を使用してサイト構成をインポートするための必要条件](#requisites-for-importing-site-configuration-using-different-provisioning-methods)の手順を参照してください。
[![設定(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-002-1.png)をエクスポートしています]](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-002-1.png)

3.  ツールの実行が完了すると、\[全体\] ステータスが\[**True**\] と表示され、エクスポートプロセスが完了します (表示されている出力行は、次の図と一致します)。**注:** エラーがある場合は、アクション固有のサブフォルダ`(Export, Import, Merge, Restore, Sync, Backup, Compare)`に診断ファイルが作成されます。このサブフォルダは、`%HOMEPATH%\Documents\Citrix\AutoConfig`にあります 。エラーが発生した場合は、[トラブルシューティングのヒント](#troubleshooting-tips)を参照してください。
[![設定(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-003.png)をエクスポートしています]](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-003.png)

4.  *生成された.yml* ファイルは、現在のユーザーの```Documents\Citrix\AutoConfig<!--NeedCopy-->
```パスにあります。
[![設定(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-004.png)をエクスポートしています]](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-004.png)

*  **注:***.yml* ファイル (```Application.yml<!--NeedCopy-->
```)の内容の例については、次の画像を参照してください。

[![設定(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-005.png)をエクスポートしています]](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_export-config-005.png)

*  **注:** 必要に応じて、 **Citrix *Cloud環境への設定のインポートに使用するマシンに.ymlファイルをコピーします*** 。エクスポートとインポートは、同じマシンから実行できます。

## クラウドの前提条件を完了する

**リソースの場所に移動し** 、 **Cloud Connectorが両方とも緑色** (使用可能)になっていることを確認します。**注:****Cloud Connectorの設定方法の手順が必要な場合は**、[このガイド](/ja-jp/tech-zone/learn/poc-guides/cvads.html)を参照してください。

1.  **Cloud Connectorの正常性ステータスを確認するには**、まずCitrix管理者の資格情報(または該当する場合は Azure AD の資格情報)を使用して[クラウドポータル](https://citrix.cloud.com)にログインします。
[![クラウドの前提条件](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-001.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-001.png)

2.  **複数の組織 ID (組織 ID** ) がある場合は、対応するテナントを選択します。
[![クラウドの前提条件](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-002.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-002.png)

3.  ログオン時に、 **左上隅のハンバーガーメニューに移動し** 、\[ **リソースの場所**\] をクリックします。
[![クラウドの前提条件](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-003.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-003.png)

4.  \[ **リソースの場所** \] の下の \[ **Cloud Connector**\] タイルにアクセスします。
[![クラウドの前提条件](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-004.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-004.png)

*  **注:** 次の図のように、 **Cloud Connector** は緑色で表示される必要があります。これは、\[正常\] ステータスを示します。冗長性を確保するために、 ****リソースの場所ごとに複数のCloud** Connector**をお勧めします。

[![クラウドの前提条件](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-005.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_cloud-pre-requisites-005.png)

## さまざまなプロビジョニング方法を使用してサイト構成をインポートするための必要条件

### Provisioning Services(PVS)マシンカタログ、デリバリー、アプリケーショングループおよびポリシーの対処

**PVSカタログと対応するアプリケーションをインポートするには** 、追加の手順が必要です。**アプリケーション設定のインポートに進む前に** 、次の手順に従って環境を準備します。

**注:** これらのアクションを実行した後、このマニュアルの
[サイト構成をクラウドセクションにインポートする](#import-your-site-configuration-into-cloud)に記載されている手順に従います。

1.  **PowerShell** を管理者として実行する
2.  次のコマンド```Export-CvadAcToFile<!--NeedCopy-->
```を入力し、キーボードの **Return (Enter)** を押します。
[![プロビジョニング方法PVS](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-pvs-process-001.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-pvs-process-001.png)

3.  正常に完了したアイテムは緑色の```OK<!--NeedCopy-->
```で表示されます。ツールの実行が完了すると、次のような画面が表示されます。
[![プロビジョニング方法PVS](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-pvs-process-002.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-pvs-process-002.png)

4.  ```C:\Users\<username>\Documents\Citrix\AutoConfig<!--NeedCopy-->
``` フォルダにアクセスして```CvadAcSecurity.yml<!--NeedCopy-->
```ファイルを開きます。このファイルは、PVSが機能するために編集する必要があります。**注:** \[ **ユーザー名** \] フィールドと \[ **パスワード** \] フィールドは、 **PVSサイトサーバーの資格情報を参照します** 。ログオンを```DOMAIN\Username<!--NeedCopy-->
```として指定し、パスワードを追加し、準備ができたらファイルを保存してください。
[![プロビジョニング方法PVS](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-pvs-process-003.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-pvs-process-003.png)

*  これらのアクションを実行したら、このガイドの[サイト構成をクラウドにインポートする](#import-your-site-configuration-into-cloud)セクションに記載されている手順に従います。

### マシン作成サービス (MCS) の処理:プール (ランダム) と RDS マシンカタログ

**注:** 静的割り当て仮想マシンの手順については、別のセクションを使用できます。このガイドの[MCS スタティック割り当て済み VDI](#dealing-with-machine-creation-services-mcs-static-assigned-machines)セクションに記載されている手順を参照してください。

現在、このツールでは、MCSマシンカタログまたは対応するデリバリーグループの自動インポートはサポートされていません。ただし、このツールを使用して、アプリケーション、ポリシー、その他の構成を自動的にインポートすることはできます。

ホスティング接続、マシンカタログ、デリバリーグループ、および電源スキームを手動で作成する必要があります。カタログとデリバリーグループ名は、オンプレミスのセットアップと一致する必要があります。これらのリソースを作成したら、自動構成ツールを使用して、アプリケーション、アプリケーショングループ、アプリケーションフォルダ、タグの作成、およびポリシーを自動化できます。

**アプリケーション設定のインポートに進む前に** 、次の手順に従って環境を準備します。

1.  選択したハイパーバイザーまたはクラウドプロバイダーで、環境で使用可能な容量に応じて、必要な数の仮想マシンを作成します。ハイパーバイザーの容量は、オンプレミス環境とクラウド環境の両方で共有されるため、利用可能なリソースの数だけマシンを作成できます。

2.  [クラウドポータル](https://citrix.cloud.com)で、 **通常どおりホスティング接続を作成します** 。
**注:** 必要に応じて、ホスティング接続の設定方法については、[このガイド](/ja-jp/tech-zone/learn/poc-guides/cvads.html)を参照してください。

3.  **Cloud Studio** では、 **通常どおりMCSマシンカタログを作成し** 、既存のオンプレミスカタログの名前とまったく同じ名前を付けます。目的の OS タイプ、マスターイメージ、ストレージ、ライセンス、ネットワーク、アカウントの設定を選択します。**重要:** オンプレミスカタログと CVADS カタログの両方で名前が一致していることを確認します。作成できるマシンの数は、利用可能なハイパーバイザーリソースによって異なります。
**注:** 必要に応じて、カタログの設定方法については、[このガイド](/ja-jp/tech-zone/learn/poc-guides/cvads.html)を参照してください。

4.  次に、 **Cloud Studio**で新しいカタログに対応するデリバリーグループを作成し、対応するオンプレミスデリバリーグループの後に名前を付けます。**注:**マシンカタログとデリバリーグループの作成方法の詳細については、「この guide/ja-jp/tech-zone/learn/poc-guides/cvads.html」を参照してください。

5.  次に、 **電源設定がある場合は** 、手動でマシンに適用する必要があります。
6.  残りの設定のインポートに進むことができます。このガイドの[MCS スタティック割り当て済み VDI](#dealing-with-machine-creation-services-mcs-static-assigned-machines)セクションに記載されている手順を参照してください。

## マシン作成サービス (MCS) の対処:静的割り当てマシン

**注:** プールされたマシンと RDS マシンの手順については、別のセクションを使用できます。「[MCS プールされた VDI および RDS マシン](#dealing-with-machine-creation-services-mcs-pooled-random-and-rds-machine-catalogs)」に記載されている手順を参照してください。

現在、静的に割り当てられたマシンカタログは、CVADSクラウドアカウントにそのまま移行できません。このツールを使用して、アプリケーションやポリシーなどの他の構成を自動的にインポートできます。

ホスティング接続、マシンカタログ(これらのマシンの非プロビジョニングカタログとして)、デリバリーグループを手動で作成します。これらはすべて、オンプレミスのものとまったく同じ名前になります。電源スキームは、プロビジョニングされていないカタログでは機能しません。これらの作成後、自動構成ツールを使用して、アプリケーション、アプリケーショングループ、アプリケーションフォルダ、タグの作成、およびポリシーを自動化できます。

**このツールを使用してアプリケーション設定やその他のオブジェクトをインポートする前に** 、次の手順に従って環境を準備します。

1.  [クラウドポータル](https://citrix.cloud.com)で 、**\[ハンバーガーメニュー\] > \[ マイサービス\] > \[Virtual Apps and Desktops サービス\] > \[管理 \]** タブをクリックし、左側の **\[ 構成 \]**ノードを展開し、**\[ ホスティング \]** をクリックして、 通常どおり**ホスティング接続**を作成します 。
**注:** 必要に応じて、ホスティング接続の設定方法については、[このガイド](/ja-jp/tech-zone/learn/poc-guides/cvads.html)を参照してください。

2.  **Cloud Studio** で、 **MCSマシンカタログをプロビジョニングされていない物理カタログとして作成します** 。既存のオンプレミスカタログの名前と同じ方法で、カタログに名前を付けます。目的の OS タイプ、マスターイメージ、ストレージ、ライセンス、ネットワーク、アカウントの設定を選択します。**重要:** オンプレミスカタログと CVADS カタログの両方で名前が一致していることを確認します。
**注:** 必要に応じて、カタログの設定方法については、[このガイド](/ja-jp/tech-zone/learn/poc-guides/cvads.html)を参照してください。

3.  次に、 **Cloud Studio**で新しいカタログに対応するデリバリーグループを作成し、対応するオンプレミスデリバリーグループの後に名前を付けます。**注:**マシンカタログとデリバリーグループの作成方法の詳細については、「この guide/ja-jp/tech-zone/learn/poc-guides/cvads.html」を参照してください。

4.  このセクションで説明されているように、アプリケーション、グループ、フォルダ、およびタグをインポートする方法の手順に従います
5.  すべてのオブジェクトがすでに存在したら、ListOfDDCSレジストリエントリを更新し、Citrix Cloud ConnectorのFQDNまたはIPアドレスをポイントします。これは、レジストリ内で手動またはグループポリシーを使用して行うことができ、その目的は、マシンをCloud Connectorに登録することです。

## マシン作成サービス (MCS) の対処:アプリケーション、アプリケーショングループ、フォルダ、およびタグのインポート

**注:** これらの設定のインポートに進む前に、プールされた RDS マシンカタログと RDS マシンカタログおよび静的割り当ての手順に従う必要があります。必要に応じて、[MCS プールおよび RDS VDI](#dealing-with-machine-creation-services-mcs-pooled-random-and-rds-machine-catalogs)または[MCS スタティック割り当て済み VDI](#dealing-with-machine-creation-services-mcs-static-assigned-machines)に記載されている手順を参照してください。カタログ、アプリケーション、アプリケーションフォルダ、アプリケーショングループに適用されたタグは移行されますが、マシンに適用されているタグは正しく移行されない場合があります。

1.  **オンプレミス環境のCitrix Studio**の[ **アプリケーション** ]ノードで、 **目的のアプリケーションが一致するデリバリーグループに属していることを確認します**。目的のアプリを選択し、アプリを右クリックして \[ **プロパティ** \] に移動します。
[![プロビジョニング方法 MCS](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-process-001.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-process-001.png)

2.  \[ **グループ** \] ノードをクリックして、問題のアプリが属しているグループを確認します。
[![プロビジョニング方法 MCS](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-process-002.png)](/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-process-002.png)

3.  **PowerShellコンソールに戻り**、 **マージコマンドを実行し** 、 **ByDeliveryGroupNameフラグを使用します** 。これにより、 ****デリバリーグループ名でアプリケーションがフィルタリングされます**** 。構文の完全な例: ```Merge-CvadAcToSite –Applications $true –ByDeliveryGroupName <DG_name><!--NeedCopy-->

プロビジョニング方法 MCS

  1. キーボードの Return (Enter) を押してコマンドを実行し、 yes<!--NeedCopy--> と入力して続行します。 プロビジョニング方法 MCS

  2. 正常に実行および完了すると、出力は次のようになります。 プロビジョニング方法 MCS

  3. Cloud Studio コンソールで、[ アプリケーション ] ノードに移動して更新して、アプリが期待どおりにリストされていることを確認します。アプリケーションを選択し、[ アプリケーションのプロパティ] > [グループ] の順に選択し 、再確認します。

  • 移行ツールを実行する前に Cloud Studio のアプリケーションフォルダ

プロビジョニング方法 MCS

  • クラウドStudio のアプリケーションフォルダ移行ツールの実行後

プロビジョニング方法 MCS

マシン作成サービス (MCS) の対処:MCS 関連ポリシーのインポート

注: ポリシーは、タグ付けされたマシンに適用できます。

前の操作を行った後、 **MCSマシンカタログとデリバリーグループに関連付けられたポリシーをインポートする必要がある場合は**、次の手順に従います。

  1. PowerShell コンソールMerge-CvadAcToSite -GroupPolicies $true<!--NeedCopy--> コマンドを実行し 、次のスクリーンショットに示すように、「yes<!--NeedCopy--> 」と入力して続行し、キーボードのReturn (Enter) キーを押します。 ![MCS(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-policies-001.png)のポリシー]

  2. 正常に実行されると、同様の出力(Added<!--NeedCopy--> 値)が表示されます。次のスクリーンショットは、変更がない行の結果も示しています。(No Change)<!--NeedCopy--> ![MCS(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-policies-002.png)のポリシー]

  3. 実行後、 Cloud Studio ウィンドウを更新し、左側の [ ポリシー ] ノードにアクセスします。 ![MCS(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-policies-003.png)のポリシー]

  4. 次の例に示すように、[Policies Assigned to ] タブをチェックし、オンプレミスのポリシー割り当てと比較します。

  • オンプレミスStudio:

![MCS(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-policies-004.png)のポリシー]

  • クラウドStudio:

![MCS(/en-us/tech-zone/learn/media/poc-guides_citrix-automated-configuration_other-prov-mcs-policies-005.png)のポリシー]

サイト構成をクラウドにインポートする

このステップでは、 顧客接続の詳細を取得しゾーンマッピングを手動で作成し、クラウドテナントに構成をインポートします。 注: PVS および MCSの場合は、まず、このガイドの「サイト構成をクラウドセクションにインポートする」 の下にある対応するサブセクションに従います。

カスタマー接続の詳細の取得

管理者はCustomerInfo.ymlファイルを編集し、 対応する顧客名、顧客ID、および secretKey の値を追加する必要があります。これらの値は、次の手順に示すように、 クラウドポータルから取得して生成できます

  1. まず、メモ帳などのテキストエディタアプリケーションを使用してCustomerInfo.ymlファイルを開きます。次のスクリーンショットは、編集する必要があるCustomerInfo.ymlファイル値(赤の下線)を示しています。 設定のインポート

  2. クラウドポータルもう一度ハンバーガーメニューをクリックしID とアクセス管理に移動します設定のインポート

  3. [ API Access ] タブに移動し、次のスクリーンショット(赤い長方形)に示すように、 customer ID<!--NeedCopy--> テキストの隣にある顧客IDの値をコピーします設定のインポート

  4. 取得した値を、 CustomerInfo.yml ファイル内の CustomerIdフィールドに続く引用符の間に、(引用符) の間に貼り付けます。 設定のインポート

  5. クラウドポータルに戻り、[ ID とアクセス管理 ] ポータルおよび [ API アクセス ] タブで、[セキュアクライアントの名前] ボックスに、この API キーを識別する名前を入力します。次に、[クライアントの作成] ボタンをクリックします。注: このアクションは、Client ID<!--NeedCopy--> Secret Key<!--NeedCopy--> を生成します。 設定のインポート

  6. ID<!--NeedCopy--> Secret<!--NeedCopy--> の値を 1 つずつコピーします (次の手順に示すように、CustomerInfo.yml<!--NeedCopy--> ファイルに貼り付けます)。その後、[ ダウンロード ] をクリックして、後で参照できるようにファイルを保存します。 設定のインポート

  7. ID<!--NeedCopy--> およびSecret<!--NeedCopy--> の値をCustomerInfo.yml<!--NeedCopy--> ファイル内の対応するフィールドに貼り付けます。 設定のインポート

ゾーンマッピングファイル (ZoneMapping.yML) を手動で作成する

オンプレミスゾーンはクラウドリソースロケーションに自動的に移行できないためZoneMapping.yml<!--NeedCopy--> ファイルを使用してマッピングする必要があります。注: ゾーンが同名のリソースロケーション ( まったく同じ名前のリソースロケーション) にマップされていない場合、移行エラーが発生します。

  1. .ymlファイルがあるディレクトリ(Documents\Citrix\AutoConfig)<!--NeedCopy--> に戻り、メモ帳または任意のテキストエディタを使用してZoneMapping.yml<!--NeedCopy--> を開きます 。注:Primary<!--NeedCopy--> の値は、(オンプレミス環境で) オブジェクトの移行元となる対応するゾーンの名前に置き換える必要がありますゾーンマッピング

  2. この名前は、 オンプレミスのCitrix Studio コンソール>[構成]>[ゾーン]で確認できます。注: オンプレミス環境でゾーンの名前がPrimary<!--NeedCopy--> の場合、ZoneMapping.yml<!--NeedCopy--> ファイルのこの値を変更する必要はありません。 ゾーンマッピング

  3. それでもZoneMapping.yml<!--NeedCopy--> ファイル上で、 Name_Of_Your_Resource_Zone<!--NeedCopy--> 値はクラウドリソースの場所の名前に置き換える必要があります。この値は、ハンバーガーメニュー > [ リソースの場所] のクラウドポータルで確認できます。 ゾーンマッピング

  4. リソースの場所名をコピーします (次のスクリーンショットにMy Resource Location<!--NeedCopy--> として示されています)。 ゾーンマッピング

  5. Name_Of_Your_Resouce_Zone<!--NeedCopy--> 値の代わりにこの値をZoneMapping.yml<!--NeedCopy--> ファイルに貼り付けます。 ゾーンマッピング

  • 注: オンプレミス環境の複数のゾーンは、クラウド内の 1 つのリソースロケーションにマッピングすることもできます 。ただし、 **オンプレミス環境のゾーンごとに、ファイルには常に 1 つの行が必要です。オンプレミスの複数のゾーンと**1 つのリソースロケーションの場合、このファイルの形式は次のようになります。

ゾーンマッピング

**ゾーンを別のリソースの場所にマップする場合**、ファイルは次のようになっている必要があります。

ゾーンマッピング

構成のマージ

  1. 移行ツールの PowerShell コンソールに戻り、次のコマンドMerge-CvadAcToSite<!--NeedCopy--> を実行します。既存のクラウド構成 (存在する場合) を、オンプレミスサイトからエクスポートされた構成にマージします。 設定のマージ

  2. 各タスクが正常に実行されると、 .yml ファイルがインポートされ、対応するコンポーネントがクラウドサイトに追加されると、出力は緑色になります。 設定のマージ

  3. 結果のファイルは、次のディレクトリに表示されます。 <This PC>\Documents\Citrix\AutoConfig\Import_<YYYY_MM_DD_HH_mm_ss><!--NeedCopy--> 設定のマージ

  4. この同じフォルダには、 Backup_YYYY_MM_DD_HH_mm_ss<!--NeedCopy--> フォルダがあります。注: このフォルダは、構成のバックアップであるため、安全な場所にコピーしてください。

  5. Backup<!--NeedCopy--> フォルダには、必要に応じて変更を元に戻すのに役立つ次のファイルが含まれています。 設定のマージ

クラウドStudio で作成された設定の確認

  1. クラウドコンソール> [ マイサービス] > [Virtual Apps and Desktops サービス] > [ 管理 ] タブから [Virtual Apps and Desktops] サービスの [管理] タブにアクセスします)。 設定の確認

  2. 更新して、 マシンカタログデリバリーグループポリシータグ、 およびアプリケーションが期待どおりに表示されることを確認します注: インポートする内容に応じて、独自の構成に固有の結果として異なります。各セクションを確認して 、予想される項目がリストされていることを確認します。

  • マシンカタログリストの例:

設定の確認

すべてが期待どおりに見える場合は、CVADS の移行は完了です。

トラブルシューティングのヒント

トラブルシューティングに関する一般的な情報:

  • コマンドレットを実行すると、 **ログファイルとマスター履歴ログファイルにエントリが作成されます**。エントリには、実行の日付、操作、結果、バックアップ、ログファイルの場所が含まれます。このログは、一般的なエラーに対する潜在的な解決策と修正を提供します。
  • マスター履歴ログは、%HOMEPATH%\Documents\Citrix\AutoConfig<!--NeedCopy--> History.Log<!--NeedCopy--> という名前のファイルにあります。 * すべての操作ログファイルは、バックアップフォルダに格納されます。
  • すべてのログファイル名はCitrixLog<!--NeedCopy--> で始まり 、auto-config<!--NeedCopy--> 操作と、コマンドレット実行の日付タイムスタンプが表示されます 。
  • ログは自動削除されません

さらに、以下の情報を参照してください:

  1. 自動構成ツールのトラブルシューティングに関する FAQ 記事を参照してください。

  2. また、サポートフォーラム経由で手を差し伸べることができます。

  3. 8 月 19 日のオンデマンドウェビナー録画をご覧ください「Citrix Cloudの移行がかつてないほど簡単になる理由」。このオンラインセミナーでは、ツールの詳細情報を共有し、 CitrixエキスパートのパネルとライブQ&Aセッションを開催しました

  4. 前述の情報を参照してもサポートが必要な場合は、Citrix担当者、カスタマーサクセスマネージャ、またはサポートにお問い合わせください。