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

最終公開日 : Nov 13, 2026
注:
Citrix Virtual Apps and Desktops™の展開は、Web Studio（Webベース）とCitrix Studio（Windowsベース）の2つの管理コンソールを使用して管理できます。この記事ではWeb Studioのみを扱います。Citrix Studioについては、Citrix Virtual Apps and Desktops 7 2212以前の同等の記事を参照してください。
Related information
インストールと構成
AWSカタログの管理XenServer®カタログを管理するGoogle Cloud Platformカタログの管理HPE Moonshot カタログを管理する (プレビュー)Microsoft Azureカタログを管理するMicrosoft System Center Virtual Machine Manager カタログを管理する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を使用してカタログを管理する方法について詳しく説明します。

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

開始する前に:
  • 仮想化ホストに、追加のマシンを収容するのに十分なプロセッサ、メモリ、ストレージがあることを確認してください。
  • 十分な未使用のActive Directoryコンピューターアカウントがあることを確認してください。既存のアカウントを使用している場合、追加できるマシンの数は利用可能なアカウントの数によって制限されます。
  • 追加のマシン用にActive Directoryコンピューターアカウントを作成するためにWeb Studioを使用する場合、適切なドメイン管理者権限が必要です。
カタログにマシンを追加するには:
  1. Web Studioにサインインします。
  2. 左側のペインでMachine Catalogsを選択します。
  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イメージを使用して作成されたカタログの場合、次のページが表示されます。行った変更は、後でカタログに追加するマシンにのみ適用されることに注意してください。既存のマシンは変更されません。
    • Virtual Machinesページで、マシンを作成するマシンサイズと可用性ゾーンを変更します。
      注:
      • カタログがサポートするマシンサイズのみが表示されます。
      • 必要に応じて、Show only machine sizes used in other machine catalogsを選択して、マシンサイズリストをフィルターします。
    • Machine Profileページで、マシンプロファイルを使用するか変更するかを選択します。
    • (カタログが専用ホストグループで構成されている場合にのみ表示) 専用ホストグループページで、ホストグループを変更するかどうかを選択します。
    • ストレージとライセンスの種類ページで、ストレージの種類、ライセンスの種類、および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. 左側のペインでMachine Catalogsを選択します。
  3. カタログを選択し、アクションバーでマシンカタログの削除を選択します。
  4. カタログ内のマシンを削除するかどうかを指定します。マシンを削除することを選択した場合、それらのマシンのActive Directoryコンピューターアカウントを保持するか、無効にするか、削除するかを指定します。

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

マシンカタログ内のActive Directoryアカウントを管理するには、次の操作を実行できます。
  • シングルセッションOSおよびマルチセッションOSカタログからActive Directoryコンピューターアカウントを削除して、未使用のマシンアカウントを解放します。これらのアカウントは、他のマシンで使用できます。
  • カタログにマシンが追加されたときに、コンピューターアカウントがすでに存在するようにアカウントを追加します。OU名にスラッシュ (/) を使用しないでください。
Active Directoryアカウントを管理するには：
  1. Web Studioにサインインします。
  2. 左側のペインでMachine Catalogsを選択します。
  3. カタログを選択し、アクションバーでManage AD accountsを選択します。
  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. 左側のペインでMachine Catalogsを選択します。
  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. 左側のペインで、Machine Catalogsを選択します。
  2. フォルダー階層でフォルダーを選択し、必要に応じてアクションバーでアクションを選択します。
    • フォルダーの名前を変更するには、フォルダーの名前を変更を選択します。
    • フォルダーを削除するには、フォルダーの削除を選択します。
    • フォルダーを移動するには、フォルダーの移動を選択します。
  3. 画面の指示に従って、残りの手順を完了します。

PowerShellを使用する

このセクションでは、PowerShellを使用してカタログを管理する方法について詳しく説明します。
  • カタログに関連付けられた警告とエラーを取得する
  • イメージに説明を追加する
  • OSディスクをリセットする
  • 既存のプロビジョニングスキームのネットワーク設定を変更する
  • マシンカタログのバージョンを管理する(/ja-jp/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#manage-versions-of-a-machine-catalog)
  • マシンプロファイルに基づかないマシンカタログを、マシンプロファイルに基づくマシンカタログに変換する(/ja-jp/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#convert-a-non-machine-profile-based-machine-catalog-to-machine-profile-based-machine-catalog)
  • アクティブなコンピューターアカウントの識別情報を修復する(/ja-jp/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#repair-the-identity-information-of-active-computer-accounts)
  • 既存のマシンカタログのキャッシュ構成を変更する(/ja-jp/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#change-cache-configuration-on-an-existing-machine-catalog)

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

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

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
    • Get-ProvVMコマンドからの出力としてVMのリストを指定し、各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. 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"}
  4. Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMapを実行します。
  5. 既存のプロビジョニングスキームの新しいネットワーク設定を確認するには、(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行します。

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

MCSマシンカタログがSet-ProvSchemeコマンドで更新されると、現在の構成がバージョンとして保存されます。その後、PowerShellコマンドを使用して、マシンカタログのさまざまなバージョンを管理できます。次のことができます。
  • マシンカタログのバージョンリストを表示する
  • 以前のバージョンを使用してマシンカタログを更新する
  • そのマシンカタログのVMで使用されていないバージョンを手動で削除する
  • マシンカタログによって保持される最大バージョン数を変更する（デフォルトは99）
バージョンには、マシンカタログの次の情報が含まれます。
  • VMCpuCount
  • VMMemoryMB
  • CustomProperties
  • ServiceOffering
  • MachineProfile
  • ネットワークマッピング
  • セキュリティグループ
マシンカタログのさまざまなバージョンを管理するには、次のコマンド（例として提供）を実行します。
  • マシンカタログのさまざまなバージョンの構成詳細を表示するには：
    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の場合）をマシンプロファイルの入力として使用して、マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換できます。カタログに追加された新しいVMは、明示的なカスタムプロパティによって上書きされない限り、マシンプロファイルからプロパティ値を取得します。
注:
既存のマシンプロファイルベースのマシンカタログを、非マシンプロファイルベースのマシンカタログに変更することはできません。
これを行うには：
  1. VMを使用し、マシンプロファイルを使用しない永続的または非永続的なマシンカタログを作成します。
  2. PowerShellウィンドウを開きます。
  3. マシンプロファイルからマシンカタログに追加された新しいVMにプロパティ値を適用するには、Set-ProvSchemeコマンドを実行します。例：
    • Azureの場合:
      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\&lt;HostingUnitName>\machineprofile.folder\&lt;ResourceGroupName>\&lt;TemplateSpecName>\&lt;VersionName>
    • AWSの場合:
      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\&lt;hosting-unit>\&lt;launch-template>.launchtemplate\&lt;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: PrivilegedUserNameのパスワード。
      • Target: 修復アクションのターゲット。アカウントのパスワード/信頼キーを修復するためのIdentityInfo、およびハイブリッドAzureAD参加済みマシンIDのユーザー証明書属性を修復するためのUserCertificateを指定できます。
    • IDディスクのすべての構成をリセットするには、次のコマンドを次の順序で実行します。
      Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfoReset-ProvVMDisk ProvisioningSchemeName &lt;name> -VMName &lt;name>  -Identity
    • IDディスクを完全に再作成するには:
      Reset-ProvVMDisk -ProvisioningSchemeName &lt;name> -VMname &lt;name> -Identity -Recreate
  4. アクションを確認するには、「y」と入力します。-Forceパラメーターを使用して確認プロンプトをスキップすることもできます。例：
    Reset-ProvVMDisk -ProvisioningSchemeName &lt;name> -VMName &lt;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
注：
  • 少なくとも1GBのキャッシュディスクストレージが必要なため、WriteBackCacheDiskSize の値はゼロより大きくする必要があります。
  • WriteBackCacheMemorySize の値は、マシンカタログのメモリサイズよりも小さくする必要があります。
  • これらの変更は、変更後にカタログに追加された新しい VM にのみ影響します。既存の VM はこれらの変更の影響を受けません。

トラブルシューティング

次のステップ

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