マシンカタログを管理する

注：

バージョン2511以降、Citrix Web Studio（Webベース）はCitrix Virtual Apps and Desktops™の唯一の管理コンソールです。Citrix Studio（MMCベース）はインストーラーから削除されました。この記事はWeb Studioにのみ適用されます。Citrix Studioに関する情報については、Citrix Virtual Apps and Desktops 7 2212以前の同等の記事を参照してください。

はじめに

マシンカタログへのマシンの追加または削除、名前の変更、説明の変更、またはカタログのActive Directoryコンピューターアカウントの管理を行うことができます。

カタログの保守には、各マシンが最新のOSアップデート（ウイルス対策アップデート、オペレーティングシステムのアップグレード、または構成変更を含む）を適用していることを確認することも含まれます。

• Machine Creation Services™ (MCS) を使用して作成されたプールされたランダムマシンを含むカタログは、カタログで使用されるマスターイメージを更新し、その後マシンを更新することによってマシンを保守します。この方法により、多数のユーザーマシンを効率的に更新できます。
• 静的で永続的に割り当てられたマシンを含むカタログ、およびリモートPCアクセス マシンカタログの場合、ユーザーマシンの更新はWeb Studioの外部で管理します。このタスクは、個別に、またはサードパーティのソフトウェア配布ツールを使用して一括で実行します。

ホストハイパーバイザーへの接続の作成と管理については、「接続とリソース」を参照してください。

注：

MCSはWindows 10 IoT CoreおよびWindows 10 IoT Enterpriseをサポートしていません。詳細については、Microsoftサイトを参照してください。

永続インスタンスについて

永続インスタンスまたは専用インスタンスを使用して作成されたMCSカタログを更新する場合、カタログ用に作成された新しいマシンは更新されたイメージを使用します。既存のインスタンスは元のインスタンスを引き続き使用します。イメージの更新プロセスは、他の種類のカタログと同じ方法で行われます。以下を考慮してください。

• 永続ディスクカタログの場合、既存のマシンは新しいイメージに更新されませんが、カタログに追加される新しいマシンは新しいイメージを使用します。
• 非永続ディスクカタログの場合、マシンイメージはマシンがリセットされるたびに更新されます。
• 永続的なマシンカタログの場合、イメージを更新すると、それを使用するカタログインスタンスも更新されます。
• 永続的でないカタログの場合、異なるマシンに異なるイメージを使用したい場合は、イメージを別々のカタログに配置する必要があります。

マシンカタログの管理

マシンカタログは、次の2つの方法で管理できます。

• ウェブスタジオの使用
• パワーシェルの使用

ウェブスタジオを使用する

このセクションでは、Web Studioを使用してカタログを管理する方法について詳しく説明します。

• マシンカタログの管理
  • はじめに
  • 永続インスタンスについて
• マシンカタログの管理
• ウェブスタジオを使用する
• カタログの詳細の表示
  • カタログへのマシンの追加
  • カタログからマシンを削除する(#delete-machines-from-a-catalog)
• カタログを編集する(#edit-a-catalog)
• カタログの名前を変更する(#rename-a-catalog)
• カタログを別のゾーンに移動する(#move-a-catalog-to-a-different-zone)
• カタログを削除する(#delete-a-catalog)
• Convert legacy MCS catalogs in Azure to machine profile-based catalogs
• カタログ内のActive Directoryコンピューターアカウントを管理する(#manage-active-directory-computer-accounts-in-a-catalog)
• カタログを更新する(#update-a-catalog)
  • マスターイメージを更新または作成する(#update-or-create-a-master-image)
  • マスターイメージを変更する(#change-the-master-image)
  • マスターイメージをロールバックする(#roll-back-the-master-image)
• 機能レベルを変更または変更を元に戻す(#change-the-functional-level-or-undo-the-change)
• カタログをクローンする(#clone-a-catalog)
• フォルダーを使用してカタログを整理する(#organize-catalogs-using-folders)
  • カタログフォルダーを作成する(#create-a-catalog-folder)
  • カタログを移動する(#move-a-catalog)
  • カタログフォルダーを管理する(#manage-catalog-folders)
• VDAをアップグレードする(#upgrade-vdas)
• カタログ作成を再試行する(#retry-catalog-creation)
• トークンを使用してMCS以外でプロビジョニングされたVDAを登録する(#enroll-non-mcs-provisioned-vdas-using-tokens)
• パワーシェルを使用する(#use-powershell)
• カタログに関連付けられている警告とエラーを取得する(#retrieve-warnings-and-errors-associated-with-a-catalog)
• イメージに説明を追加する(#add-descriptions-to-an-image)
• OSディスクをリセットする(#reset-os-disk)
• 既存のプロビジョニングスキームのネットワーク設定を変更する(#change-the-network-setting-for-an-existing-provisioning-scheme)
• マシンカタログのバージョンを管理する(#manage-versions-of-a-machine-catalog)
• マシンプロファイルに基づかないマシンカタログをマシンプロファイルに基づくマシンカタログに変換する(#convert-a-non-machine-profile-based-machine-catalog-to-machine-profile-based-machine-catalog)
• アクティブなコンピューターアカウントのID情報を修復する(#repair-the-identity-information-of-active-computer-accounts)
  • 条件(#conditions)
  • IDディスクをリセットする(#reset-identity-disk)
• 既存のマシンカタログでキャッシュ構成を変更する(#change-cache-configuration-on-an-existing-machine-catalog)
  • 要件(#requirements)
  • キャッシュ構成を変更する(#change-the-cache-configuration)
• ローカルファイル共有アクセスによるVDA更新のサポート(#vda-update-support-via-local-file-share-access)
  • パワーシェル コマンドレット
  • 前提条件(#prerequisites)
  • ファイル共有権限の設定方法(#how-to-set-file-share-permissions)
  • ローカルファイル共有からのVDA更新(#vda-updates-from-a-local-file-share)
• トラブルシューティング(#troubleshoot)
• 次のステップ(#where-to-go-next)

カタログの詳細を表示する

1. 検索機能を使用して、特定のマシンカタログを見つけます。手順については、インスタンスの検索を参照してください。
2. 検索結果から、必要に応じてカタログを選択します。
3. カタログ列の説明については、次の表を参照してください。

4. カタログ列の説明については、次の表を参照してください。

   列	説明文
   マシンカタログ	カタログの名前と割り当てタイプ。割り当てタイプには以下が含まれます。 • ランダム: カタログ内のマシンはユーザーにランダムに割り当てられます。 • 永続: カタログ内のマシンはユーザーに永続的に割り当てられます。
   マシンタイプ	カタログ内のマシンでサポートされているセッションタイプ。可能な値には以下が含まれます。 • OSタイプ: マルチセッションOS (仮想); ユーザーデータ: 破棄。 • OSタイプ: マルチセッションOS (仮想); ユーザーデータ: ローカルディスク上 • OSの種類: シングルセッションOS (リモートPCアクセス) • OSの種類: シングルセッションOS (仮想); ユーザーデータ: 破棄 • OSの種類: シングルセッションOS (仮想); ユーザーデータ: ローカルディスク上
   マシン数	カタログ内のマシン数とプロビジョニング方法。可能なプロビジョニング方法には、Machine Creation Services (MCSマシン)、手動、およびCitrix Provisioning™ Servicesがあります。
   割り当て済み数	デリバリーグループに割り当てられているカタログ内のマシン数。
   フォルダー	マシンカタログツリー内のカタログの場所。カタログが存在するフォルダーの名前 (末尾のバックスラッシュを含む) を表示します。カタログがルートレベルにある場合は - と表示されます。
   VDAアップグレード	VDAアップグレードの状態。可能な値は、未構成、スケジュール済み、利用可能、最新です。
   イメージステータス	カタログのイメージ更新のステータス。非永続マシンカタログにのみ適用されます。可能な値は、完全に更新済み、部分的に更新済み、更新保留中、準備中です。

5. 選択したカタログに関する詳細情報を表示するには、下部の詳細ペインでタブをクリックします。

   タブ	説明文
   詳細	マシンタイプ、プロビジョニング方法、サービスアカウント、OS、VDAバージョンなど、主要なマシンカタログ設定を要約し、リソースをすばやく表示および管理できるようにします。
   テンプレートプロパティ	MCSでプロビジョニングされたカタログでのみ利用可能です。 選択したカタログの詳細なプロビジョニング情報を表示します。これには以下が含まれます。 • マシンテンプレートプロパティ • ハイパーバイザー固有の詳細 • マシンプロファイルプロパティ
   マシン	選択したカタログ内のマシン名がページ分割されたリストで表示されます。
   デリバリーグループ	Remote PCカタログで利用可能です。 選択したカタログに関連付けられているデリバリーグループが表示されます。デリバリーグループ名とカタログの関連付けが表示されます。
   タグ	マルチテナント環境では利用できません。 選択したマシンカタログに割り当てられているタグのタグ名と説明が表示されます。
   ワークスペース環境管理	WEMサービスがプロビジョニングされ、アクセス可能な場合にのみ表示されます。 ワークスペース環境管理システムの最適化設定が表示されます。
   コストインサイト	Azure MCSカタログにのみ適用され、以下が表示されます • 過去30日間に発生した総コスト。 • 現在の30日間の総コストと、その前の30日間の期間との比較。 タブを表示するには、Citrixのコスト管理 > 管理 > コストの読み取り権限（クラウド管理者にはデフォルトで付与）が必要です。また、コストの詳細を表示するにはMicrosoft.CostManagement/query/read Azure権限が必要です。
   トラブルシューティング	カタログのエラーまたは警告と、推奨されるアクションが表示されます。

カタログにマシンを追加する

開始する前に：

• 仮想化ホストに、追加のマシンを収容するための十分なプロセッサ、メモリ、およびストレージがあることを確認してください。
• 未使用のActive Directoryコンピューターアカウントが十分にあることを確認してください。既存のアカウントを使用している場合、追加できるマシンの数は利用可能なアカウントの数によって制限されます。
• Web Studioを使用して追加のマシン用のActive Directoryコンピューターアカウントを作成する場合、適切なドメイン管理者権限が必要です。

カタログにマシンを追加するには：

1. Web Studio にサインインします。
2. 左側のペインで [マシンカタログ] を選択します。
3. マシンカタログを選択し、アクションバーで [マシンの追加] を選択します。
4. 追加する仮想マシンの数を選択します。
5. 追加するVMの数に対して既存のActive Directoryアカウントが不足している場合は、アカウントが作成されるドメインと場所を選択します。連続する数字または文字が表示される場所を示すためにハッシュマークを使用して、アカウントの命名スキームを指定します。OU名にスラッシュ (/) を使用しないでください。名前に数字を使用することはできません。たとえば、PC-Sales-## (0-9が選択されている場合) という命名スキームは、PC-Sales-01、PC-Sales-02、PC-Sales-03などのコンピューターアカウントになります。
6. 既存のActive Directoryアカウントを使用する場合は、アカウントを参照するか、[インポート] をクリックしてアカウント名を含む.csvファイルを指定します。追加するすべてのマシンに対して十分なアカウントがあることを確認してください。Web Studioはこれらのアカウントを管理します。Web Studioがすべてのアカウントのパスワードをリセットすることを許可するか、すべてのアカウントで同じである必要があるアカウントパスワードを指定します。

マシンはバックグラウンドプロセスとして作成され、多数のマシンを作成する場合は時間がかかることがあります。Web Studioを閉じても、マシンの作成は続行されます。

カタログからマシンを削除する

マシンカタログからマシンを削除すると、ユーザーはそのマシンにアクセスできなくなるため、マシンを削除する前に、次のことを確認してください。

• ユーザーデータがバックアップされているか、不要になっていること。
• すべてのユーザーがログオフしていること。メンテナンスモードをオンにすると、マシンへの新しい接続が停止します。
• マシンがシャットダウンされていること。

カタログからマシンを削除するには：

1. Web Studio にサインインします。
2. 左側のペインで [マシンカタログ] を選択します。
3. カタログを選択し、アクションバーで [マシンの表示] を選択します。
4. 1つ以上のマシンを選択し、アクションバーで [削除] を選択します。

削除するマシンを削除するかどうかを選択します。マシンを削除することを選択した場合、それらのマシンのActive Directoryアカウントを保持するか、無効にするか、削除するかを指定します。

カタログを編集する

1. [説明] ページで、カタログの説明を変更します。
2. 左ペインで [マシンカタログ] を選択します。
3. カタログを選択し、アクションバーで [マシンカタログの編集] を選択します。
4. [スコープ] ページで、スコープを変更します。

5. [NIC] ページで、次のアクションを実行します。

   • NICのサブネットマッピングを変更するには、[関連付けられたネットワーク] フィールドからネットワークを選択します。
   • サブネットマッピングを追加するには、[NICの追加] を選択し、[関連付けられたネットワーク] フィールドからネットワークを選択して、[保存] をクリックします。

   カタログに関連付けられているホストに存在するサブネットのみが、[関連付けられたネットワーク] フィールドに表示されます。

   マシンプロファイルのないAzureマシンカタログにのみNICを追加できます。

   注：

   • AWSマシンカタログの場合、同じサブネットを複数のNICにマッピングすることはできません。
   • マシンプロファイルを持つマシンカタログの場合、カタログ上のNICの数はマシンプロファイル上のNICの数と等しくなければなりません。
   • この機能は、IBM Cloudハイパーバイザーではサポートされていません。
   • この機能は、Nutanixハイパーバイザーの場合、Nutanix Prism Elementでのみサポートされています。

6. カタログの種類によっては、他のページが表示される場合があります。

   Azure Resource Managerイメージを使用して作成されたカタログの場合、以下のページが表示されます。行った変更は、後でカタログに追加するマシンにのみ適用されることに注意してください。既存のマシンは変更されません。

   • 仮想マシンページで、マシンのサイズと、マシンを作成するアベイラビリティゾーンを変更します。

     注:

     • カタログがサポートするマシンサイズのみが表示されます。
     • 必要に応じて、他のマシンカタログで使用されているマシンサイズのみを表示を選択して、マシンサイズリストをフィルタリングします。
     • Azureカタログの場合、ストレージとライセンスの種類ページでストレージ冗長性がZRSである場合、ゾーン選択をクリアしてAzureにVMアベイラビリティゾーンを管理させることを推奨する警告が表示されます。

   • マシンプロファイルページで、マシンプロファイルを使用するか変更するかを選択します。

     注:

     Azureカタログの場合、アベイラビリティゾーンを含むマシンプロファイルを変更し、ストレージ冗長性にZRSを選択すると、ゾーン選択をクリアするよう促す警告が表示されます。

   • (カタログが専用グループホストで構成されている場合にのみ表示) 専用ホストグループページで、ホストグループを変更するかどうかを選択します。

   • ストレージとライセンスの種類ページで、ストレージ冗長性タイプ（Azureカタログの場合）、ストレージタイプ、ライセンスタイプ、およびAzure Computer Gallery設定（準備されたイメージをAzureギャラリーに配置が使用されている場合にのみ利用可能）を変更するかどうかを選択します。

   注:

   新しく選択した設定が現在のマシンサイズをサポートしていない場合、設定を変更するとマシンサイズ設定がリセットされることを通知する警告ダイアログボックスが表示されます。続行を選択すると、仮想マシンメニューの横に赤い点が表示され、新しいマシンサイズを選択するように促されます。

   • 「ライセンスの種類」ページで、WindowsライセンスまたはLinuxライセンスの設定を変更するかどうかを選択します。

   リモートPCアクセス カタログの場合、次のページが表示されます。

   • 「電源管理」ページで、電源管理設定を変更し、電源管理接続を選択します。
   • 「組織単位」ページで、Active Directory OU を追加または削除します。
7. 加えた変更を適用するには、適用をクリックし、終了するには保存をクリックします。

カタログの名前を変更する

1. Web Studioにサインインします。
2. 左ペインでマシンカタログを選択します。
3. カタログを選択し、アクションバーでマシンカタログ名の変更を選択します。
4. 新しい名前を入力します。

カタログを別のゾーンに移動する

展開に複数のゾーンがある場合、あるゾーンから別のゾーンにカタログを移動できます。

カタログを、そのカタログ内のVMを含むハイパーバイザー以外のゾーンに移動すると、パフォーマンスに影響します。

1. Web Studioにサインインします。
2. 左ペインでマシンカタログを選択します。
3. カタログを選択し、アクションバーで移動を選択します。
4. カタログを移動するゾーンを選択します。

カタログを削除する

カタログを削除する前に、以下を確認してください。

• すべてのユーザーがログオフしており、切断されたセッションが実行されていないこと。
• カタログ内のすべてのマシンでメンテナンスモードがオンになっており、新しい接続ができないこと。
• カタログ内のすべてのマシンが電源オフになっていること。
• カタログがデリバリーグループに関連付けられていないこと。つまり、デリバリーグループにそのカタログのマシンが含まれていないこと。

カタログを削除するには：

1. Web Studioにサインインします。
2. 左ペインでマシンカタログを選択します。
3. カタログを選択し、アクションバーでマシンカタログの削除を選択します。
4. カタログ内のマシンを削除するかどうかを指定します。マシンを削除することを選択した場合、それらのマシンのActive Directoryコンピューターアカウントを保持するか、無効にするか、削除するかを指定します。

AzureのレガシーMCSカタログをマシンプロファイルベースのカタログに変換する

マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換するには、次の手順を実行します。

1. マシンカタログページで、変換するマシンカタログ名を右クリックし、マシンカタログの編集を選択します。
2. マシンカタログの編集 > マシンプロファイルページで、マシンプロファイルを使用する (Microsoft Entra ID に必須)チェックボックスをオンにします。
3. マシンプロファイルの選択をクリックします。
4. マシンプロファイルの選択ページで、マシンプロファイルとして使用する仮想マシンまたは起動テンプレートを選択します。
5. 現在の一部の設定が新しいマシンプロファイルの設定と異なる場合は、使用したい設定の必要なオプションを選択し、続行をクリックします。
6. 適用をクリックします。

注：

現在、この機能はAzure、AWS、およびVMwareのみでサポートされています。

カタログ内のActive Directoryコンピューターアカウントを管理する

マシンカタログ内のActive Directoryアカウントを管理するには、次のことができます。

• シングルセッションOSおよびマルチセッションOSカタログからActive Directoryコンピューターアカウントを削除して、未使用のマシンアカウントを解放します。これらのアカウントは、他のマシンで使用できます。
• カタログにマシンが追加されたときにコンピューターアカウントがすでに存在するようにアカウントを追加します。OU名にスラッシュ (/) を使用しないでください。

Active Directoryアカウントを管理するには：

1. Web Studioにサインインします。
2. 左ペインでマシンカタログを選択します。
3. カタログを選択し、アクションバーでADアカウントの管理を選択します。

4. コンピューターアカウントを追加するか削除するかを選択します。アカウントを追加する場合は、アカウントのパスワードをどうするかを指定します。すべてリセットするか、すべてのアカウントに適用されるパスワードを入力します。

   現在のアカウントパスワードが不明な場合は、パスワードをリセットできます。パスワードリセットを実行する権限が必要です。パスワードを入力すると、アカウントがインポートされる際にパスワードが変更されます。アカウントを削除する際は、Active Directory内のアカウントを保持するか、無効にするか、削除するかを選択します。

カタログからマシンを削除したり、カタログを削除したりする際に、Active Directoryアカウントを保持するか、無効にするか、削除するかを指定します。

カタログを更新する

カタログ内のマシンを更新する前に、マスターイメージのコピーまたはスナップショットを保存することをお勧めします。データベースには、各マシンカタログで使用されたマスターイメージの履歴が保持されます。カタログ内のマシンを以前のバージョンのマスターイメージに戻す（ロールバックする）ことができます。ユーザーがデスクトップに展開した更新プログラムで問題が発生した場合に、このタスクを実行します。これにより、ユーザーのダウンタイムが最小限に抑えられます。マスターイメージを削除、移動、または名前変更しないでください。それらを使用してカタログを元に戻すことはできません。

マシンが更新されると、自動的に再起動します。

マスターイメージを更新または作成する

マシンカタログを更新する前に、既存のマスターイメージを更新するか、ホストハイパーバイザー上に新しいマスターイメージを作成します。

1. ハイパーバイザーで、現在のVMのスナップショットを取得し、意味のある名前を付けます。このスナップショットは、必要に応じてカタログ内のマシンを元に戻す（ロールバックする）ために使用できます。
2. 必要に応じて、マスターイメージの電源をオンにし、ログオンします。
3. 更新プログラムをインストールするか、マスターイメージに必要な変更を加えます。
4. VMの電源をオフにします。
5. VMのスナップショットを作成します。Web Studioでカタログが更新されたときに認識されるような、意味のある名前を付けます。Web Studioでスナップショットを作成することもできますが、Citrixではハイパーバイザー管理コンソールを使用して作成することをお勧めします。その後、Web Studioでそのスナップショットを選択します。このプロセスにより、自動生成された名前ではなく、意味のある名前と説明を提供できます。GPUマスターイメージの場合、マスターイメージはXenServer®コンソールからのみ変更できます。

マスターイメージの変更

カタログ内のすべてのマシンに更新を準備して展開するには：

1. Web Studioにサインインします。
2. 左ペインで [マシンカタログ] を選択します。
3. カタログを選択し、アクションバーで [マスターイメージの変更] を選択します。
4. [イメージ] ページで、展開するホストとイメージを選択します。

   ヒント：

   MCSで作成されたカタログの場合、イメージにメモを追加して注釈を付けることができます。メモは最大500文字まで入力できます。マスターイメージを変更するたびに、メモを追加したかどうかにかかわらず、メモ関連のエントリが作成されます。メモを追加せずにカタログを更新した場合、エントリはnull (-)として表示されます。イメージのメモ履歴を表示するには、カタログを選択し、下部ペインで [テンプレートプロパティ] をクリックし、[メモ履歴の表示] をクリックします。

5. [展開戦略] ページで、マシンカタログ内のマシンを新しいマスターイメージで更新するタイミング（次回のシャットダウン時または即時）を選択します。

   注：

   [展開戦略] ページは、展開が非永続VMにのみ適用されるため、永続VMでは利用できません。

6. [概要] ページで情報を確認し、[完了] をクリックします。各マシンは更新後に自動的に再起動します。

更新の進行状況を追跡するには、[マシンカタログ] でカタログを見つけて、インラインの進行状況バーと段階的な進行状況グラフを表示します。

Web StudioではなくPowerShell SDKを直接使用してカタログを更新する場合は、ハイパーバイザーテンプレート (VMTemplates) を指定します。これをイメージまたはイメージのスナップショットの代替として使用します。

Azureベースのマシンカタログに新しいマスターイメージを展開するには:

1. Web Studioから、左ペインでマシンカタログを選択します。
2. Azureカタログを選択し、アクションバーでマスターイメージの変更を選択します。
3. マスターイメージの変更ページで、マスターイメージの下にあるイメージを選択します。ブレードには、リソースと同じリージョンに属するすべてのイメージが一覧表示されます。

展開戦略:

次回のシャットダウン時にイメージを更新すると、現在使用されていないマシン、つまりアクティブなユーザーセッションがないマシンにすぐに影響します。使用中のシステムは、現在のアクティブセッションが終了したときに更新を受け取ります。以下を考慮してください:

• 該当するマシンでの更新が完了するまで、新しいセッションを起動することはできません。
• シングルセッションOSマシンでは、マシンが使用されていないとき、またはユーザーがログインしていないときに、マシンはすぐに更新されます。
• 子マシンを持つマルチセッションOSの場合、再起動は自動的に行われません。更新されたマスターイメージを適用するには、Studio、PowerShell、またはWorkspaceを使用してマシンを再起動します。マシンまたはハイパーバイザーから再起動しても、更新は適用されません。

ヒント:

ホスト接続の詳細設定を使用して、再起動されるマシンの数を制限します。これらの設定を使用して、特定のカタログに対して実行されるアクションを変更します。詳細設定はハイパーバイザーによって異なります。

マスターイメージをロールバックする

更新された、または新しいマスターイメージを展開した後、それをロールバックできます。このプロセスは、新しく更新されたマシンで問題が発生した場合に必要になることがあります。ロールバックすると、カタログ内のマシンは最後に機能していたイメージにロールバックされます。新しいイメージを必要とする新機能は利用できなくなります。展開と同様に、マシンのロールバックには再起動が含まれます。

1. Web Studioにサインインします。
2. 左ペインでマシンカタログを選択します。
3. カタログを選択し、アクションバーでマスターイメージのロールバックを選択します。
4. ロールアウト操作に関する前のセクションで説明されているように、以前のマスターイメージをマシンに適用するタイミングを指定します。

ロールバックは、元に戻す必要があるマシンにのみ適用されます。新規または更新されたマスターイメージで更新されていないマシンは、通知メッセージを受信せず、強制的にログオフされることもありません。

ロールバックの進行状況を追跡するには、マシンカタログでカタログを見つけ、インラインの進行状況バーと段階的な進行状況グラフを表示します。

機能レベルを変更または変更を元に戻す

マシンのVDAを新しいバージョンにアップグレードした後、マシンカタログの機能レベルを変更します。Citrixでは、すべての最新機能にアクセスできるように、すべてのVDAを最新バージョンにアップグレードすることをお勧めします。

マシンカタログの機能レベルを変更する前に

• アップグレードされたマシンを起動して、Controllerに登録させます。このプロセスにより、Web Studioはカタログ内のマシンがアップグレードを必要としていることを判断できます。

カタログの機能レベルを変更するには

1. Web Studioにサインインします。
2. 左ペインでマシンカタログを選択します。
3. カタログを選択します。下部のペインにある詳細タブにバージョン情報が表示されます。
4. 機能レベルの変更を選択します。Web Studioがカタログのアップグレードが必要であると検出した場合、メッセージが表示されます。プロンプトに従ってください。1台以上のマシンをアップグレードできない場合、その理由を説明するメッセージが表示されます。すべてのマシンが適切に機能するように、Citrixは変更をクリックして続行する前に、マシンの問題を解決することをお勧めします。

カタログの変更が完了した後、カタログを選択し、アクションバーで機能レベルの変更を元に戻すを選択することで、マシンを以前のVDAバージョンに戻すことができます。

カタログをクローンする

カタログをクローンする前に、以下の考慮事項に注意してください。

• オペレーティングシステムおよびマシン管理に関連する設定は変更できません。クローンされたカタログは、元のカタログからこれらの設定を継承します。

注:

クローンするAzureカタログを選択し、マスターイメージを選択すると、ブレードにはリソースと同じリージョンに属するすべてのイメージが一覧表示されます。

• カタログのクローンには時間がかかる場合があります。必要に応じて、「進行状況を非表示」を選択して、バックグラウンドでクローンを実行します。
• クローンされたカタログは元のカタログの名前を継承し、サフィックスCopyが付きます。名前は変更できます。カタログの名前変更を参照してください。
• クローンが完了したら、クローンされたカタログをデリバリーグループに割り当ててください。

1. Web Studioにサインインし、左ペインで「マシンカタログ」を選択します。
2. カタログを選択し、アクションバーで「クローン」を選択します。
3. 「選択したマシンカタログのクローン」ウィンドウで、クローンされたカタログの設定を表示し、必要に応じて設定を構成します。「次へ」を選択して次のページに進みます。
4. 「概要」ページで、設定の概要を確認し、「完了」を選択してクローンを開始します。
5. 必要に応じて、「進行状況を非表示」を選択して、バックグラウンドでクローンを実行します。

フォルダーを使用してカタログを整理する

フォルダーを作成してカタログを整理し、簡単にアクセスできるようにすることができます。たとえば、イメージの種類別や組織構造別にカタログを整理できます。

ヒント:

「Machine Catalogs」ノードの優先するデフォルトビュー（フォルダービューまたはリストビュー）を、アクションバーの右上にある フォルダー アイコンをクリックして設定できます。

カタログフォルダーを作成する

開始する前に、まずカタログの整理方法を計画してください。以下を考慮してください。

• フォルダーは最大5階層までネストできます（デフォルトのルートフォルダーを除く）。
• カタログフォルダーには、カタログとサブフォルダーを含めることができます。

• Web Studio のすべてのノード（マシンカタログ、デリバリーグループ、アプリケーション、アプリケーショングループ など）は、バックエンドで同じフォルダーツリーを共有します。フォルダーの名前変更や移動時に名前の競合を避けるため、異なるノード間で最上位フォルダーには一意の名前を使用してください。

  New-BrokerAdminFolder SDK コマンドレットを使用してフォルダーを作成し、それを マシンカタログ ノードの下に表示させたい場合は、Set-BrokerAdminFolderMetadata コマンドレットを使用して ContainsMachineCatalogs メタデータを追加する必要があります。

  例:

   Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
   <!--NeedCopy-->
  

カタログフォルダーを作成するには、次の手順に従います。

1. 左側のペインで マシンカタログ を選択します。
2. フォルダー階層でフォルダーを選択し、アクション バーで フォルダーの作成 を選択します。
3. 新しいフォルダーの名前を入力し、完了 をクリックします。

ヒント:

意図しない場所にフォルダーを作成してしまった場合は、正しい場所にドラッグできます。

カタログを移動する

カタログをフォルダー間で移動できます。詳細な手順は次のとおりです。

1. 左ペインでマシンカタログを選択します。
2. フォルダー別にカタログを表示します。フォルダー階層の上にあるすべて表示をオンにすると、すべてのカタログを一度に表示することもできます。
3. カタログを右クリックし、マシンカタログの移動を選択します。
4. カタログを移動するフォルダーを選択し、完了をクリックします。

ヒント:

カタログをフォルダーにドラッグできます。

カタログフォルダーの管理

カタログフォルダーを削除、名前変更、移動できます。

フォルダーとそのサブフォルダーにカタログが含まれていない場合にのみ、フォルダーを削除できます。

フォルダーを管理するには、以下の手順に従います。

1. 左ペインでマシンカタログを選択します。

2. フォルダー階層でフォルダーを選択し、必要に応じてアクションバーでアクションを選択します。

   • フォルダーの名前を変更するには、フォルダー名の変更を選択します。
   • フォルダーを削除するには、フォルダーの削除を選択します。
   • フォルダを移動するには、Move Folder を選択します。
3. 画面の指示に従って、残りの手順を完了します。

VDAのアップグレード

Studioインターフェイスを使用して、VDAを簡単にアップグレードできます。詳細および段階的なガイダンスについては、Citrix VDA Upgrade Service ドキュメントを参照してください。

カタログ作成の再試行

注：

この機能はMCSカタログにのみ適用されます。

失敗したカタログにはエラーアイコンが表示されます。詳細を表示するには、各カタログのトラブルシューティングタブに移動します。カタログ作成を再試行する前に、次の考慮事項に注意してください。

• まずトラブルシューティング情報を確認し、問題を解決してください。この情報には、検出された問題が記述されており、それらを解決するための推奨事項が提供されています。
• Operating system および machine management に関連する設定は変更できません。カタログは、元の設定を継承します。
• 作成には時間がかかる場合があります。必要に応じて、進行状況を非表示を選択して、バックグラウンドで作成を実行します。

カタログの作成を再試行するには、次の手順を実行します。

1. Web Studioで、左側のペインで [マシンカタログ] を選択します。
2. カタログを選択し、その [トラブルシューティング] タブに移動します。
3. 再試行ハイパーリンクをクリックして、カタログの作成を再試行します。
4. 表示されるウィザードで、必要に応じて設定を変更します。変更する必要がない場合は、直接概要ページに移動できます。
5. 完了したら、完了を選択して作成を開始します。

トークンを使用して非MCSプロビジョニングVDAを登録する

非MCSプロビジョニングVDAの登録トークンを生成および管理できるようになりました。この実装により、MCSでVDAをプロビジョニングすることなく、WebSocket経由でVDA登録が可能になります。この機能は、Linux Virtual Delivery Agent、macOS用Citrix Virtual Delivery Agent、およびCitrix Virtual Apps™ and Desktopsを使用する非ドメイン参加VDAもサポートします。

始める前に

1. サイトを構成します。詳細については、サイトの作成を参照してください。
2. Delivery ControllerにTLS証明書をインストールします。詳細については、ControllerにTLSサーバー証明書をインストールするを参照してください。
3. Delivery Controllerを信頼するために、VDAにルートCAおよび中間CAをインストールします。

4. Delivery ControllerでWebSocket接続を有効にします。サイトに存在する各Delivery Controllerで次のコマンドを実行します。

   New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
   <!--NeedCopy-->
   

   注：

   WebSocketを有効にした後、Delivery Controllerを必ず再起動してください。

登録トークンの生成

Citrix以外のプロビジョニングマシンに対してトークンベースの登録を有効にすることを決定したら、まずマシンカタログごとにトークンを生成し、VDAインストール管理者と共有する必要があります。

登録トークンの機能：

• 登録範囲：1～5000台のVDAマシン
• 有効期間: 最大14日間

Web Studioを使用してカタログのトークンを生成するには、次の手順に従います。

1. Web Studio > マシンカタログで、マシン数列にプロビジョニング方法: 手動と表示されている、MCSでプロビジョニングされていないカタログを見つけます。
2. カタログを右クリックし、登録トークンの管理を選択します。
3. 表示される登録トークンの生成ページで、次のトークン情報を入力します。
   • トークンの名前を入力します。
   • 有効期間を入力します。期間は14日以内である必要があります。トークンは指定された期間のみ有効です。
   • (オプション) トークンで登録されたVDAの電源管理のためにホスト接続を選択します。オプションには、このカタログのゾーン下のすべてのホスト接続が含まれます。
   • トークンの使用制限を入力します (1～5000の範囲)。
4. 生成をクリックします。

5. 表示されるトークンが正常に生成されましたウィンドウで、トークンをコピーして安全な場所に保存するか、ダウンロードをクリックしてダウンロードフォルダーにダウンロードします。

   トークンリストにトークンレコードが表示されます。

   

6. トークンをVDAインストール管理者と共有します。

   マシンにVDAとトークンをインストールする方法の詳細については、VDAのインストールを参照してください。

トークンの管理

トークンを取り消し、VDA登録に使用できないようにするには、2つのオプションがあります。

• 取り消し: トークンを取り消しますが、ログ記録のためにリストに残します。
• 削除: トークンを取り消し、リストから削除します。

注:

期限切れのトークンは14日後に自動的に削除されます。

WebSocket VDA登録ツールを使用してマシンをカタログに登録する

WebSocket VDA登録ツールは、VDAマシン向けのトークンベースの登録を容易にします。このツールは、登録トークンを使用してVDAをマシンカタログに追加することで、接続をWebSocket接続に変換するのに役立ちます。

注:

このツールは、どのマシンカタログにも登録されていないVDAマシンを登録するために設計されています。

登録ツールを実行するには、以下の手順に従ってください。

1. VDAにログインします。
2. C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Toolにあるツール EnrollMachine.exe を見つけます。
3. 適切な入力パラメーターを指定してツールを実行します。例: EnrollMachine.exe -websocket_token_string:xxxxxxxxx

次の表は、登録ツールの入力パラメーターについて説明しています。

登録が成功すると、ツールとログに成功メッセージが表示されます。Web Studioにサインインして、VDAマシンがカタログに追加され、マシンのステータスが登録済みであることを確認してください。

トラブルシューティング

デフォルトでは、登録ツールのログは次の場所にあります。

C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt

ログに別のパスを指定した場合は、log:[log-file-path]を使用してログを取得できます。

次の表に、登録ツールが返すコードを示します。

パワーシェルを使用する

このセクションでは、PowerShell を使用してカタログを管理する方法について詳しく説明します。

• カタログに関連付けられた警告とエラーの取得
• イメージに説明を追加
• OS ディスクのリセット
• 既存のプロビジョニングスキームのネットワーク設定を変更
• マシンカタログのバージョンを管理
• マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換
• アクティブなコンピューターアカウントのID情報を修復
• 既存のマシンカタログのキャッシュ構成を変更
• ローカルファイル共有アクセスによる VDA 更新のサポート

カタログに関連付けられた警告とエラーの取得

履歴エラーと警告を取得して、MCS マシンカタログの問題を理解し、それらの問題を修正できます。

PowerShell コマンドを使用すると、次のことができます。

• エラーまたは警告のリストを取得する
• 警告の状態を新規から確認済みに変更する
• エラーまたは警告を削除する

PowerShellコマンドを実行するには:

1. PowerShellウィンドウを開きます。
2. Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。

エラーと警告のリストを取得するには:

Get-ProvOperationEventコマンドを実行します。

• パラメーターなし: すべてのエラーと警告を取得します
• LinkedObjectTypeおよびLinkedObjectUidパラメーターを使用: 特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告を取得します
• EventIdパラメーターを使用: このイベントIDに一致する特定のエラーまたは警告を取得します
• Filterパラメーターを使用: カスタマイズされたフィルターによってエラーまたは警告を取得します

エラーまたは警告の状態を新規から確認済みに変更するには:

Confirm-ProvOperationEventコマンドを実行します。

• EventIdパラメーターを使用: このイベントIDに一致する特定のエラーまたは警告の状態を設定します。特定のイベントまたは警告のEventIdは、Get-ProvOperationEventコマンドの出力として取得できます。
• LinkedObjectTypeおよびLinkedObjectUidパラメーターを使用: 特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告の状態を設定します
• All パラメーターを使用すると、すべてのエラーと警告の状態が確認済みとして設定されます。

エラーまたは警告を削除するには:

Remove-ProvOperationEvent コマンドを実行します。

• EventId パラメーターを使用すると、このイベント ID に一致する特定のエラーまたは警告が削除されます。特定のイベントまたは警告の EventId は、Get-ProvOperationEvent コマンドの出力として取得できます。
• LinkedObjectType および LinkedObjectUid パラメーターを使用すると、特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告が削除されます。
• All パラメーターを使用すると、すべてのエラーと警告が削除されます。

詳細については、Citrix PowerShell SDK を参照してください。

ハイパーバイザーアクセスなしでマシンを削除する

VM またはプロビジョニングスキームを削除する場合、MCS は VM から、場合によってはベースディスクからもタグを削除する必要があります。これにより、削除オプションに含まれるリソースが MCS によって追跡または識別されなくなります。ただし、これらのリソースの一部はハイパーバイザーを介してのみアクセス可能です。ハイパーバイザーアクセスがない場合でも、データベースから VM、ベースディスク、ACG 内のイメージなどの VM リソースオブジェクトを削除するには、Remove-ProvVM PowerShell の PurgeDBOnly オプションを使用します。

このオプションは以下で有効になります:

• サポートされているすべてのハイパーバイザー
• 永続的および非永続的 VM

制限事項

-PurgeDBOnly コマンドと -ForgetVM コマンドを同時に使用することはできません。

PurgeDBOnly コマンドを使用する

PowerShellコマンド Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM を実行すると、削除操作は以下のシナリオで失敗する可能性があります。

• ホスト接続がメンテナンスモードになっている
• 無効な資格情報
• 認証処理の失敗
• 許可されていない操作
• ハイパーバイザーに到達できない

注:

Remove-provVM -ForgetVM は永続VMのみを対象とします。リスト内のVMのいずれかが非永続である場合、操作は失敗します。

ハイパーバイザーに到達できないために操作が失敗した場合、次のプロンプトが表示されます。

Try to use -PurgeDBOnly option to clean DDC database.

MCSデータベースからVMの参照を削除するには、Remove-ProvVM PowerShellコマンドで-PurgeDBOnlyオプションを使用します。例：

Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

イメージに説明を追加する

マシンカタログのイメージ更新に関連する変更について、情報を提供する説明を追加できます。この機能を使用して、カタログの作成時、またはカタログの既存のマスターイメージを更新する際に説明を追加します。カタログ内の各マスターイメージの情報を表示することもできます。イメージの説明を追加または表示するには、次のコマンドを使用します。

• マスターイメージを使用してマシンカタログを作成する際にメモを追加するには、NewProvScheme コマンドでパラメーター MasterImageNote を使用します。例：

   C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
   XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
   <!--NeedCopy-->
  

• マシンカタログに関連付けられたマスターイメージを更新するには、Publish-ProvMasterVMImageコマンドでパラメータMasterImageNoteを使用します。例:

   C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
   <!--NeedCopy-->
  

• 各イメージの情報を表示するには、Get-ProvSchemeMasterVMImageHistoryコマンドを使用します。例:

   C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
   <!--NeedCopy-->
  

ロールバックの進行状況を追跡するには、マシンカタログでカタログを見つけ、インラインの進行状況バーと段階的な進行状況グラフを表示します。

次のシナリオを含む特定の状況では、ロールバックできません。(マスターイメージのロールバックオプションは表示されません)。

• ロールバックする権限がありません。
• カタログがMCSを使用して作成されていません。
• カタログがOSディスクのイメージを使用して作成されています。
• カタログの作成に使用されたスナップショットが破損しています。
• カタログ内のマシンに対するユーザーの変更が保持されません。
• カタログ内のマシンが実行中です。

OSディスクのリセット

MCSで作成されたマシンカタログ内の永続VMのOSディスクをリセットするには、PowerShellコマンドReset-ProvVMDiskを使用します。現在、この機能はAWS、Azure、XenServer、Google Cloud、SCVMM、およびVMware仮想化環境に適用できます。

PowerShellコマンドを正常に実行するには、以下を確認してください。

• ターゲットVMが永続的なMCSカタログに存在すること。
• MCSマシンカタログが正常に機能していること。
• これは、プロビジョニングスキームとホストが存在し、プロビジョニングスキームに正しいエントリがあることを意味します。
• ハイパーバイザーがメンテナンスモードになっていないこと。
• ターゲットVMがシャットダウンされ、メンテナンスモードになっていること。

OSディスクをリセットするには、次の手順を実行します。

1. PowerShellウィンドウを開きます。
2. Citrix固有のPowerShellモジュールをロードするために、asnp citrix*を実行します。

3. 次のいずれかの方法でPowerShellコマンドReset-ProvVMDiskを実行します。

   • VMのリストをコンマ区切りリストとして指定し、各VMでリセットを実行します。

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
      <!--NeedCopy-->
     

   • VMのリストをGet-ProvVMコマンドからの出力として指定し、各VMでリセットを実行します。

      (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
      <!--NeedCopy-->
     

   • 単一のVMを名前で指定します。

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
      <!--NeedCopy-->
     

   • Get-ProvVMコマンドによって返された各VMに対して個別のリセットタスクを作成します。各タスクがハイパーバイザーの機能チェック、各VMの接続チェックなど、同じ冗長なチェックを実行するため、これは効率的ではありません。

      Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
      <!--NeedCopy-->
     

4. リセットされるVMのリストと、回復不能な操作であるという警告メッセージが表示された確認プロンプトが表示されます。回答を入力せずにEnterキーを押すと、それ以上のアクションは実行されません。

   注：

   リセットプロセスが完了するまで、VMをメンテナンスモードから解除したり、電源をオンにしたりしないでください。

   PowerShellコマンド-WhatIfを実行して、実行されるアクションを出力し、アクションを実行せずに終了することができます。

   確認プロンプトは、以下のいずれかの方法でバイパスすることもできます。

   • -Force パラメーターを指定します。

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
      <!--NeedCopy-->
     

   • -Confirm:$false パラメーターを指定します。

      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
      <!--NeedCopy-->
     

   • Reset-ProvVMDisk を実行する前に、$ConfirmPreference を None に変更します。

      PS C:\Windows\system32> $ConfirmPreference='None'
      PS C:\Windows\system32> $ConfirmPreference
      None
      PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
      <!--NeedCopy-->
     

5. Reset-ProvVMDisk コマンドによって返されたタスクのステータスを取得するには、Get-ProvTask を実行します。

既存のプロビジョニングスキームのネットワーク設定を変更する

既存のプロビジョニングスキームのネットワーク設定を変更して、新しいVMが新しいサブネットワーク上に作成されるようにすることができます。ネットワーク設定を変更するには、Set-ProvScheme コマンドでパラメーター -NetworkMapping を使用します。

注：

この機能は、シトリックス バーチャルアプリおよびデスクトップ 2203 LTSR CU3 およびそれ以降のバージョンでサポートされています。

既存のプロビジョニングスキームのネットワーク設定を変更するには、次の手順を実行します。

1. PowerShellウィンドウで、コマンド asnp citrix* を実行してPowerShellモジュールをロードします。
2. 変更するネットワークパスに移動するには、(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行します。

3. 新しいネットワーク設定に変数を割り当てます。例：

   $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
   <!--NeedCopy-->
   

4. Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap を実行します。
5. 既存のプロビジョニングスキームの新しいネットワーク設定を確認するには、(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行します。

マシンカタログのバージョンを管理する

MCSマシンカタログがSet-ProvSchemeコマンドで更新されると、現在の構成がバージョンとして保存されます。その後、PowerShellコマンドを使用して、マシンカタログのさまざまなバージョンを管理できます。次のことができます。

• マシンカタログのバージョンリストを表示する
• 以前のバージョンを使用してマシンカタログを更新する
• そのマシンカタログのVMで使用されていないバージョンを手動で削除する
• マシンカタログによって保持される最大バージョン数を変更する（デフォルトは99）

バージョンには、マシンカタログの次の情報が含まれます。

• VM CPUカウント
• VMメモリMB
• カスタムプロパティ
• サービスオファリング
• マシンプロファイル
• ネットワークマッピング
• セキュリティグループ

マシンカタログのさまざまなバージョンを管理するには、次のコマンド（例として提供）を実行します。

• マシンカタログのさまざまなバージョンの構成詳細を表示するには:

   Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
   <!--NeedCopy-->
  

• マシンカタログの特定のバージョンの構成詳細を表示するには:

   Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
   <!--NeedCopy-->
  

• マシンカタログに関連付けられているバージョンの総数を表示するには:

   (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
   <!--NeedCopy-->
  

• 以前のバージョンを使用してマシンカタログを更新するには:

   Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
   <!--NeedCopy-->
  

• そのマシンカタログのVMによって使用されていないバージョンを手動で削除するには:

   Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
   <!--NeedCopy-->
  

• マシンカタログによって保持される最大バージョン数を設定するには（デフォルトは99）。この設定は、すべてのカタログに適用されます。たとえば、この場合、すべてのMCSプロビジョニング済みカタログに対して最大15バージョンが保持されます。

   Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
   <!--NeedCopy-->
  

バージョン数が最大バージョン数に達した場合、古いバージョンがマシンカタログ内のいずれかのVMによって使用されていると、新しいバージョンを作成できません。その場合は、次のいずれかを実行してください。

• マシンカタログによって保持される最大バージョン数の制限を増やします。
• 古いバージョンを使用している一部のVMを更新して、それらの古いバージョンがどのVMからも参照されなくなり、削除できるようにします。

マシンプロファイルに基づかないマシンカタログを、マシンプロファイルに基づくマシンカタログに変換する

VM、テンプレート仕様（Azureの場合）、起動テンプレート（AWSの場合）、またはVMwareテンプレート（VMwareの場合）をマシンプロファイルの入力として使用して、マシンプロファイルに基づかないマシンカタログをマシンプロファイルに基づくマシンカタログに変換できます。カタログに追加された新しいVMは、明示的なカスタムプロパティによって上書きされない限り、マシンプロファイルからプロパティ値を取得します。

注:

既存のマシンプロファイルに基づくマシンカタログを、マシンプロファイルに基づかないマシンカタログに変更することはできません。

これを行うには:

1. VMを含み、マシンプロファイルを含まない永続または非永続マシンカタログを作成します。
2. 「PowerShell」ウィンドウを開きます。

3. マシンプロファイルからのプロパティ値を、マシンカタログに追加された新しいVMに適用するには、Set-ProvSchemeコマンドを実行します。例：

   • アジュールの場合：

      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
      <!--NeedCopy-->
     

   • AWSの場合：

      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
      <!--NeedCopy-->
     

   • ヴイエムウェアの場合：

       Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
      <!--NeedCopy-->
     

     注：

     VMwareテンプレートからFolderIDを派生させないように、FolderIDをカスタムプロパティとして設定します。

アクティブなコンピューターアカウントのID情報を修復する

ID関連の問題があるアクティブなコンピューターアカウントのID情報をリセットできます。マシンパスワードと信頼キーのみをリセットするか、IDディスクのすべての構成をリセットするかを選択できます。この実装は、永続的および非永続的なMCSマシンカタログの両方に適用できます。

注：

現在、この機能はAWS、GCP、Azure、SCVMM、XenServer、およびVMwareの仮想化環境でサポートされています。

条件について

IDディスクを正常にリセットするには、以下を確認してください。

• VMをシャットダウンし、メンテナンスモードに設定する
• PowerShellコマンドにパラメーター「-OS」を含めないでください。

IDディスクをリセット

IDディスクをリセットするには:

1. PowerShellウィンドウを開きます。
2. Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。

3. ID情報をリセットします。

   • マシンパスワードと信頼キーのみをリセットするには、次のコマンドを実行します。

      Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
      <!--NeedCopy-->
     

     コマンドで使用されるパラメーターの説明は次のとおりです。

     • IdentityAccountName: 修復する必要があるIDアカウントの名前。
     • PrivilegedUserName: IDプロバイダー (ADまたはAzureAD) に対する書き込み権限を持つユーザーアカウント。
     • プリビレッジドユーザーパスワード: プリビレッジドユーザー名のパスワード。
     • Target: 修復アクションのターゲット。アカウントパスワード/信頼キーを修復するためのIdentityInfo、およびMicrosoft Entraハイブリッド参加済みマシンIDのユーザー証明書属性を修復するためのUserCertificateを指定できます。

   • IDディスクのすべての構成をリセットするには、次のコマンドを次の順序で実行します。

      Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
      <!--NeedCopy-->
     

      Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
      <!--NeedCopy-->
     

   • IDディスクを完全に再作成するには:

      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
      <!--NeedCopy-->
     

     注:

     マシンがVDAバージョン2511以降を使用するWindowsマシンである場合、-Recreate設定に関係なく、以前と同じMachineGuidを使い続けます。

4. 「y」と入力してアクションを確定します。-Force パラメーターを使用して確認プロンプトをスキップすることもできます。例:

   Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
   <!--NeedCopy-->
   

5. 更新されたIDディスク設定を確認するには、Get-ProvVM -ProvisioningSchemeName <name -VMName <name> を実行します。IDディスクの属性（例: IdentityDiskId）は更新する必要があります。StorageId と IdentityDiskIndex は変更してはいけません。

既存のマシンカタログでキャッシュ構成を変更する

MCSIOが有効な非永続カタログを作成した後、Set-ProvSchemeコマンドを使用して次のパラメーターを変更できます。

• ライトバックキャッシュメモリサイズ
• ライトバックキャッシュディスクサイズ

この機能は現在、以下に適用されます。

• ジーシーピーおよびマイクロソフト アジュール環境、および
• MCSIOが有効な非永続カタログ

必要条件

キャッシュ構成を変更するための要件は次のとおりです。

• VDAの最新バージョン（2308以降）に更新します。

• 既存のマシンカタログでパラメーター UseWriteBackCache を有効にします。UseWriteBackCache が有効なマシンカタログを作成するには、New-ProvScheme を使用します。例:

   New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
   -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
   -MasterImageVM $MasterImage `
   -ServiceOffering $ServiceOffering `
   -NetworkMap $NetworkMap `
   -SecurityGroup $SecurityGroup `
   -UseWriteBackCache -WriteBackCacheDiskSize 8
   <!--NeedCopy-->
  

キャッシュ構成を変更する

Set-ProvSchemeコマンドを実行します。例:

Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->

注:

• WriteBackCacheDiskSize の値は、キャッシュディスクストレージとして少なくとも1 GBが必要なため、ゼロより大きい必要があります。
• WriteBackCacheMemorySize の値は、マシンカタログのメモリサイズより小さい必要があります。
• これらの変更は、変更後にカタログに追加された新しいVMにのみ影響します。既存のVMはこれらの変更の影響を受けません。

ローカルファイル共有アクセス経由でのVDAアップデートのサポート

PowerShellコマンドレットを使用してVDAインストーラーの場所を指定します。これにより、各VDAがCitrix Managed Azure CDNから新しいVDAインストーラーを取得できるようにするためのネットワークルールを提供する手間が省けます。

PowerShellコマンドレット

New-VusCatalogSchedule および New-VusMachineUpgrade コマンドレットに2つの新しいオプションパラメーターが追加されました。これにより、ローカルファイル共有からインストーラーを使用できます。

• VdaWorkstationPackageUri - ワークステーションOS VDAインストーラーへのUNCパスを指定します
• VdaServerPackageUri - サーバーOS VDAインストーラーへのUNCパスを指定するために使用します

前提条件

• VDA 2311に付属のVUSエージェントインストーラー
• VDAアップグレードエージェント バージョン7.40.0.35以降 (VDAインストーラーバージョン2311以降を使用)
• 仮想アプリおよびデスクトップ リモート PowerShell SDK バージョン 7.40 以降 (2024年1月10日以降にリリース)

ファイル共有のアクセス許可の設定方法

VDA インストーラーパッケージを含むネットワーク共有は、Local System (NT AUTHORITY\SYSTEM プリンシパル) として実行される VDA Upgrade Agent サービスに対して読み取りアクセス権を持っている必要があります。

• ドメイン参加済みファイル共有のアクセス許可

  VDA マシンがドメインに参加している場合、Local System アカウント (VUA は Local System として実行されます) は、ネットワーク共有にアクセスする際にコンピューターの資格情報を使用します。

  最小特権のアクセス許可は、ドメインコンピューターに読み取りアクセス権を付与することで設定できます。

  1. ファイルを共有するネットワーク上のユーザーを選択します。
  2. 詳細な共有設定をクリックし、ファイルとプリンターの共有をオンにします。

• ドメイン非参加ファイル共有のアクセス許可

  VDA マシンがドメインに参加していない場合、Local System アカウント (VUA は Local System として実行されます) は、ネットワーク共有にアクセスする際にANONYMOUS LOGONを使用します。

  1. 共有フォルダーを選択します。
  2. パスワード保護を無効にします。
     1. フォルダーのプロパティに移動します。
     2. ネットワークと共有センターを選択します。
     3. パスワード保護共有をオフにします。
  3. 共有アクセス許可を付与するには、詳細な共有をクリックします。
     1. アクセス許可を選択します。
     2. ANONYMOUS LOGON に 読み取り共有権限を付与します。
  4. フォルダーのアクセス許可を付与するには、セキュリティタブを選択します。
     1. 共有フォルダーにアクセス許可を追加するには、編集をクリックします。
     2. ANONYMOUS LOGON にフォルダーのアクセス許可を付与するには、共有フォルダーを選択します。
  5. ファイルとプリンターの共有を有効にするには、詳細設定をクリックします。
  6. 共有フォルダー名を ネットワークアクセスセキュリティポリシー に追加します。

  注：

  変更をすぐに有効にするには、マシンを再起動してください。

ローカルファイル共有からのVDA更新

1. VDAインストーラーをダウンロードし、共有ファイルに配置します。

   注：

   Virtual Upgrade Serviceを使用すると、Current ReleaseトラックまたはLTSRトラックのいずれかを選択できます。

   例： マシンカタログがCurrent Release 2311に設定されており、VDAバージョンが2305の場合、VDAをバージョン2311にアップグレードする必要があります。

   1. 弊社のWebサイトのダウンロードページに移動します。
   2. 製品としてCitrix 仮想アプリおよびデスクトップを選択します。
   3. シトリックス バーチャル アプリケーションズ アンド デスクトップ 7 2311, すべてのエディションを選択します。
   4. 「製品ISOに含まれるコンポーネント（個別にパッケージ化されたもの）」展開可能な項目からVDAインストーラーを選択します。

2. カタログの種類に基づいて、関連するVDAインストーラーを選択します。

   • カタログの種類がマルチセッションの場合は、Multi-session OS VDA installerをダウンロードします。
   • カタログの種類がシングルセッションの場合は、Single-session OS VDA installerをダウンロードします。
   • カタログの種類がリモートPCアクセスの場合は、シングルセッションOSコアサービスVDAインストーラーをダウンロードします。

注：

ファイル共有インストーラーのバージョンは、VUSによってクラウドに公開された最新のインストーラーバージョンのバージョンと完全に一致している必要があります。

VMのストレージ移行

VMwareおよびXenServer環境では、既存のVMのディスクストレージを古いストレージから新しいストレージに移動できます。移行中、MCSは電源管理、OSディスクのリセットなどのVM機能を保持します。新しいディスクストレージを使用して、新しいVMをマシンカタログに追加することもできます。これを行うには、PowerShellコマンドMove-ProvVMDiskを使用します。

フルクローン永続VMと非永続VMを移行できます。

• 永続的なフルクローンVMの場合：OSディスク、IDディスク、および非MCSプロビジョニングディスク。
• 非永続VMの場合：OSディスク、IDディスク、およびライトバックキャッシュ（WBC）ディスク。

新しいストレージは、次の条件を満たしている必要があります。

• 古いストレージと同じクラスター内にある必要があります。
• VMが実行されているホストは、古いデータストアと新しいデータストアの両方にアクセスできる必要があります。

ディスクストレージを移行する

ディスクストレージを移行するには：

1. 既存のホスティングユニットに宛先ストレージを追加します。宛先ストレージを追加するには、PowerShellコマンド Add-Hyphostingunitstorage を実行します。

   古いストレージに新しいVMを追加したくない場合は、古いストレージをSupersededに変更します。これはStudioまたはPowerShellコマンドを使用して実行できます。Studioについては、ストレージの編集 を参照してください。または、Set-Hyphostingunitstorage を実行し、Superseded を true に設定して、古いストレージでの新しいVMの作成を無効にします。

   注：

   非永続VMの場合：

   • WBCが使用されている場合は、ホスティングユニットでWBC宛先ストレージを構成します。
   • OS宛先ストレージが構成されている場合、WBC（使用されている場合）はOS宛先ストレージと互換性がある必要があります。
   • OS宛先ストレージが構成されていない場合、WBC（使用されている場合）は現在のOSストレージと互換性がある必要があります。

2. VMをシャットダウンし、メンテナンスモードをオンにします。

3. プロビジョニングスキーム、ホスティングユニット、OSディスクストレージ、およびWBCディスクストレージに関する情報を取得します。

   • OSストレージ情報については、ProvResourceInStorage を実行します。例：

      $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
      $result
      $result.ProvResourceInStorage | Format-List -Property *
      <!--NeedCopy-->
     

   • WBCストレージ情報については、TemporaryStorageInfo を実行します。例：

      $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
      $result
      $result.TemporaryStorageInfo | Format-List -Property *
      <!--NeedCopy-->
     

4. OSディスク、IDディスク、およびWBCディスク（非永続VMに適用）を、Move-ProvVMDisk PowerShellコマンドを使用して宛先ストレージに移行します。

   注：

   • OSディスクとIDディスクは常にDiskTypeとDestinationStorageIdパラメーターで指定してください。
   • OSディスクとIDディスクのDestinationStorageIdは同じである必要があります。

   例：

   永続VM：

   (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
   <!--NeedCopy-->
   

   重要：

   永続VMの場合、すべてのディスクが移動されます。移動するディスクを選択することはできません。

   非永続VM：

   (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
   <!--NeedCopy-->
   

   重要：

   • 特定のディスクを移行したくない場合は、DestinationStorageIdパラメーターの値をNoneに設定します。
   • VMにWBCディスクがある場合は、WBCディスクをDiskTypeパラメーターに追加し、必要な情報をDestinationStorageIdパラメーターに追加します。

既存のMCSプロビジョニング済みカタログを準備済みイメージマシンカタログに移行する

既存のMCSプロビジョニング済みマシンカタログは、PowerShellコマンドSet-ProvSchemeImageを使用して準備済みイメージマシンカタログに変換できます。ただし、移行後にレガシーカタログに戻すことはできません。現在、この機能はAzureおよびVMware仮想化環境に適用されます。

制限事項

以下の制限事項を考慮してください。

• MCSカタログが永続データディスクを使用している場合、そのカタログは準備済みイメージを使用するように移行できません。
• MCSカタログがアンマネージドディスクを使用している場合、そのカタログは準備済みイメージを使用するように移行できません。

準備済みイメージマシンカタログへの移行

移行するには、次の手順を実行します。

1. StudioまたはPowerShellコマンドを使用して、イメージ定義とイメージバージョンを作成します。イメージ定義とイメージバージョンを作成する手順については、以下を参照してください。

   • アジュール:

     • ウェブスタジオ
     • パワーシェル

   • ヴイエムウェア:

     • Webスタジオ
     • パワーシェル

2. プロビジョニングスキームのUIDを取得するには、Get-ProvSchemeコマンドを実行します。例:

   Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
   <!--NeedCopy-->
   

3. イメージ定義名、イメージバージョン仕様のUIDを取得するには、Get-ProvImageVersionSpecコマンドを実行します。例:

   Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
   <!--NeedCopy-->
   

4. 既存のMCSプロビジョニング済みマシンカタログを準備済みイメージマシンカタログに移行するには、Set-ProvSchemeImageコマンドを実行します。例:

   Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
   <!--NeedCopy-->
   

5. カタログが移行されたことを確認するには、Get-ProvSchemeコマンドを実行します。例:

   Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid
   <!--NeedCopy-->
   

トラブルシューティング

• 「電源状態不明」のステータスのマシンについては、ガイダンスとしてCTX131267を参照してください。
• 不明な電源状態が継続的に表示されるVMを修正するには、不明な電源状態が継続的に表示されるVMを修正する方法を参照してください。

次のステップ

特定のクラウドサービスカタログの管理については、以下を参照してください。

• AWSカタログの管理
• XenServerカタログの管理
• グーグル クラウド プラットフォーム カタログの管理
• マイクロソフト Azure カタログの管理
• マイクロソフト システムセンター バーチャルマシンマネージャー カタログの管理
• VMwareカタログの管理