VMwareカタログを作成する

最終公開日 : Oct 24, 2026
(/ja-jp/citrix-daas/install-configure/machine-catalogs-create.html)では、マシンカタログを作成するウィザードについて説明しています。
注:
VMwareカタログを作成する前に、VMwareへの接続の作成を完了する必要があります。(/ja-jp/citrix-daas/install-configure/connections/connection-vmware-virtualization-environments.html)を参照してください。

マシンプロファイルを使用してマシンカタログを作成する

マシンプロファイルを使用してMCSマシンカタログを作成できます。マシンプロファイルの入力元はVMwareテンプレートです。マシンプロファイルは、VMwareテンプレートからハードウェアプロパティを取得し、カタログ内の新しくプロビジョニングされたVMに適用します。
注:
  • マスターイメージ入力(スナップショット)とマシンプロファイル入力(VMwareテンプレート)は、両方ともvTPMが有効であるか、両方ともvTPMが無効である必要があります。このルールは、New-ProvSchemeとSet-ProvSchemeの両方に適用されます。
  • マスターイメージでvTPMが有効になっている場合、VMwareテンプレートはマスターイメージと同じVMソースからのみ取得できます。
  • 暗号化されたストレージポリシーは、フルクローンのみをサポートします。
  • マシンプロファイルベースのカタログは、提供されたVMwareテンプレートを利用して、接続された仮想ディスクに依存するストレージコントローラー情報を収集します。テンプレートには、仮想マシンの仮想ディスクを構成するために使用されるストレージコントローラー情報を取得するために必要な仮想ディスクが含まれている必要があります。
カタログにVMをプロビジョニングできるようにするには、マシンプロファイル内のVMwareテンプレートがカタログのライフサイクル中に存在している必要があります。VMwareテンプレートがない場合、新しいVMをプロビジョニングすることはできません。VMwareテンプレートが削除された場合、Set-ProvSchemeコマンドを使用して新しいテンプレートを提供する必要があります。
  • MCSはVMwareテンプレートのプロパティをキャプチャします。Get-Provschemeコマンドを使用して、VMwareテンプレートの保存されたプロパティを参照する新しいVMwareテンプレートを作成できます。
  • あるいは、マシンカタログとプロビジョニングされたVMが存在する場合、MCSでプロビジョニングされたマシンを使用して新しいVMwareテンプレートを作成することもできます。
  • MCSIOが有効になっている場合、MCSカタログの作成後にメモリとディスクキャッシュのサイズを更新できます。
OSの種類に応じて、異なる構成でマシンカタログを作成できます。
  • マスターイメージにWindows 11がインストールされている場合、マスターイメージでvTPMを有効にすることが要件となります。したがって、マシンプロファイルのソースであるVMwareテンプレートには、vTPMがアタッチされている必要があります。
  • マスターイメージにvTPMがアタッチされていないWindows 10がインストールされている場合、非vTPM VMwareテンプレートをマシンプロファイルのソースとして使用してマシンカタログを作成できます。
暗号化されたストレージポリシーが適用されたマシンプロファイルテンプレートを使用して、フルコピーディスクモードでマシンカタログを作成できる別の構成があります。
マシンプロファイルをインプットとしてPowerShellコマンドを使用してマシンカタログを作成するには:
  1. PowerShellウィンドウを開きます。
  2. Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。
  3. 次のコマンドを実行します。
    • vTPMがアタッチされたVMwareテンプレートをマシンプロファイル入力のソースとして、Windows 11がインストールされたマスターイメージでマシンカタログを作成するには:
      $identityPool = New-AcctIdentityPool
      -IdentityPoolName "<string>"
      -NamingScheme "<string>-###"
      -NamingSchemeType Numeric
      -Domain "<domain name"
      -ZoneUid "<Uid>"  -Scope @()
      $provScheme =New-ProvScheme  -CleanOnBoot
      -HostingUnitName "vSanRg"
      -IdentityPoolName "<string>"
      -InitialBatchSizeHint 1
      -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot"
      -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<network name>.network"}
      -ProvisioningSchemeName "<string>"
      -Scope @() -VMCpuCount 4  -VMMemoryMB 6144
      -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template"
      -TenancyType Shared
      -FunctionalLevel "L7_20"
      $catalog = New-BrokerCatalog
      -AllocationType "Static"
      -PersistUserChanges  "OnLocal"
      -Description "<string>"  -IsRemotePC $False
      -MinimumFunctionalLevel 'L7_9' -Name "<catalog name>" -ProvisioningType 'MCS'
      -Scope @()  -SessionSupport "SingleSession"
      -ZoneUid "<Uid>"
      Set-BrokerCatalog -Name "<string>"
      -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid
    • 非vTPM VMwareテンプレートをマシンプロファイルのソースとして、Windows 10がインストールされたマスターイメージでマシンカタログを作成するには:
      $identityPool = New-AcctIdentityPool
      -IdentityPoolName "<string>"
      -NamingScheme "<string>-###"
      -NamingSchemeType Numeric
      -Domain "<domain name>"
      -ZoneUid "<Uid>"  -Scope @()
      $provScheme =New-ProvScheme  -CleanOnBoot
      -HostingUnitName "<string>"
      -IdentityPoolName "<string>"
      -InitialBatchSizeHint 1
      -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot"
      -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<string>.network"}
      -ProvisioningSchemeName "<string>"  -Scope @() -VMCpuCount 4  -VMMemoryMB 8192
      -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template"
      -TenancyType Shared  -FunctionalLevel "L7_20"
      $catalog = New-BrokerCatalog
      -AllocationType "Static"
      -PersistUserChanges  "OnLocal"  -Description "<string>"  -IsRemotePC $False
      -MinimumFunctionalLevel 'L7_9' -Name "<string>" -ProvisioningType 'MCS' -Scope @()  -SessionSupport "SingleSession" -ZoneUid "<Uid"
      Set-BrokerCatalog -Name "<string>"
      -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid
    • 暗号化されたストレージポリシーが適用されたマシンプロファイルテンプレートを使用して、フルコピーディスクモードでマシンカタログを作成するには:
      $identityPool = New-AcctIdentityPool
      -IdentityPoolName "<string>"
      -NamingScheme "<string>-###"
      -NamingSchemeType Numeric
      -Domain "<domain name>"
      -ZoneUid "<Uid>"  -Scope @()
      $provScheme =New-ProvScheme
      -HostingUnitName "<string>"
      -IdentityPoolName "<string>" -InitialBatchSizeHint 1
      -MasterImageVM "XDHyp:\HostingUnits\<hosting unit name>\<snapshot name>.snapshot"
      -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hosting unit name>\\<string>.network"}
      -ProvisioningSchemeName "<string>"  -Scope @() -VMCpuCount 4  -VMMemoryMB 8192
      -MachineProfile "XDHyp:\HostingUnits\<hosting unit name>\<template name>.template"
      -TenancyType Shared  -FunctionalLevel "L7_20"
      -UseFullDiskCloneProvisioning
      $catalog = New-BrokerCatalog
      -AllocationType "Static"
      -PersistUserChanges  "OnLocal"
      -Description "<string>"
      -IsRemotePC $False
      -MinimumFunctionalLevel 'L7_9' -Name "<string>" -ProvisioningType 'MCS' -Scope @()
      -SessionSupport "SingleSession" -ZoneUid "<Uid>"
      Set-BrokerCatalog -Name "<string>"
      -ProvisioningSchemeId $provScheme.ProvisioningSchemeUid.Guid
    • マシンプロファイルを更新するには、Set-ProvSchemeコマンドを使用します。例:
      Set-ProvScheme -ProvisioningSchemeName 'name' -IdentityPoolName 'name' -MachineProfile 'XDHyp:\HostingUnits\<hosting unit name>\<template name>.template

複数のNICを確認する

マシンプロファイルと、New-ProvSchemeおよびSet-ProvSchemeコマンドのNetworkMappingパラメーターを使用している場合、複数のNICの事前チェック中にさまざまなエラーメッセージが表示されます。
複数のNICの事前チェックリストは次のとおりです。
  • マシンプロファイルテンプレートからのNIC数のみが使用され、検証されます。これらのNICが指すネットワークは、ホスティングユニットネットワークに対して使用または検証されません。
  • マシンプロファイルテンプレートのNIC数がホスティングユニットのネットワーク数より多い場合、エラーメッセージが表示されます。
  • マシンプロファイルテンプレートのNIC数がゼロの場合、エラーメッセージが表示されます。 マシンプロファイルテンプレートのNIC数が1の場合:
    • New-ProvSchemeまたはSet-ProvSchemeコマンドでネットワークマッピングが指定されておらず、ホスティングユニットネットワークが1つの場合、そのホスティングユニットネットワークが使用されます。
    • ネットワークマッピングが指定されている場合、それが有効であれば指定されたネットワークマッピングが使用されます。
  • マシンプロファイルテンプレートのNIC数が1より大きい場合、またはホスティングユニットのネットワーク数が1より大きい場合:
    • コマンドには有効なネットワークマッピングが必要であり、各NICのマッピングを提供する必要があります(つまり、NetworkMappingの数はマシンプロファイルのNIC数と同じでなければなりません)。
    • 複数のNICをホスティングユニット内の同じネットワークにマッピングすることはできません。
    • NetworkMappingの数とマシンプロファイルのNIC数は、ホスティングユニットのネットワーク数以下でなければなりません。
    • NetworkMappingは、0からn-1までの各IDに対して提供される必要があります。ここでnはマシンプロファイルテンプレート内のネットワークアダプターの数です。

MCSで作成されたVMにデータディスクをプロビジョニングする

データディスクは、イベントログ、セキュリティトレース、アプリケーションデータなどの永続的なデータの保存を可能にします。VMwareのMCSマシンカタログで、MCSによって作成された永続的または非永続的なVMに、永続的または非永続的なデータディスクを作成して割り当てることができます。
マスターイメージからデータディスクをプロビジョニングします。準備されたマスターイメージのデータディスクは、<Prov Scheme Name>-dataDisk-<datastoreId>フォルダーに保存されます。
マシンプロファイルベースと非マシンプロファイルベースの両方のMCSカタログを作成できます。マシンプロファイルベースのMCSカタログの場合、マシンプロファイルのデータディスクソースとして同じマスターイメージVMを使用できます。
プロビジョニングされたVMのデータディスクは、ストレージポリシーやサイズなどのプロパティをマスターイメージから継承します。マシンプロファイルベースのカタログの場合、オプションでVMテンプレートのデータディスクを使用してプロパティを継承できます。VMテンプレートにデータディスクがない場合、ストレージのデフォルトポリシーが使用されます。
プロビジョニングされたVMのデータディスクは、OSディスクおよびIDディスクと同じディレクトリに作成されます。

サポートされているデータディスクのシナリオ

以下は、サポートされているOSディスクとデータディスクのシナリオです。
  • 永続OSディスクと永続データディスク
  • 非永続OSディスクと永続データディスク
  • 非永続OSディスクと非永続データディスク
注:
永続マシンカタログは、非永続データディスクを持つことはできません。

制限事項

次の操作は現在サポートされていません。
  • 複数のデータディスクのプロビジョニング。
  • データディスクのリセット。
  • データディスクを持つMCSカタログをデータディスクを持たないMCSカタログに更新すること。同様に、データディスクを持たないMCSカタログをデータディスクを持つMCSカタログに更新すること。

主要な手順

  1. VMwareでデータディスクを持つマスターイメージVMを作成する。マシンプロファイルベースのMCSカタログの場合、マシンプロファイルのデータディスクソースとして同じマスターイメージVMを使用できます。
  2. データディスクがプロビジョニングされたVMを使用してMCSマシンカタログをNew-ProvScheme PowerShellコマンドで作成します。データディスクがプロビジョニングされたVMでカタログを作成するを参照してください。
  3. New-ProvVM PowerShellコマンドを使用して、カタログにVMを追加します。
  4. VMにログインして、データディスクが正しくフォーマットされているか確認します。マスターイメージVMで参照されているデータディスクにコンテンツがある場合、そのコンテンツもデータディスク上にあります。

VMwareでデータディスクを持つマスターイメージVMを作成する

  1. 2つのハードディスクを持つVMを作成します。1つはOSディスクで、もう1つはデータディスクです。既存のVMに新しいハードディスク(データディスク)を追加するには、このガイドに従ってください。
  2. VMにログインして、ディスクを初期化し、目的のドライブ文字を設定し、コンテンツを追加します。

データディスクがプロビジョニングされたVMでカタログを作成する

データディスクを持つMCSマシンカタログをプロビジョニングするには、New-ProvScheme PowerShellコマンドに以下のパラメーターを含めます。
  • DataDisk: 指定されたデータディスクのパスを指定します。
  • DataDiskPersistence: データディスクが永続的か非永続的かを示します。
    CleanOnBootがfalseの場合、データディスクを非永続にすることはできません。一度構成されたマシンカタログのDataDiskPersistenceの値を変更することはできません。
カタログを作成した後、New-ProvVMコマンドを使用してVMを追加します。

イメージの更新

OSおよびデータディスクのソースを更新するには、Publish-ProvMasterVMImageコマンドを実行します。Publish-ProvMasterVMImageコマンドを実行した後:
  • 新しいVMは、更新されたOSディスクとデータディスクで作成されます。
  • 既存のVMの非永続ディスクは、次回の電源サイクルで更新されます。
  • 既存のVMの永続ディスクは、次回の電源サイクルでは更新されません。

データディスクを削除する

カタログを削除すると、forgetVM または purgeDBOnly オプションを使用しない限り、データディスクは削除されます。VMを削除すると、forgetVM または purgeDBOnly オプションを使用しない限り、データディスクは削除されます。これらの条件は、永続的なMCSマシンカタログにのみ適用されます。

トラブルシューティング

カタログの作成に失敗した場合は、CTX294978 を参照してください。

次のステップ

詳細情報