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

最終公開日 : Nov 13, 2026
注:
バージョン2511以降、Citrix Web Studio（Webベース）はCitrix Virtual Apps and Desktops™の唯一の管理コンソールです。Citrix Studio（MMCベース）はインストーラーから削除されました。この記事はWeb Studioにのみ適用されます。Citrix Studioに関する情報については、Citrix Virtual Apps and Desktops 7 2212以前の同等の記事を参照してください。
Related information
インストールと構成
AWS EC2カタログを管理するAmazon WorkSpaces Core マネージドインスタンスのカタログを管理する../install-configure/machine-catalogs-manage/manage-machine-catalog-citrix-hypervisor.mdGoogle Cloud Platformカタログを管理するHPE Moonshot カタログの管理Microsoft Azureカタログを管理するマイクロソフト システムセンター バーチャルマシンマネージャー カタログの管理Nutanixカタログの管理VMwareカタログの管理

はじめに

マシンカタログへのマシンの追加または削除、名前の変更、説明の変更、またはカタログの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を使用してカタログを管理する方法について詳しく説明します。

カタログの詳細を表示

  1. 検索機能を使用して、特定のマシンカタログを見つけます。手順については、インスタンスの検索を参照してください。
  2. 検索結果から、必要に応じてカタログを選択します。
  3. カタログ列の説明については、次の表を参照してください。
  4. カタログ列の説明については、次の表を参照してください。
    列 説明
    マシンカタログ カタログの名前と割り当ての種類。割り当ての種類には以下が含まれます。
    • ランダム: カタログ内のマシンはユーザーにランダムに割り当てられます。
    • 永続: カタログ内のマシンはユーザーに永続的に割り当てられます。
    マシンタイプ カタログ内のマシンでサポートされているセッションの種類。可能な値には以下が含まれます。
    • OSタイプ: マルチセッションOS (仮想); ユーザーデータ: 破棄。
    • OSタイプ: マルチセッションOS (仮想); ユーザーデータ: ローカルディスク上
    • OSの種類: シングルセッションOS (Remote PC Access)
    • OSの種類: シングルセッションOS (仮想); ユーザーデータ: 破棄
    • OSの種類: シングルセッションOS (仮想); ユーザーデータ: ローカルディスク上
    マシン数 カタログ内のマシン数とプロビジョニング方法。可能なプロビジョニング方法には、Machine Creation Services (MCSマシン)、手動、Citrix Provisioning™ Services があります。
    割り当て済み数 デリバリーグループに割り当てられているカタログ内のマシンの数。
    フォルダー マシンカタログツリー内でのカタログの場所。カタログが存在するフォルダーの名前 (末尾のバックスラッシュを含む) を表示します。カタログがルートレベルにある場合は - と表示されます。
    VDAアップグレード VDAアップグレードの状態。可能な値は、未構成、スケジュール済み、利用可能、最新です。
    イメージステータス カタログのイメージ更新のステータス。非永続マシンカタログにのみ適用されます。可能な値は、完全に更新済み、部分的に更新済み、更新保留中、準備中です。
  5. 選択したカタログの詳細については、下部の詳細ペインにあるタブをクリックします。
    タブ 説明
    詳細 マシンタイプ、プロビジョニング方法、サービスアカウント、OS、VDAバージョンなど、主要なマシンカタログ設定を要約し、リソースをすばやく表示および管理できます。
    テンプレートプロパティ MCSでプロビジョニングされたカタログでのみ利用可能です。
    選択したカタログの詳細なプロビジョニング情報を表示します。以下を含みます。
    • マシンテンプレートプロパティ
    • ハイパーバイザー固有の詳細
    • マシンプロファイルプロパティ
    マシン 選択したカタログ内のマシン名のページ分割されたリストを表示します。
    デリバリーグループ Remote PCカタログで利用可能です。
    選択したカタログに関連付けられているデリバリーグループを表示します。デリバリーグループ名とカタログの関連付けが表示されます。
    タグ マルチテナント環境では利用できません。
    選択したマシンカタログに割り当てられているタグのタグ名と説明を表示します。
    ワークスペース環境管理 WEMサービスがプロビジョニングされ、アクセス可能な場合にのみ表示されます。
    Workspace Environment Managementシステムの最適化設定を表示します。
    コストインサイト 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イメージを使用して作成されたカタログの場合、以下のページが表示されます。変更は、後でカタログに追加するマシンにのみ適用されることに注意してください。既存のマシンは変更されません。
    • Virtual Machines ページで、マシンのサイズと、マシンを作成するアベイラビリティゾーンを変更します。
      注：
      • カタログがサポートするマシンサイズのみが表示されます。
      • 必要に応じて、Show only machine sizes used in other machine catalogs を選択して、マシンサイズリストをフィルターします。
      • Azureカタログの場合、Storage and License Types ページで Storage redundancy が ZRS の場合、ゾーン選択をクリアしてAzureにVMアベイラビリティゾーンを管理させることを示唆する警告が表示されます。
    • Machine Profile ページで、マシンプロファイルを使用するか変更するかを選択します。
      注：
      Azureカタログの場合、アベイラビリティゾーンを含むマシンプロファイルを変更し、ストレージ冗長性にZRSを選択すると、ゾーン選択をクリアするよう促す警告が表示されます。
    • (カタログが専用グループホストで構成されている場合にのみ表示) Dedicated host group ページで、ホストグループを変更するかどうかを選択します。
    • Storage and License Types ページで、ストレージ冗長タイプ (Azureカタログの場合)、ストレージタイプ、ライセンスタイプ、およびAzure Computer Gallery設定 (「Place prepared image in Azure Gallery」が使用されている場合にのみ利用可能) を変更するかどうかを選択します。
    注:
    新しく選択した設定が現在のマシンサイズをサポートしていない場合、設定を変更するとマシンサイズの設定がリセットされることを通知する警告ダイアログボックスが表示されます。続行を選択すると、Virtual Machinesメニューの横に赤い点が表示され、新しいマシンサイズを選択するように促されます。
    • License Typeページで、WindowsライセンスまたはLinuxライセンスの設定を変更するかどうかを選択します。
    リモートPCアクセスカタログの場合、次のページが表示されます。
    • Power Managementページで、電源管理設定を変更し、電源管理接続を選択します。
    • Organizational Unitsページで、Active Directory OUを追加または削除します。
  7. Applyをクリックして変更を適用し、Saveをクリックして終了します。

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

  1. Web Studioにサインインします。
  2. 左ペインでMachine Catalogsを選択します。
  3. カタログを選択し、アクションバーでRename Machine Catalogを選択します。
  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. 必要に応じて、**「進行状況を非表示」**を選択して、バックグラウンドでクローン作成を実行します。

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

フォルダーを作成してカタログを整理し、簡単にアクセスできるようにすることができます。たとえば、イメージタイプ別や組織構造別にカタログを整理できます。
ヒント:
アクションバーの右上にあるフォルダーアイコンをクリックすると、マシンカタログノードのデフォルト表示（フォルダー表示またはリスト表示）を設定できます。

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

開始する前に、まずカタログの整理方法を計画してください。次の点を考慮してください。
  • フォルダーは最大5階層までネストできます（デフォルトのルートフォルダーを除く）。
  • カタログフォルダーには、カタログとサブフォルダーを含めることができます。
  • Web Studioのすべてのノード（マシンカタログ、デリバリーグループ、アプリケーション、アプリケーショングループなど）は、バックエンドで同じフォルダーツリーを共有します。フォルダーの名前変更や移動時に名前の競合を避けるため、異なるノード間で最上位フォルダーには一意の名前を使用してください。
    New-BrokerAdminFolder SDKコマンドレットを使用してフォルダーを作成し、それをマシンカタログノードの下に表示させたい場合は、Set-BrokerAdminFolderMetadataコマンドレットを使用してContainsMachineCatalogsメタデータを追加する必要があります。
    例:
    Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
カタログフォルダーを作成するには、次の手順に従います。
  1. 左ペインでマシンカタログを選択します。
  2. フォルダー階層でフォルダーを選択し、アクションバーでフォルダーの作成を選択します。
  3. 新しいフォルダーの名前を入力し、完了をクリックします。
ヒント:
意図しない場所にフォルダーを作成した場合でも、正しい場所にドラッグして移動できます。

カタログを移動する

カタログはフォルダー間で移動できます。詳細な手順は次のとおりです。
  1. 左側のペインで を選択します。
  2. フォルダー別にカタログを表示します。フォルダー階層の上にある をオンにすると、すべてのカタログを一度に表示することもできます。
  3. カタログを右クリックし、 を選択します。
  4. カタログを移動するフォルダーを選択し、 をクリックします。
ヒント:
カタログをフォルダーにドラッグできます。

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

カタログフォルダーを削除、名前変更、移動できます。
フォルダーとそのサブフォルダーにカタログが含まれていない場合にのみ、フォルダーを削除できます。
フォルダーを管理するには、以下の手順に従います。
  1. 左側のペインで を選択します。
  2. フォルダー階層でフォルダーを選択し、必要に応じて バーでアクションを選択します。
    • フォルダーの名前を変更するには、 を選択します。
    • フォルダーを削除するには、 を選択します。
    • フォルダを移動するには、Move Folder を選択します。
  3. 画面の指示に従って、残りの手順を完了します。

VDAのアップグレード

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

カタログ作成を再試行する

注:
この機能は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. Delivery ControllerでWebSocket接続を有効にします。サイトに存在する各Delivery Controllerで次のコマンドを実行します。
    New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
    注:
    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. ツールEnrollMachine.exeをC:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Toolで探します。
  3. 適切な入力パラメーターを指定してツールを実行します。例: EnrollMachine.exe -websocket_token_string:xxxxxxxxx
次の表は、登録ツールの入力パラメータについて説明しています。
パラメータ名 必須 説明 例
-websocket_token_stdin はい 登録トークンを読み取ります。 .\EnrollMachine.exe -websocket_token_stdin
-websocket_token_string コマンドラインパラメータから登録トークンを直接読み取ります。 .\EnrollMachine.exe -websocket_token_string:<token>
-websocket_token_file:[token-file-path] 指定されたパスから登録トークンを読み取ります。 .\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt
log:[log-file-path] いいえ 登録ツールのログを表示します。 .\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]
-help いいえ 短いヘルプテキストを表示します。 .\EnrollMachine.exe -help
登録が成功すると、ツールとログに成功メッセージが表示されます。Web Studioにサインインして、VDAマシンがカタログに追加され、マシンのステータスが登録済みであることを確認してください。

トラブルシューティング

デフォルトでは、登録ツールのログは次の場所にあります。
C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt
ログに別のパスを指定した場合は、log:[log-file-path] を使用してログを取得できます。
次の表に、登録ツールによって返されるコードを示します。
コード 文字列 説明
0 成功 VDAがマシンカタログに正常に追加されました。
-1 無効な引数 登録トークンの入力パラメーターが無効です。
-2 ブローカーエージェントが見つかりません ブローカーエージェントサービスが見つかりません。
-3 トークンが無効です 入力されたトークンが無効です。
-4 TokenMissingRequiredClaims トークンに必要なクレーム（例：CustomerId、登録URI）が不足しています。
-5 InternalError 一般的なエラーが発生しました。
-6 TimedOut タスクがタイムアウトしました。
-7 FailedToDetermineMachineADJoinedStatus マシンのAD参加ステータスを返すサービスが失敗しました。
-8 ADMachineFailedToFindSid ADマシンのSidを返すサービスが失敗しました。
-9 EnrollRequestFailed HTTPエラーによりリクエストが失敗しました。
-10 EnrollResponseMissingRequiredFields 登録ツールの応答にパラメーター VirtualSiteId がありません。
-11 InsufficientPermission このタスクを実行するために必要な権限がありません。
-12 FailedToDetermineMachineAadJoinedStatus マシンのAD参加ステータスをチェックするサービスでエラーが発生しました。
-13 AadMachineFailedToFindDeviceId システムによって追加された追加パラメーター AAD device id が空です。
-14 AadDeviceIdNotValid システムによって追加された追加パラメーター AAD device id は有効なGUIDではありません。
-15 NoValidMacAddress 無効なMACアドレスです。
-16 FailedToGetComputerHostNameForVdaInstanceName 追加パラメーター VdaInstanceName を設定するために、コンピューターのホスト名を取得できませんでした。
-17 VirtualDesktopAgentRegistryKeyFailedToOpen デリバリーコントローラーのリストを書き込むために、VDAレジストリキーを開けませんでした。
-18 失敗したトークンが最大数に達しました 失敗したトークンが最大数に達しました。

PowerShell を使用する

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

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

履歴のエラーと警告を取得して、MCS マシンカタログの問題を理解し、それらの問題を修正できます。
PowerShellコマンドを使用して、次のことができます。
  • エラーまたは警告のリストを取得する
  • 警告の状態を新規から確認済みに変更する
  • エラーまたは警告を削除する
PowerShellコマンドを実行するには:
  1. PowerShell ウィンドウを開きます。
  2. Citrix 固有の PowerShell モジュールをロードするには、asnp citrix* を実行します。
エラーと警告のリストを取得するには：
Get-ProvOperationEvent コマンドを実行します。
  • パラメーターなしの場合：すべてのエラーと警告を取得します
  • LinkedObjectType および LinkedObjectUid パラメーターを使用する場合：特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告を取得します
  • EventId パラメーターを使用する場合：このイベント ID に一致する特定のエラーまたは警告を取得します
  • Filterパラメーターを使用: カスタマイズされたフィルターでエラーまたは警告を取得します
エラーまたは警告の状態を New から Acknowledged に変更するには：
Confirm-ProvOperationEvent コマンドを実行します。
  • EventIdパラメーターを使用: このイベント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

制限事項

-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..
Remove-ProvVM PowerShell コマンドで -PurgeDBOnly オプションを使用して、MCS データベースから VM の参照を削除します。例：
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"
  • マシンカタログに関連付けられているマスターイメージを更新するには、Publish-ProvMasterVMImageコマンドでMasterImageNoteパラメーターを使用します。例：
    C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
  • 各イメージの情報を表示するには、Get-ProvSchemeMasterVMImageHistoryコマンドを使用します。例：
    C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
ロールバックの進行状況を追跡するには、 でカタログを見つけて、インラインの進行状況バーと段階的な進行状況グラフを表示します。
次のような特定のシナリオでは、ロールバックできません。（ オプションは表示されません）。
  • ロールバックする権限がありません。
  • カタログが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
    • VMのリストをGet-ProvVMコマンドからの出力として指定し、各VMでリセットを実行します。
      (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
    • 名前で単一のVMを指定します。
      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
    • Get-ProvVMコマンドによって返された各VMに対して個別のリセットタスクを作成します。各タスクがハイパーバイザーの機能チェック、各VMの接続チェックなど、同じ冗長なチェックを実行するため、これは効率的ではありません。
      Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
  4. リセットされるVMのリストと、回復不能な操作であるという警告メッセージが表示された確認プロンプトが表示されます。回答を入力せずにEnterキーを押すと、それ以上のアクションは実行されません。
    注：
    リセットプロセスが完了するまで、VMをメンテナンスモードから解除したり、電源をオンにしたりしないでください。
    PowerShellコマンド-WhatIfを実行して、実行されるアクションを表示し、アクションを実行せずに終了できます。
    確認プロンプトを以下のいずれかの方法でバイパスすることもできます。
    • -Force パラメーターを指定します。
      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
    • -Confirm:$falseパラメーターを指定します。
      Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
    • 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
  5. Reset-ProvVMDisk コマンドによって返されたタスクのステータスを取得するには、Get-ProvTask を実行します。

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

既存のプロビジョニングスキームのネットワーク設定を変更して、新しいVMが新しいサブネットワーク上に作成されるようにすることができます。ネットワーク設定を変更するには、Set-ProvSchemeコマンドで-NetworkMappingパラメーターを使用します。
注:
この機能は、Citrix Virtual Apps and Desktops 2203 LTSR CU3以降のバージョンでサポートされています。
既存のプロビジョニングスキームのネットワーク設定を変更するには、次の手順を実行します。
  1. PowerShellウィンドウで、コマンド asnp citrix* を実行してPowerShellモジュールをロードします。
  2. 変更するネットワークパスに移動するには、(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行します。
  3. 新しいネットワーク設定に変数​​を割り当てます。例：
    $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
  4. Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap を実行します。
  5. 既存のプロビジョニングスキームの新しいネットワーク設定を確認するには、(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行します。

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

MCSマシンカタログがSet-ProvSchemeコマンドで更新されると、現在の構成がバージョンとして保存されます。その後、PowerShellコマンドを使用して、マシンカタログのさまざまなバージョンを管理できます。次のことができます。
  • マシンカタログのバージョンリストを表示する
  • 以前のバージョンを使用してマシンカタログを更新する
  • そのマシンカタログのVMで使用されていないバージョンを手動で削除する
  • マシンカタログによって保持される最大バージョン数を変更する（デフォルトは99）
バージョンには、マシンカタログの次の情報が含まれます。
  • VMCpuCount
  • VMMemoryMB
  • CustomProperties
  • ServiceOffering
  • MachineProfile
  • NetworkMapping
  • SecurityGroup
マシンカタログのさまざまなバージョンを管理するには、次のコマンド（例として提供）を実行します。
  • マシンカタログのさまざまなバージョンの構成詳細を表示するには:
    Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
  • マシンカタログの特定のバージョンの構成詳細を表示するには:
    Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
  • マシンカタログに関連付けられているバージョンの総数を表示するには:
    (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
  • 以前のバージョンを使用してマシンカタログを更新するには:
    Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
  • そのマシンカタログのVMで使用されていないバージョンを手動で削除するには:
    Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
  • マシンカタログで保持される最大バージョン数を設定します（デフォルトは99）。この設定は、すべてのカタログに適用されます。たとえば、この場合、すべてのMCSプロビジョニング済みカタログに対して最大15バージョンが保持されます。
    Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
バージョン数が最大バージョン数に達した場合、マシンカタログ内のいずれかのVMで古いバージョンが使用されていると、新しいバージョンを作成できません。その場合は、次のいずれかを実行してください:
  • マシンカタログによって保持される最大バージョン数の制限を増やします。
  • 古いバージョンを使用している一部のVMを更新して、それらの古いバージョンがどのVMからも参照されなくなり、削除できるようにします。

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

VM、テンプレート仕様（Azureの場合）、起動テンプレート（AWSの場合）、またはVMwareテンプレート（VMwareの場合）をマシンプロファイルの入力として使用して、マシンプロファイルに基づかないマシンカタログをマシンプロファイルに基づくマシンカタログに変換できます。カタログに追加された新しいVMは、明示的なカスタムプロパティによって上書きされない限り、マシンプロファイルからプロパティ値を取得します。
注:
既存のマシンプロファイルに基づくマシンカタログを、マシンプロファイルに基づかないマシンカタログに変更することはできません。
これを行うには:
  1. VMを含み、マシンプロファイルを含まない永続的または非永続的なマシンカタログを作成します。
  2. PowerShell ウィンドウを開きます。
  3. マシンプロファイルからマシンカタログに追加された新しいVMにプロパティ値を適用するには、Set-ProvScheme コマンドを実行します。例:
    • Azureの場合:
      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
    • AWSの場合:
      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
    • VMwareの場合:
      Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
      注:
      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
      コマンドで使用されるパラメーターの説明は次のとおりです。
      • IdentityAccountName：修復する必要があるIDアカウントの名前。
      • PrivilegedUserName：IDプロバイダー（ADまたはAzureAD）に対する書き込み権限を持つユーザーアカウント。
      • PrivilegedUserPassword：PrivilegedUserNameのパスワード。
      • Target：修復アクションのターゲット。アカウントのパスワード/信頼キーを修復するためのIdentityInfo、およびMicrosoft Entraハイブリッド参加済みマシンIDのユーザー証明書属性を修復するためのUserCertificateを指定できます。
    • IDディスクのすべての構成をリセットするには、次の順序で次のコマンドを実行します。
      Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfoReset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
    • IDディスクを完全に再作成するには:
      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
      注:
      マシンがVDAバージョン2511以降を使用するWindowsマシンの場合、-Recreate の設定に関係なく、以前と同じ MachineGuid を引き続き使用します。
  4. 「y」と入力してアクションを確定します。-Force パラメーターを使用して確認プロンプトをスキップすることもできます。例：
    Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
  5. 更新されたIDディスク設定を確認するには、Get-ProvVM -ProvisioningSchemeName <name -VMName <name> を実行します。IDディスクの属性（例：IdentityDiskId）は更新されている必要があります。StorageId と IdentityDiskIndex は変更してはいけません。

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

MCSIOが有効な非永続カタログを作成した後、Set-ProvSchemeコマンドを使用して次のパラメーターを変更できます。
  • WriteBackCacheMemorySize
  • WriteBackCacheDiskSize
この機能は現在、以下に適用されます。
  • GCPおよびMicrosoft 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

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

Set-ProvSchemeコマンドを実行します。例：
Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
注:
  • 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以降を使用）
  • Virtual Apps and Desktops Remote PowerShell SDK バージョン 7.40 以降（Jan 10, 2024 以降にリリース）

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

VDAインストーラーパッケージを含むネットワーク共有には、ローカルシステム（NT AUTHORITY\SYSTEMプリンシパル）として実行されるVDAアップグレードエージェントサービスに対する読み取りアクセス権が必要です。
  • ドメイン参加済みファイル共有のアクセス許可
    VDAマシンがドメインに参加している場合、ローカルシステムアカウント（VUAはローカルシステムとして実行）は、ネットワーク共有にアクセスする際にコンピューターの資格情報を使用します。
    最小特権のアクセス許可は、Domain Computers に 読み取り アクセスを付与することで設定できます。
    1. ファイルを共有するネットワーク上のユーザーを選択します。
    2. 詳細な共有設定をクリックし、ファイルとプリンターの共有をオンにします。
  • ドメインに参加していないファイル共有のアクセス許可
    VDAマシンがドメインに参加していない場合、ローカルシステムアカウント（VUAはローカルシステムとして実行）は、ネットワーク共有にアクセスする際に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 Virtual Apps and Desktopsを選択します。
    3. Citrix Virtual Apps and Desktops 7 2311, All Editions という項目を選択します。
    4. 「製品ISOに含まれるが個別にパッケージ化されているコンポーネント」の展開可能な項目からVDAインストーラーを選択します。
  2. カタログの種類に基づいて、関連するVDAインストーラーを選択します。
    • カタログの種類がマルチセッションの場合は、「Multi-session OS VDA installer」をダウンロードします。
    • カタログの種類がシングルセッションの場合は、「Single-session OS VDA installer」をダウンロードします。
    • カタログの種類がRemote PC Accessの場合は、「Single-session OS Core Services VDA installer」をダウンロードします。
注:
ファイル共有インストーラーのバージョンは、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 *
    • WBCストレージ情報についてはTemporaryStorageInfoを実行します。例:
      $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
      $result
      $result.TemporaryStorageInfo | Format-List -Property *
  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
    重要:
    永続VMの場合、すべてのディスクが移動されます。移動するディスクを選択することはできません。
    非永続VM：
    (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
    重要:
    • 特定のディスクを移行したくない場合は、DestinationStorageIdパラメーターの値をNoneに設定します。
    • VMにWBCディスクがある場合は、WBCディスクをDiskTypeパラメーターに追加し、必要な情報をDestinationStorageIdパラメーターに追加します。

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

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

制限事項

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

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

移行するには、次の手順を実行します。
  1. StudioまたはPowerShellコマンドを使用して、イメージ定義とイメージバージョンを作成します。イメージ定義とイメージバージョンを作成する手順については、以下を参照してください。
    • アジュール:
    • ヴイエムウェア：
      • ウェブスタジオ(https://docs.citrix.com/ja-jp/citrix-virtual-apps-desktops/2511/install-configure/create-prepared-image-machine-catalogs-vmware#use-web-studio)
      • PowerShell
  2. プロビジョニングスキームのUIDを取得するには、Get-ProvSchemeコマンドを実行します。例:
    Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
  3. イメージ定義名、イメージバージョン仕様のUIDを取得するには、Get-ProvImageVersionSpecコマンドを実行します。例:
    Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
  4. 既存のMCSプロビジョニング済みマシンカタログを準備済みイメージマシンカタログに移行するには、Set-ProvSchemeImageコマンドを実行します。例:
    Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
  5. カタログが移行されたことを確認するには、Get-ProvSchemeコマンドを実行します。例:
    Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid

トラブルシューティング

次のステップ

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