製品ドキュメント
Citrix Virtual Apps and Desktops 7 2311
PDFを表示

マシンカタログの管理

May 31, 2026
寄稿者: 
C C

注：

Citrix Virtual Apps and Desktops™ の展開は、WebベースのWeb StudioとWindowsベースのCitrix Studioという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を使用してカタログを管理する方法について詳しく説明します。

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

開始する前に:

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

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

  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. カタログの種類によっては、追加のページが表示される場合があります。

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

    • 仮想マシンページで、マシンを作成する場所のマシンサイズと可用性ゾーンを変更します。

      注：

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

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

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

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

    注：

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

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

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

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

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

  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のすべてのノード（マシンカタログノードやアプリケーションノードなど）は、バックエンドでフォルダーツリーを共有しています。フォルダーの名前変更や移動時に他のノードとの名前の競合を避けるため、異なるノードの第1レベルフォルダーには異なる名前を付けることをお勧めします。

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

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

ヒント:

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

カタログを移動する

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

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

ヒント:

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

カタログフォルダを管理する

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

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

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

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

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

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

パワーシェルを使用

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

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

過去のエラーと警告を取得して、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 を参照してください。

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

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

  • マスターイメージを使用してマシンカタログを作成する際にメモを追加するには、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ディスクをリセットする

PowerShellコマンド Reset-ProvVMDisk を使用して、MCSで作成されたマシンカタログ内の永続VMのOSディスクをリセットします。現在、この機能は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 を使用します。

注記:

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

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

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

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

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

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

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

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

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

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

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

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

    ``` (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の場合）をマシンプロファイルの入力として使用して、マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換できます。カタログに追加された新しいVMは、明示的なカスタムプロパティによって上書きされない限り、マシンプロファイルからプロパティ値を取得します。

注:

既存のマシンプロファイルベースのマシンカタログを、非マシンプロファイルベースのマシンカタログに変更することはできません。

これを行うには：

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

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

    • アジュールの場合：

       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"

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

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

注：

現在、この機能は Azure および 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: プリビレッジドユーザー名のパスワード。
      • Target: 修復アクションのターゲット。アカウントパスワード/信頼キーを修復する場合はIdentityInfo、ハイブリッドAzureAD参加済みマシンIDのユーザー証明書属性を修復する場合はUserCertificateを指定できます。

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

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo


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

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

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

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

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

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

  • ジーシーピー および マイクロソフト アジュール 環境、および
  • 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

注：

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

トラブルシューティング

次のステップ

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

マシンカタログの管理
May 31, 2026
寄稿者: 
C C
May 31, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.