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

注:

Citrix Virtual Apps and Desktops™の展開は、Web Studio（Webベース）とCitrix Studio（Windowsベース）という2つの管理コンソールを使用して管理できます。この記事では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 を使ってみる

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

• マシンカタログの管理
  • はじめに
  • 永続インスタンスについて
• マシンカタログの管理
• ウェブスタジオを使用する
• カタログの詳細を表示する
  • カタログにマシンを追加する
  • カタログからマシンを削除する
• カタログを編集する
• カタログの名前を変更する
• カタログを別のゾーンに移動する
• カタログを削除する
• カタログ内のActive Directoryコンピューターアカウントを管理する
• カタログを更新する
  • マスターイメージを更新または作成する
  • マスターイメージを変更する
  • マスターイメージをロールバックする
• 機能レベルを変更または変更を元に戻す
• カタログをクローンする
• フォルダーを使用してカタログを整理する
  • カタログフォルダーを作成する
  • カタログを移動する
  • カタログフォルダーの管理
• カタログ作成の再試行
• トークンを使用してMCS以外のプロビジョニング済みVDAを登録する（プレビュー）
• パワーシェルを使用する
• カタログに関連付けられた警告とエラーを取得する
• イメージに説明を追加する
• OSディスクのリセット
• 既存のプロビジョニングスキームのネットワーク設定を変更する
• マシンカタログのバージョンを管理する
• マシンプロファイルに基づかないマシンカタログをマシンプロファイルに基づくマシンカタログに変換する
• アクティブなコンピューターアカウントのID情報を修復する
  • 条件
  • IDディスクのリセット
• 既存のマシンカタログのキャッシュ構成を変更する
  • 要件
  • キャッシュ構成を変更する
• ローカルファイル共有アクセスによる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. 左側のペインでマシンカタログを選択します。
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 Computer Galleryの設定を変更するかどうかを選択します（「準備されたイメージをAzure Galleryに配置」が使用されている場合のみ利用可能）。

   注：

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

   • 「ライセンスの種類」ページで、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コンピューターアカウントが保持されるか、無効になるか、削除されるかを示します。

カタログ内の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）を指定します。これは、イメージまたはイメージのスナップショットの代替として使用します。

ロールアウト戦略:

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

• 該当するマシンでの更新が完了するまで、新しいセッションは起動できません。
• シングルセッション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バージョンに戻すことができます。

カタログをクローンする

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

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

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

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

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

ヒント：

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

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

開始する前に、まずカタログをどのように整理するか計画してください。次の点を考慮してください:

• フォルダーは最大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. フォルダー階層でフォルダーを選択し、必要に応じてアクションバーでアクションを選択します。

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

カタログ作成の再試行

注：

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

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

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

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

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. デリバリーコントローラーでWebSocket接続を有効にします。サイト内の各デリバリーコントローラーで次のコマンドを実行します。

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

   注：

   WebSocketを有効にした後、デリバリーコントローラーを再起動してください。

登録トークンを生成する

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 を使用してカタログを管理する方法について詳しく説明します。

• カタログに関連付けられている警告とエラーを取得する(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#retrieve-warnings-and-errors-associated-with-a-catalog)
• イメージに説明を追加する(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#add-descriptions-to-an-image)
• OSディスクをリセットする(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#reset-os-disk)
• 既存のプロビジョニングスキームのネットワーク設定を変更する(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#change-the-network-setting-for-an-existing-provisioning-scheme)
• マシンカタログのバージョンを管理する(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#manage-versions-of-a-machine-catalog)
• 非マシンプロファイルベースのマシンカタログをマシンプロファイルベースのマシンカタログに変換する(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#convert-a-non-machine-profile-based-machine-catalog-to-machine-profile-based-machine-catalog)
• アクティブなコンピューターアカウントのID情報を修復する(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#repair-the-identity-information-of-active-computer-accounts)
• 既存のマシンカタログのキャッシュ構成を変更する(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#change-cache-configuration-on-an-existing-machine-catalog)
• ローカルファイル共有アクセスによるVDA更新サポート(/ja-jp/citrix-virtual-apps-desktops/2411/install-configure/machine-catalogs-manage.html#vda-update-support-via-local-file-share-access)

カタログに関連付けられている警告とエラーを取得する

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• サポートされているすべてのハイパーバイザー
• 永続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. マシンプロファイルからマシンカタログに追加された新しいVMにプロパティ値を適用するには、Set-ProvScheme コマンドを実行します。例:

   • Azure 環境の場合:

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

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

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

• ジーシーピーおよびマイクロソフト アジュール環境、および
• 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インストーラーパッケージを含むネットワーク共有は、ローカルシステム（NT AUTHORITY\SYSTEMプリンシパル）として実行されるVDAアップグレードエージェントサービスに対して読み取りアクセス権を持っている必要があります。

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

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

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

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

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

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

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

  注:

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

ローカルファイル共有からのVDAアップデート

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

   注：

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

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

   1. 弊社のウェブサイトのダウンロードページに移動します。
   2. 製品としてシトリックス バーチャル アプリケーションズ アンド デスクトップスを選択します。
   3. シトリックス バーチャルアプリ&デスクトップ 7 2311, 全エディション を選択します。
   4. 製品ISOに含まれるが個別にパッケージ化されているコンポーネントの展開可能な項目からVDAインストーラーを選択します。

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

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

注：

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

トラブルシューティング

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

次のステップ

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

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