製品ドキュメント

Citrix DaaS™

PDFを表示

VMwareカタログの管理

April 6, 2026

寄稿者:

C C

マシンカタログの管理では、マシンカタログを管理するウィザードについて説明します。以下の情報は、VMware仮想化環境に固有の詳細を説明します。

注：

VMwareカタログを管理する前に、VMwareカタログの作成を完了する必要があります。「VMwareカタログの作成」を参照してください。

プロビジョニング済みVMの現在のプロビジョニングスキーム状態への更新

Set-ProvScheme コマンドはプロビジョニングスキームを変更します。ただし、既存のVMには影響しません。PowerShellコマンド Set-ProvVMUpdateTimeWindow を使用すると、既存の永続的または非永続的VM、あるいはVMのセットに現在のプロビジョニングスキームを適用できます。この機能は、マシンプロファイルベースおよび非マシンプロファイルベースのマシンカタログに適用できます。
更新できる項目は次のとおりです。
VMCpuCount: プロビジョニングスキームプロパティ
VMMemoryMB: プロビジョニングスキームプロパティ
Folder ID: カスタムプロパティ
Subnet mapping: プロビジョニングスキームプロパティ
VMのハードウェアバージョン: マシンプロファイルベースのマシンカタログのみ
マシンプロファイル: マシンプロファイルベースのマシンカタログのみ

更新できる対象は次のとおりです。

-  単一のVM
-  特定のVMのリスト、またはプロビジョニングスキームIDに関連付けられているすべての既存VM
-  特定のVMのリスト、またはプロビジョニングスキーム名（マシンカタログ名）に関連付けられているすべての既存VM

既存VMの更新前

既存VMの構成を確認します。例：

Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
<!--NeedCopy-->

プロビジョニングスキームを更新します。例：

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

1. VMの現在のプロパティが現在のプロビジョニングスキームと一致するか、およびVMに保留中の更新アクションがあるかを確認します。例：

Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
-  <!--NeedCopy-->

特定のバージョンのVMを見つけることもできます。例：

Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

<!--NeedCopy-->

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

既存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 は、スケジュールの時間枠に上限がないことを示します。

更新がスケジュールされているVMを見つけます。例：

Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
<!--NeedCopy-->

VMを再起動します。次回の電源投入時に、プロパティの変更が既存のVMに適用されます。次のコマンドを使用して、更新されたステータスを確認できます。例：
```
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

```

構成更新のキャンセル

単一のVM、複数のVM、またはカタログ全体の構成更新をキャンセルすることもできます。構成更新をキャンセルするには：

Clear-ProvVMUpdateTimeWindow を実行します。例：
- 単一のVMに対してスケジュールされた構成更新をキャンセルする場合：
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 
```
- 複数のVMに対してスケジュールされた構成更新をキャンセルする場合：
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 
```
  注：
  
  VMは同じカタログのものである必要があります。

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

Set-ProvScheme コマンドのカスタムプロパティで FolderId を指定することにより、MCSマシンカタログのフォルダーIDを更新できます。フォルダーIDの更新後に作成されたVMは、この新しいフォルダーIDの下に作成されます。このプロパティが CustomProperties で指定されていない場合、VMはマスターイメージが配置されているフォルダーの下に作成されます。

マシンカタログのフォルダーIDを更新するには、次の手順を実行します。

Webブラウザーを開き、vSphere Web Client のURLを入力します。
資格情報を入力し、[ログイン] をクリックします。
vSphere Web Client でVM配置フォルダーを作成します。
PowerShellウィンドウを開きます。
Citrix固有のPowerShellモジュールをロードするには、asnp citrix®* を実行します。

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

Studioを使用して、マシンカタログにVMを追加します。
vSphere Web Clientで新しいVMを確認します。新しいVMは新しいフォルダーの下に作成されます。

PowerShellコマンドを使用したフォルダーIDの検索

PowerShellコマンド Get-HypConfigurationDataForItem を使用して、VMwareハイパーバイザー内の既存のフォルダーのフォルダーIDを見つけます。

VMwareハイパーバイザーのホスティング接続とリソースグループを作成します。次に、そのハイパーバイザー上のフォルダーのフォルダーIDを見つけるには、次の手順を実行します。

VMフォルダーツリーのルートへの XDHyp パスを決定します。例：
```
XDHyp:\Connections\VMwareConn\Datacenter.datacenter

```
Get-HypConfigurationDataForItem を使用してツリー構造を取得します。例：

```
Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
```

出力XMLからフォルダーIDを識別するには、次のコマンドを実行します。この例では、XML出力で ExampleFolder のフォルダーIDを探します。

 $result = Get-HypConfigurationDataForItem -LiteralPath XDHyp:\Connections\VMwareConn\Datacenter.datacenter
 $result.VmPlacementFolder
 <!--NeedCopy-->

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

vSphereでのフォルダーIDの検索

VMのフォルダーIDを見つけるには、任意のESXiまたはvCenterサーバーシステムでMOBにアクセスします。

Managed Object Browser（MOB）は、すべてのESX/ESXiおよびvCenterサーバーシステムに組み込まれているWebベースのサーバーアプリケーションです。このvSphereユーティリティを使用すると、VM、データストア、リソースプールなどのオブジェクトに関する詳細情報を表示できます。

Webブラウザーを開き、http://x.x.x.x/mob を入力します。ここで、x.x.x.xはvCenter ServerまたはESX/ESXiホストのIPアドレスです。例：https://10.60.4.70/mob。
MOBの [Home] ページで、プロパティ content の値をクリックします。
rootFolder の値をクリックします。
childEntity の値をクリックします。
vmFolder の値をクリックします。
childEntity の値にフォルダーIDを見つけることができます。

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”

詳細情報

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

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

VMwareカタログの管理

April 6, 2026

寄稿者:

C C

April 6, 2026

寄稿者:

C C

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