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

注：

Citrix Virtual Apps and Desktops™の展開は、ウェブスタジオ（Webベース）とCitrix Studio（Windowsベース）の2つの管理コンソールを使用して管理できます。本記事ではウェブスタジオのみを扱います。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)
• カタログ内の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)
• カタログ作成の再試行(#retry-catalog-creation)
• トークンを使用した非MCSプロビジョニングVDAの登録（プレビュー）(#enroll-non-mcs-provisioned-vdas-using-tokens-preview)
• パワーシェルを使用
• カタログに関連付けられた警告とエラーの取得(#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)
  • キャッシュ構成の変更
• ローカルファイル共有アクセスによるVDA更新のサポート
  • パワーシェル コマンドレット
  • 前提条件
  • ファイル共有権限の設定方法
  • ローカルファイル共有からのVDA更新
• トラブルシューティング
• 次のステップ

カタログの詳細を表示

1. 特定のマシンカタログを見つけるには、検索機能を使用します。手順については、インスタンスの検索を参照してください。
2. 検索結果から、必要に応じてカタログを選択します。
3. カタログ列の説明については、次の表を参照してください。
4. このカタログに関する詳細情報については、下部の詳細ペインにあるタブをクリックしてください。

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

開始する前に:

• 仮想化ホストに、追加のマシンを収容するのに十分なプロセッサ、メモリ、ストレージがあることを確認してください。
• 未使用の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. 左側のペインで [Machine Catalogs] を選択します。
3. カタログを選択し、アクションバーで [View Machines] を選択します。
4. 1つ以上のマシンを選択し、アクションバーで [Delete] を選択します。

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

カタログを編集する

1. [Description] ページで、カタログの説明を変更します。
2. 左側のペインで [Machine Catalogs] を選択します。
3. カタログを選択し、アクションバーで [Edit Machine Catalog] を選択します。
4. [Scopes] ページで、スコープを変更します。

5. [NIC] ページで、次の操作を実行します。

   • NICのサブネットマッピングを変更するには、[Associated Network] フィールドからネットワークを選択します。
   • サブネットマッピングを追加するには、[Add NIC] を選択し、[Associated Network] フィールドからネットワークを選択して、[Save] をクリックします。

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

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

   注：

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

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

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

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

     注：

     • カタログがサポートするマシンサイズのみが表示されます。
     • 必要に応じて、他のマシンカタログで使用されているマシンサイズのみを表示を選択して、マシンサイズリストをフィルタリングします。

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

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

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

   「注：」

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

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

   Remote PC Accessカタログの場合、以下のページが表示されます。

   • 「電源管理」ページで、電源管理設定を変更し、電源管理接続を選択します。
   • 「組織単位」ページで、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コンピューターアカウントを保持するか、無効にするか、削除するかを示します。

カタログ内の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. 左側のペインでMachine Catalogsを選択します。
3. カタログを選択し、アクションバーでChange Master Imageを選択します。
4. Imageページで、展開するホストとイメージを選択します。

   ヒント：

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

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

   「注：」

   「ロールアウト戦略」ページは、ロールアウトが非永続VMにのみ適用されるため、永続VMでは利用できません。

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

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

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

「ロールアウト戦略：」

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

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

「ヒント：」

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

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

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

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

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

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

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

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

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

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

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

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

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

カタログをクローンする

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

• オペレーティングシステムおよびマシン管理に関連する設定は変更できません。クローンされたカタログは、元のカタログからそれらの設定を継承します。
• カタログのクローン作成には時間がかかる場合があります。必要に応じて、進行状況を非表示を選択して、バックグラウンドでクローン作成を実行できます。
• クローンされたカタログは元のカタログの名前を継承し、サフィックスCopyが付きます。名前は変更できます。カタログの名前を変更するを参照してください。
• クローン作成が完了したら、クローンされたカタログをデリバリーグループに割り当てるようにしてください。

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

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

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

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

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

• フォルダは最大5階層までネストできます（デフォルトのルートフォルダを除く）。
• カタログフォルダには、カタログとサブフォルダを含めることができます。
• Web Studioのすべてのノード（マシンカタログノードやアプリケーションノードなど）は、バックエンドでフォルダツリーを共有しています。フォルダの名前変更や移動時に他のノードとの名前の競合を避けるため、異なるノードの第一階層フォルダには異なる名前を付けることをお勧めします。

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

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

ヒント:

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

カタログを移動する

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

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

ヒント:

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

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

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

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

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

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

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

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

カタログ作成の再試行

注:

この機能は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～100 台の VDA マシン
• 有効期間：最大 14 日間

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

1. Web Studio > マシンカタログで、マシン数列にプロビジョニング方法：手動と表示されている非 MCS プロビジョニングカタログを見つけます。
2. カタログを右クリックし、登録トークンの管理を選択します。
3. 表示される登録トークンの生成ページで、次のトークン情報を提供します。
   • トークンの名前を入力します。
   • 有効期間を入力します。期間は14日以内である必要があります。トークンは指定された期間のみ有効です。
   • （オプション）トークンで登録されたVDAの電源管理のためにホスト接続を選択します。オプションには、このカタログのゾーン下のすべてのホスト接続が含まれます。
   • トークンの使用制限（1～100の間）を入力します。
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によって追跡または識別されなくなります。ただし、これらのリソースの一部はハイパーバイザーを介してのみアクセス可能です。ハイパーバイザーアクセスがない場合でも、Remove-ProvVM PowerShellのPurgeDBOnlyオプションを使用して、VM、ベースディスク、ACG内のイメージなどのVMリソースオブジェクトをデータベースから削除します。

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

• サポートされているすべてのハイパーバイザー
• 永続VMおよび非永続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. Get-ProvTask を実行して、Reset-ProvVMDisk コマンドによって返されたタスクのステータスを取得します。

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

既存のプロビジョニングスキームのネットワーク設定を変更して、新しい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の場合）をマシンプロファイルの入力として使用して、マシンプロファイルに基づかないマシンカタログをマシンプロファイルに基づくマシンカタログに変換できます。カタログに追加された新しいVMは、明示的なカスタムプロパティによって上書きされない限り、マシンプロファイルからプロパティ値を取得します。

注：

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

これを行うには：

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

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

   • アジュールの場合：

      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-->
     

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

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

注記:

現在、この機能はAWS、GCP、Azure、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、および Hybrid AzureAD に参加しているマシン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-->
     

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 コマンドを使用して、次のパラメーターを変更できます。

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

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

• GCP および マイクロソフト Azure 環境、および
• 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-->

注：

• 少なくとも1 GBのキャッシュディスクストレージが必要なため、WriteBackCacheDiskSizeの値はゼロより大きくする必要があります。
• 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アップグレードエージェントサービスに対する読み取りアクセス権が必要です。

• ドメイン参加済みファイル共有権限

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

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

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

• ドメイン非参加ファイル共有権限

  VDAマシンがドメインに参加していない場合、ローカルシステムアカウント（VUAはローカルシステムとして実行）は、ネットワーク共有にアクセスする際に匿名ログオンを使用します。

  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. Citrix仮想アプリおよびデスクトップ 7 2311, すべてのエディションを選択します。
   4. 製品ISOに含まれるが個別にパッケージ化されているコンポーネントの展開可能な項目からVDAインストーラーを選択します。

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

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

注：

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

トラブルシューティング

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

次に行うこと

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

• AWSカタログの管理(/ja-jp/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-manage/manage-machine-catalog-aws.html)
• XenServerカタログの管理(/ja-jp/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-manage/manage-machine-catalog-citrix-hypervisor.html)
• グーグル クラウド プラットフォーム カタログの管理
• マイクロソフト Azure カタログの管理
• マイクロソフト システムセンター Virtual Machine Manager カタログの管理
• VMwareカタログの管理(/ja-jp/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-manage/manage-machine-catalog-vmware.html)