Citrix DaaS™

Nutanixカタログの管理

September 3, 2026

寄稿者:

C C

マシンカタログを管理するウィザードについては、(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html)で説明しています。以下の情報は、Nutanix AHV Prism Central環境に固有の詳細を扱っています。

注：

Nutanix AHV Prism Centralでマシンカタログを管理する前に、Nutanix AHV Prism Centralでマシンカタログの作成を完了する必要があります。(/ja-jp/citrix-daas/install-configure/machine-catalogs-create/create-machine-catalog-nutanix)を参照してください。

Nutanix AHV Prism Centralでマシンカタログを管理するには、次の方法があります。

(#use-studio)
(#use-powershell)

Studioの使用

Studioを使用してNutanix AHV Prism Centralでマシンカタログを管理するためのオプションは次のとおりです。

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

注：

現在、クローンオプションは利用できません。

マスターイメージの変更

カタログのマスターイメージを変更するには、次の手順に従います。

マシンカタログページで、更新するマシンカタログを右クリックし、マスターイメージの変更を選択します。
マスターイメージの変更ページで、イメージの選択をクリックします。
イメージの選択ページで、テンプレートを展開し、マスターイメージとして使用するテンプレートバージョンを選択します。マシンテンプレートは名前でフィルターできます。
「ロールアウト戦略」ページで、更新を適用するタイミングを選択します。

注：

Nutanix AHV Prism Centralホスト接続プラグインを使用するMCSプロビジョニングの非永続カタログの場合、マスターイメージを更新してブート構成をLegacyとUEFIの間で切り替えると、既存のVMが次回の起動時に開始できなくなります。

マスターイメージを更新すると、OSディスクのみが更新されます。ハードウェアプロパティは変更されません。ハードウェアプロパティを更新するには、「マシンプロファイルの追加または変更」、「NICの変更」、および「VM構成の変更」を参照してください。

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

カタログのマシンプロファイルを追加または変更するには、次の手順に従います。

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

NICの変更

カタログのNICを変更するには、次の手順に従います。

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

VMの構成を変更する

メモリ、CPU数、vCPUあたりのコア数など、VMの構成を変更するには、次の手順に従います。

マシンカタログページで、変更するマシンカタログを右クリックし、マシンカタログの編集を選択します。
仮想マシンページで、上矢印または下矢印を使用するか、値を直接入力して、VMのメモリ、CPU数、vCPUあたりのコア数を調整します。

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
<!--NeedCopy-->

注:

マスターイメージを更新すると、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"}
<!--NeedCopy-->

マシンプロファイルには少なくとも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
<!--NeedCopy-->

上書きされたハードウェア仕様でマシンプロファイルを変更するには:

特定の構成は、特定のコマンドラインパラメータを使用して構成できます。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
<!--NeedCopy-->

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
<!--NeedCopy-->

永続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ホスト接続に移行する

既存のNutanix AHV (Prism Element用) およびNutanix AHV PC (Azure上のNC2用) ホスト接続から、Citrix管理のNutanix AHV Prism Centralホスト接続に、Citrixマシンカタログとそれに関連するVMを移行します。移行には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 を使用して作成されたマシンカタログをサポートしていません。
ロールバックの制限:
- 最初の移行後にカタログを変更していない場合にのみ、移行済みカタログのロールバックを許可します。
- 「ソースリソースのクリーンアップ」操作を実行すると、移行状態がクリアされます。これにより、その後のロールバックが防止されます。
再移行はできません: 既に移行したマシンカタログは、再移行がサポートされていません。
複数ホスト接続のVM: 複数のホスト接続からインポートされたVMを含む、電源管理のみのマシンカタログの移行はサポートされていません。

重要な考慮事項

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

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

カタログを移行またはロールバックするには、次の権限が必要です。

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テンプレートバージョン）を作成することを選択できます。

新しいNutanix AHV Prism Centralホスト接続を作成する: 移行する前に、ホスティングNutanix AHVクラスターをNutanix Prism Centralに登録し、ターゲットのNutanix Prism Centralインスタンスを指す新しいNutanix AHV Prism Centralホスト接続を確立します。この接続は、移行されたカタログの宛先として機能します。詳細については、「Nutanix AHV Prism Centralホスト接続」を参照してください。
既存のマシンカタログを移行する: 既存のマシンカタログの場合、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 内のホスティングユニットに与える名前です。
- -CreateMasterImageAtDestination パラメーターはオプションです。これは、ターゲットのPrism Central上にマスターイメージVMテンプレートバージョンを作成します。
移行の完了を確認する: 移行コマンドレットを実行した後、PowerShellウィンドウでタスクの状態を監視し、正常に完了したことを確認します。移行が完了すると、カタログはステップ1で作成されたターゲットホスト接続に移動されます。タスクタイプ SwitchProvCatalog で「完了」ステータスが表示されるはずです。移行の完了を確認するための推奨手順は次のとおりです。
- Studioでカタログのステータスを確認します。
- カタログ内のVMが、新しい宛先ハイパーバイザー接続に関連付けられていることを確認します。
- カタログ内のVMが正しい電源状態を表示していることを確認します。
- マシンの追加または削除、あるいは電源操作を実行して、移行されたマシンカタログの機能をテストし、カタログが正しく機能していることを確認します。

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

この操作により、マシンカタログとそのVMが元のソースホスト接続に復元されます。移行プロセス中に作成したリソースはすべて削除されます。

重要:

移行後にカタログを変更しておらず、ソースリソースのクリーンアップ操作を実行していない場合にのみ、ロールバックを実行します。元のソース接続は変更されず、引き続きベースディスクが含まれています。

c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback
<!--NeedCopy-->

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

移行が成功した後、この操作により、元のハイパーバイザー接続からソースリソース（ベースディスクなど）が削除されます。

重要:

このコマンドを実行すると、移行状態がクリアされます。これにより、その後のロールバックは不可能になります。

c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources
<!--NeedCopy-->

続行する前に確認プロンプトが表示されます。この操作は元に戻せないためです。クリーンアップを完了するには、プロンプトを承認してください。

詳細情報

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

この情報は役に立ちましたか?

Nutanixカタログの管理

September 3, 2026

寄稿者:

C C

September 3, 2026

寄稿者:

C C

この記事の概要

Studioの使用
PowerShellを使用する
マシンカタログをCitrix管理のNutanix AHV Prism Centralホスト接続に移行する
詳細情報

この情報は役に立ちましたか?