VMwareカタログを管理する

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

プロビジョニングされたVMを現在のプロビジョニングスキームの状態に更新する

Set-ProvSchemeコマンドはプロビジョニングスキームを変更します。ただし、既存のVMには影響しません。PowerShellコマンドSet-ProvVMUpdateTimeWindowを使用すると、現在のプロビジョニングスキームを既存の永続的または非永続的なVMまたはVMセットに適用できます。この機能は、マシンプロファイルベースおよび非マシンプロファイルベースのマシンカタログに適用できます。
以下を更新できます。
  • VMCpuCount: プロビジョニングスキームのプロパティ
  • VMMemoryMB: プロビジョニングスキームのプロパティ
  • フォルダーID: カスタムプロパティ
  • サブネットマッピング: プロビジョニングスキームのプロパティ
  • VMのハードウェアバージョン: マシンプロファイルベースのマシンカタログのみ
  • マシンプロファイル: マシンプロファイルベースのマシンカタログのみ
更新できるもの：
  • 単一のVM
  • プロビジョニングスキームIDに関連付けられている特定のVMのリスト、または既存のすべてのVM
  • プロビジョニングスキーム名（マシンカタログ名）に関連付けられている特定のVMのリスト、または既存のすべてのVM

既存のVMを更新する前に

  1. 既存のVMの構成を確認します。例：
    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
  2. プロビジョニングスキームを更新します。例：
    $customProperties=<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><Property xsi:type="StringProperty" Name="FolderId" Value="FOLDER_ID"/></CustomProperties>
    $memoryMb=<DOUBLE THE "UPDATE" MACHINE PROFILE>
    Set-ProvScheme -ProvisioningSchemeName my-catalog -VMCpuCount 4 -VmMemoryMb $memoryMb -CustomProperties $customerProperties -NetworkMapping @{"1" = "<A_NETWORK_PATH_FROM_THE_HOSTING_UNIT>"} -MachineProfile "<PATH_TO_UPDATE_MACHINE_PROFILE>"
  3. VMの現在のプロパティが現在のプロビジョニングスキームと一致するか、およびVMに保留中の更新アクションがあるかを確認します。例：
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
    特定のバージョンを持つVMを見つけることもできます。例：
    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

次回再起動時に適用されるように、既存のVMの更新を要求する

  1. 既存のVMを更新し、次回再起動時に更新が適用されるようにするには、次のコマンドを実行します。
    • 既存のすべてのVMを更新するには。例：
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    • 特定のVMのリストを更新するには。例：
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
    • Get-ProvVMの出力に基づいてVMを更新するには。例：
      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    注：
    • StartsNowは、スケジュールされた開始時刻が現在の時刻であることを示します。
    • 負の数（例：–1）を持つDurationInMinutesは、スケジュールの時間枠に上限がないことを示します。
  2. 更新がスケジュールされているVMを見つけます。例:
    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
  3. VMを再起動します。次回の電源投入時に、プロパティの変更が既存のVMに適用されます。以下のコマンドを使用して、更新されたステータスを確認できます。例:
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

構成の更新をキャンセルする

単一のVM、複数のVM、またはカタログ全体の構成更新をキャンセルすることもできます。構成更新をキャンセルするには:
  1. Clear-ProvVMUpdateTimeWindowを実行します。例:
    • 単一のVMにスケジュールされている構成更新をキャンセルするには:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
    • 複数のVMにスケジュールされている構成更新をキャンセルするには:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
      注:
      VMは同じカタログのものである必要があります。

マシンカタログのフォルダーIDを更新する

MCSマシンカタログのフォルダーIDは、Set-ProvSchemeコマンドのカスタムプロパティでFolderIdを指定することで更新できます。フォルダーIDの更新後に作成されるVMは、この新しいフォルダーIDの下に作成されます。このプロパティがCustomPropertiesで指定されていない場合、VMはマスターイメージが配置されているフォルダーの下に作成されます。
マシンカタログのフォルダーIDを更新するには、次の手順を実行します。
  1. Webブラウザーを開き、vSphere Web ClientのURLを入力します。
  2. 資格情報を入力し、Loginをクリックします。
  3. vSphere Web ClientでVM配置フォルダーを作成します。
  4. PowerShellウィンドウを開きます。
  5. Citrix固有のPowerShellモジュールをロードするには、asnp citrix®*を実行します。
  6. Set-ProvSchemeのCustomPropertiesでFolderIDを指定します。この例では、フォルダーIDの値はgroup-v2406です。
    Set-ProvScheme -ProvisioningSchemeUid "50bb319c-2e83-4a37-9ea1-94f630687372" -CustomProperties "<CustomProperties xmlns=""http://schemas.citrix.com/2014/xd/machinecreation"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""><Property xsi:type=""StringProperty"" Name=""FolderId"" Value=""group-v2406"" /></CustomProperties>"
  7. Studioを使用して、マシンカタログにVMを追加します。
  8. vSphere Web Clientで新しいVMを確認します。新しいVMは新しいフォルダーの下に作成されます。

PowerShellコマンドを使用してフォルダーIDを検索する

PowerShellコマンドGet-HypConfigurationDataForItemを使用して、VMwareハイパーバイザー内の既存のフォルダーのフォルダーIDを検索します。
VMwareハイパーバイザーのホスティング接続とリソースグループを作成します。次に、以下の手順を実行して、そのハイパーバイザー上のフォルダーのフォルダーIDを検索します。
  1. VMフォルダーツリーのルートへのXDHypパスを決定します。例：
    XDHyp:\Connections\VMwareConn\Datacenter.datacenter
  2. Get-HypConfigurationDataForItemを使用してツリー構造を取得します。例：
    Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
  3. 出力XMLからフォルダーIDを特定するために、次のコマンドを実行します。この例では、XML出力でExampleFolderのフォルダーIDを探します。
    $result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
    $result.VmPlacementFolder
    XML出力：
    <?xml version="1.0" encoding="utf-16"?>
    <CtxVmPlacementFolder xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Name>vm</Name>
    <Id>group-v4</Id>
    <SubFolder>
    <CtxVmPlacementFolder>
      <Name>vCLS</Name>
      <Id>group-v75</Id>
      <SubFolder />
    </CtxVmPlacementFolder>
    <CtxVmPlacementFolder>
      <Name>MyOtherFolder</Name>
      <Id>group-v1110</Id>
      <SubFolder />
    </CtxVmPlacementFolder>
    <CtxVmPlacementFolder>
      <Name>ExampleFolder</Name>
      <Id>group-v4658</Id>
      <SubFolder />
    </CtxVmPlacementFolder>
    </SubFolder>
    </CtxVmPlacementFolder>

vSphereでフォルダーIDを検索する

任意のESXiまたはvCenterサーバーシステムでMOBにアクセスして、VMのフォルダーIDを検索します。
マネージドオブジェクトブラウザ (MOB) は、すべてのESX/ESXiおよびvCenterサーバーシステムに組み込まれているWebベースのサーバーアプリケーションです。このvSphereユーティリティを使用すると、VM、データストア、リソースプールなどのオブジェクトに関する詳細情報を表示できます。
  1. Webブラウザを開き、http://x.x.x.x/mobと入力します。ここで、x.x.x.xはvCenter ServerまたはESX/ESXiホストのIPアドレスです。例: <https://10.60.4.70/mob>。
  2. MOBのHomeページで、プロパティcontentの値をクリックします。
  3. rootFolderの値をクリックします。
  4. childEntityの値をクリックします。
  5. vmFolderの値をクリックします。
  6. フォルダーIDはchildEntityの値にあります。

MCSによって作成されたリソースを特定する

以下は、MCSがVMwareプラットフォーム上のリソースに追加するタグです。表のタグは「"key":"value"」として表されます。
リソース名 タグ
準備VM "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"
カタログ内のVM "CitrixProvisioningSchemeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"XdConfig:"XdProvisioned=True"

詳細情報

  • 接続とリソースの作成および管理(/ja-jp/citrix-daas/install-configure/connections.html)
  • VMwareへの接続(/ja-jp/citrix-daas/install-configure/connections/connection-vmware-virtualization-environments.html)
  • マシンカタログの作成(/ja-jp/citrix-daas/install-configure/machine-catalogs-create.html)
  • VMwareカタログの作成(/ja-jp/citrix-daas/install-configure/machine-catalogs-create/create-machine-catalog-vmware.html)
  • マシンカタログの管理(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html)