Nutanixカタログの管理

最終公開日 : Oct 24, 2026
マシンカタログの管理では、マシンカタログを管理するウィザードについて説明します。以下の情報は、Nutanix AHV Prism Central環境に固有の詳細を扱っています。
注：
Nutanix AHV Prism Centralでマシンカタログを管理する前に、Nutanix AHV Prism Centralでマシンカタログの作成を完了する必要があります。Nutanixカタログの作成を参照してください。
Nutanix AHV Prism Centralでマシンカタログを管理するには、次の方法を使用できます。
Related information
マシンカタログを管理する

Studioの使用

Studioを使用してNutanix AHV Prism Centralでマシンカタログを管理するためのオプションは次のとおりです。
オプション 説明
マシンの追加 マシンカタログにVMを作成して追加します。
マシンカタログの削除 マシンカタログを削除します。同時にVMを削除するか、永続VMをそのまま残すかを選択できます。
マスターイメージの変更 カタログ内のすべてのVMのテンプレートとして使用されるマスターイメージを変更します。
マシンプロファイルの追加または変更 マシンプロファイルのテンプレートバージョンを変更するか、既存のカタログにマシンプロファイルを追加します。
構成セットの管理 カタログをWorkspace Environment Management™構成セットにバインドするか、別の構成に切り替えます。
マシンカタログの編集 NICや仮想マシンなど、カタログの構成を変更します。
マシンの表示 カタログに属するすべてのVMを表示するには、検索ノードに移動します。
マシンカタログの名前変更 カタログ名を変更します。
VDAのアップグレード カタログごとにVDAをアップグレードします。この機能は、静的永続マシンにのみ適用されます。
機能レベルの変更 カタログの最小機能レベルを選択します。機能レベルを設定すると、すべての機能が利用可能になります。
マシンカタログのテスト カタログにエラーまたは警告があるかどうかをテストします。
タグの管理 タグを作成、編集、削除します。カタログに適用するタグを選択します。
マシンカタログの移動 カタログを別のフォルダーに移動します。
注：
現在、クローンオプションは利用できません。

マスターイメージの変更

カタログのマスターイメージを変更するには、次の手順に従います。
  1. マシンカタログページで、更新するマシンカタログを右クリックし、マスターイメージの変更を選択します。
  2. マスターイメージの変更ページで、イメージの選択をクリックします。
    AHV-Prism Central ホスト接続
  3. イメージの選択ページで、テンプレートを展開し、マスターイメージとして使用するテンプレートバージョンを選択します。マシンテンプレートは名前でフィルタリングできます。
  4. 「ロールアウト戦略」ページで、更新を適用するタイミングを選択します。
注：
  • Nutanix AHV Prism Centralホスト接続プラグインを使用するMCSプロビジョニングの非永続カタログの場合、マスターイメージを更新してブート構成をLegacyとUEFIの間で切り替えると、既存のVMが次回の起動時に開始できなくなります。
  • マスターイメージを更新すると、OSディスクのみが更新されます。ハードウェアプロパティは変更されません。ハードウェアプロパティを更新するには、「マシンプロファイルの追加または変更」、「NICの変更」、および「VM構成の変更」を参照してください。

マシンプロファイルの追加または変更

カタログのマシンプロファイルを追加または変更するには、次の手順に従います。
  1. 「マシンカタログ」ページで、変更するマシンカタログを右クリックし、「マシンカタログの編集」を選択します。
  2. 「マシンプロファイル」ページで、,
    • マシンカタログにすでにマシンプロファイルがある場合は、鉛筆アイコンをクリックして別のマシンプロファイルテンプレートバージョンを選択します。テンプレート名でフィルタリングできます。マシンプロファイルの設定を確認します。
    • マシンカタログにマシンプロファイルがない場合は、「マシンプロファイルを使用」を選択し、マシンプロファイルを選択します。マシンプロファイルの設定を確認します。
  3. 「仮想マシン」ページには、選択したマシンプロファイルテンプレートバージョンに従って更新された構成が反映されている必要があります。

NICの変更

カタログのNICを変更するには、次の手順に従います。
  1. 「マシンカタログ」ページで、変更するマシンカタログを右クリックし、「マシンカタログの編集」を選択します。
  2. 「NIC」ページで、:
    • 「NICタイプを選択します。」.
    • 選択したカタログがマシンプロファイルで作成された場合、NICの数はマシンプロファイルのNICの数と一致し、変更できません。各NICに関連付けられた仮想ネットワークを選択します。
      マシンプロファイル付きのAHV Prism Central NIC
    • 選択したカタログがマシンプロファイルなしで作成された場合、NICの追加をクリックしてNICの数を増やすか、削除をクリックして選択したNICを削除します。ボックスを選択またはクリアしてNICを選択し、各NICに関連付けられた仮想ネットワークを選択します。
      マシンプロファイルなしのAHV Prism Central NIC

VMの構成を変更する

メモリ、CPU数、vCPUあたりのコア数など、VMの構成を変更するには、次の手順に従います。
  1. マシンカタログページで、変更するマシンカタログを右クリックし、マシンカタログの編集を選択します。
  2. 仮想マシンページで、上矢印または下矢印を使用するか、値を直接入力して、VMのメモリ、CPU数、vCPUあたりのコア数を調整します。
    AHV Prism Centralホスト接続

PowerShellを使用する

マスターイメージを変更する

必要なパラメーターは次のとおりです。
  • ProvisioningSchemeName: 編集するプロビジョニングスキームの名前。
  • MasterImage: 新しいマスターイメージへのリテラルパス。
次のコマンドを実行します。例:
Set-ProvSchemeMetadata  -Name "ImageManagementPrep_DoImagePreparation" -ProvisioningSchemeName "<ProvisioningSchemeName>" -Value "True"

Publish-ProvMasterVMImage  -MasterImageVM "<Literal path to the new master image- template version> -ProvisioningSchemeName "<ProvisioningSchemeName>" -RunAsynchronously
注：
マスターイメージを更新すると、OSディスクのみが更新されます。ハードウェアプロパティは変更されません。ハードウェアプロパティを更新するには、「マシンプロファイルの追加または変更」、「NICの変更」、および「NICとVMの構成の変更」を参照してください。

マシンプロファイルの追加または変更

Set-ProvSchemeコマンドを使用します。
  • 新しいマシンプロファイルでカタログを更新する場合、または
  • マシンプロファイルを持たない既存のカタログを、ハードウェア仕様のソースとしてマシンプロファイルを使用するように更新する場合。
注：
これにより、カタログ内の既存のVMのハードウェア仕様は更新されません。カタログに追加された新しいVMのみが、指定されたマシンプロファイルからのハードウェア仕様を持ちます。
マシンプロファイルを変更するか、既存のカタログをマシンプロファイルを使用するように変換するには：
Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
               -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
               -NetworkMapping @{"0"="XDHyp:\HostingUnits\<Hosting unit name>\Clusters.folder\<Cluster Name>.cluster\<Network name>.network"}
マシンプロファイルには少なくとも1つのNICが必要であり、マシンプロファイル内のNICの数はNetworkMappingのサブネットマッピングと一致する必要があります。
テンプレートバージョンのNICの総数は、次の方法でそのインベントリアイテムのAdditionalDataから取得できます。
$tv = Get-Item -Path "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
$tv.AdditionalData.TotalNics
オーバーライドされたハードウェア仕様でマシンプロファイルを変更するには：
特定の構成は、特定のコマンドラインパラメーターを使用して構成できます。CustomPropertiesのVMCpuCount、VMMemoryMB、およびCPUCoresなどのこれらのコマンドラインパラメーターは、マシンプロファイルテンプレートバージョンの値よりも優先されます。
$customProperties = @"
    <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <StringProperty Name="ClusterId" Value="00062c63-1fb0-58c9-4fc8-5c2573352378" />
        <StringProperty Name="CPUCores" Value="2" />
    </CustomProperties>
"@

Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `
               -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion" `
               -CustomProperties $customProperties `
               -VMCpuCount 4 `
               -VMMemoryMB 4096

NICとVMの構成を変更する

必要なパラメーターは次のとおりです。
  • ProvisioningSchemeName: 編集するプロビジョニングスキームの名前。
  • NetworkMapping: 更新されたネットワークマッピング。
次のコマンドを実行します。例：
Set-ProvScheme  -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ClusterId`" Value=`"000xxxx-1fb0-xxxxx-4fc8-5c257335xxxx`" /><Property xsi:type=`"StringProperty`" Name=`"CPUCores`" Value=`"1`" /></CustomProperties>"  -NetworkMapping @{"6"="XDHyp:\HostingUnits\<Hosting Unit Name>\Clusters.folder\<Cluster Name>\<Network name>.network"} -ProvisioningSchemeName "<ProvisioningSchemeName>" -VMCpuCount 4

永続VMのOSディスクをリセットする

永続VM、特にvTPMが有効になっているVMでOSディスクをリセットすると、vTPMキーとBitLockerに依存するアプリケーションが破損し、起動できなくなる可能性があります。そのため、この機能では次のことが可能です。
  • 永続VMのOSディスクをリセットし、VMハードウェア構成を保持する。
  • ディスクスワップ中にvTPMの依存関係が壊れるのを避けるために、vTPMが有効なVMを管理する。
Reset-ProvVMDisk PowerShellコマンドを使用して、永続VMのOSディスクをリセットできます。
  • vTPMが有効なVMの場合：元のハードウェア情報を使用してリカバリポイントから新しいVMが作成され、vTPMキーが保持されます。
  • vTPM以外のVMの場合：OSディスクが交換されます。
例については、「OSディスクのリセット」を参照してください。

マシンカタログをCitrix管理のNutanix AHV Prism Centralホスト接続に移行する

Citrixマシンカタログとそれに関連付けられたVMを、既存のNutanix AHV（Prism Element用）およびNutanix AHV PC（Azure上のNC2用）ホスト接続から、Citrix管理のNutanix AHV Prism Centralホスト接続に移行します。移行にはPowerShellコマンドを使用します。これには、問題が発生した場合の高速ロールバックオプションや、移行後にソースリソースをクリーンアップするコマンドも含まれます。

利点

  • 中断の最小化: Nutanix AHV Prism Centralプラグインへのスムーズな移行が可能です。これにより、既存の展開への影響を最小限に抑えられます。
  • シームレスなアップグレードパス: インフラストラクチャをアップグレードし、新しい管理インターフェイスを活用するための明確でサポートされたパスを提供します。
  • データの整合性と安全性: ロールバックオプションにより、予期せぬ問題が発生した場合でも環境を元の状態に戻すことができます。これにより、リスクが軽減されます。
  • リソース効率: 移行が成功した後、ソースリソースをクリーンアップします。これにより、ストレージと管理のオーバーヘッドが最適化されます。
  • 柔軟性: MCSとサードパーティテクノロジーの両方によってプロビジョニングされたカタログの移行をサポートします。これにより、より幅広い適用性が提供されます。

適用性

この機能は、Nutanix AHV（Prism Element用）およびNutanix AHV PC（Azure上のNC2用）ホスト接続下のマシンカタログに適用されます。
  • MCSによって管理されるマシンカタログ（永続タイプと非永続タイプの両方を含む）。
  • サードパーティテクノロジーによってプロビジョニングされたVMを含む、電源管理のみのマシンカタログ。

システム要件

  • Nutanix AHV Prism Element (PE) AOSバージョン: 最小バージョン6.8が必要です。
  • Nutanix Prism Central (PC)バージョン: 最小バージョン2024.3が必要です。
注:
Nutanixの既知の問題により、Nutanix Prism Central 7.3にはAOS 7.3が必要です。

制限事項

  • PVSカタログはサポートされていません：この機能は、Citrix Provisioning Services (PVS) Xendesktop Setup Wizard を使用して作成されたマシンカタログをサポートしていません。
  • ロールバックの制限：
    • 移行されたカタログのロールバックは、最初の移行後にカタログを変更していない場合にのみ許可されます。
    • 「Cleanup Source Resources」操作を実行すると、移行状態がクリアされます。これにより、その後のロールバックが防止されます。
  • 再移行はできません：すでに移行したマシンカタログは、再移行がサポートされていません。
  • 複数ホスト接続VM：複数のホスト接続からインポートされたVMを含む、電源管理のみのマシンカタログの移行はサポートされていません。

重要な考慮事項

  • Nutanixクラスター管理：ホスティングNutanix AHVクラスターは、Nutanix Prism Centralに登録されている必要があります。
  • マスターイメージテンプレートの作成：MCSマシンカタログの場合、移行コマンドは、マシンカタログマスターイメージの元のスナップショットからPrism Central上にVMテンプレートバージョンを生成するオプションを提供します。このVMテンプレートバージョンは、後でPrism Centralホスト接続下のマシンカタログのMCSマスターイメージとして使用できます。デフォルトでは、このオプションは有効になっていません。
  • ロールバックの前提条件：
    ロールバックを成功させるには、ホスト接続、ベースディスクを含む元のソース環境が変更されていない必要があります。また、移行が成功したと確認されるまで、移行されたマシンカタログへの構成変更やVMの追加/削除は避ける必要があります。 確認後、最終的なCleanup Source Resources操作を実行できますが、これは元に戻せない手順であり、ロールバックが不可能になることに注意してください。

移行とロールバックに必要な権限

カタログを移行またはロールバックするには、次の権限が必要です。
Prism Element管理者：
  • 仮想マシンの作成
Prism Central管理者：
  • VMテンプレートを作成
  • VMテンプレートを削除
  • VMリカバリポイントを削除
  • 仮想マシンを削除
Citrix管理のNutanix AHV Prism Centralホスト接続に必要な特定の権限の完全なリストについては、「必要な権限」を参照してください。

移行方法

この機能は、専用のPowerShellコマンドレットを使用して管理します。一般的なワークフローには、移行、ロールバック、ソースリソースのクリーンアップという3つの主要な操作が含まれます。

マシンカタログを移行する

  • この操作は、マシンカタログとその関連VMを、ソースのNutanix AHVまたはNutanix AHV PCホスト接続から、ターゲットのCitrix管理Nutanix AHV Prism Centralホスト接続に移動します。
  • MCSプロビジョニングされたカタログの場合、このプロセスはターゲット接続に新しいベースディスクを作成します。
  • オプションで、元のマスターイメージスナップショットから、ターゲット接続にマスターVM相当（VMテンプレートバージョン）を作成することを選択できます。
  1. 新しいNutanix AHV Prism Centralホスト接続を作成する: 移行する前に、ホスティングNutanix AHVクラスターをNutanix Prism Centralに登録し、ターゲットのNutanix Prism Centralインスタンスを指す新しいNutanix AHV Prism Centralホスト接続を確立します。この接続は、移行されたカタログの宛先として機能します。詳細については、「Nutanix AHV Prism Centralホスト接続」を参照してください。
  2. 既存のマシンカタログを移行する: 既存のマシンカタログの場合、Switch-ProvCatalog PowerShellコマンドレットを使用して、Citrix管理のNutanix AHV Prism Centralホスト接続への移行を開始します。
    c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination
    • <Catalog_UID>を、移行するマシンカタログの一意の識別子に置き換えます。カタログ名Get-BrokerCatalog -Name <Catalog Name>でBrokerCatalogUidを検索するには、次のPowerShellコマンドレットを使用します。
    • DestinationConnectionは、手順1で作成された新しいNutanix AHV Prism Centralホスト接続の名前です。
    • DestinationUnitは、マシンカタログが配置されるDestinationConnection内のホスティングユニットに与える名前です。
    • The -CreateMasterImageAtDestinationパラメーターはオプションです。これは、ターゲットのPrism Central上にマスターイメージVMテンプレートバージョンを作成します。
  3. 移行の完了を確認する: 移行コマンドレットを実行した後、PowerShellウィンドウでタスクのステータスを監視し、正常に完了したことを確認します。移行が完了すると、カタログはステップ1で作成されたターゲットホスト接続に移動されます。タスクタイプSwitchProvCatalogで「完了」ステータスが表示されるはずです。移行の完了を確認するための推奨手順は次のとおりです。
    • Studioでカタログのステータスを確認します。
    • カタログ内のVMが、新しい宛先ハイパーバイザー接続に関連付けられていることを確認します。
    • カタログ内のVMが正しい電源状態を表示していることを確認します。
    • マシンを追加または削除したり、電源操作を実行したりして、移行されたマシンカタログの機能をテストし、カタログが正しく機能していることを確認します。

移行されたカタログをロールバックする

この操作により、マシンカタログとそのVMが元のソースホスト接続に復元されます。移行プロセス中に作成したリソースはすべて削除されます。
重要:
ロールバックは、移行後にカタログを変更しておらず、ソースリソースのクリーンアップ操作を実行していない場合にのみ実行します。元のソース接続は変更されず、引き続きベースディスクが含まれています。
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback

ソースリソースのクリーンアップ

移行が成功した後、この操作により、元のハイパーバイザー接続からソースリソース（ベースディスクなど）が削除されます。
重要:
このコマンドを実行すると、移行状態がクリアされます。これにより、その後のロールバックは不可能になります。
c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources
続行する前に確認プロンプトが表示されます。この操作は元に戻せないためです。クリーンアップを完了するには、プロンプトを承認してください。

詳細情報

  • 接続とリソースの作成および管理(/ja-jp/citrix-daas/install-configure/connections.html)
  • Nutanixへの接続(/ja-jp/citrix-daas/install-configure/connections/connection-nutanix-virtualization-environments.html)
  • Nutanixクラウドおよびパートナーソリューションへの接続(/ja-jp/citrix-daas/install-configure/connections/connection-nutanix-cloud-and-partner-solutions.html)
  • マシンカタログの作成(/ja-jp/citrix-daas/install-configure/machine-catalogs-create.html)
  • Nutanixカタログの作成(/ja-jp/citrix-daas/install-configure/machine-catalogs-create/create-machine-catalog-nutanix.html)
  • マシンカタログの管理(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html)