Citrix DaaS™

Microsoft Azureカタログを管理する

September 3, 2026

寄稿者:

C C

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

注：

Microsoft Azureカタログを管理する前に、Microsoft Azureカタログの作成を完了する必要があります。「Microsoft Azureカタログの作成」(/ja-jp/citrix-daas/install-configure/machine-catalogs-create/create-machine-catalog-citrix-azure.html)を参照してください。

VMがシャットダウンされたときにストレージタイプを下位層に変更する

VMをシャットダウンするときに、マネージドディスクのストレージタイプを下位層に切り替えることで、ストレージコストを節約できます。これを行うには、StorageTypeAtShutdownカスタムプロパティを使用します。

VMをシャットダウンすると、ディスクのストレージタイプは下位層（StorageTypeAtShutdownカスタムプロパティで指定）に変更されます。VMの電源をオンにすると、ストレージタイプは元の状態（StorageTypeカスタムプロパティまたはWBCDiskStorageTypeカスタムプロパティで指定）に戻ります。

重要：

ディスクは、VMの電源が少なくとも一度オンになるまで存在しません。したがって、VMの電源を初めてオンにするときにストレージタイプを変更することはできません。

ストレージタイプを下位層に変更した後、VMの起動に少し時間がかかる場合があります。

要件

マネージドディスクに適用されます。これは、カスタムプロパティUseManagedDisksをtrueに設定することを意味します。
永続OSディスクを持つ永続および非永続カタログに適用されます。これは、カスタムプロパティpersistOsDiskをtrueに設定することを意味します。
永続WBCディスクを持つ非永続カタログに適用されます。これは、カスタムプロパティpersistWBCをtrueに設定することを意味します。

制限

Microsoftによると、ディスクの種類は1日2回しか変更できません。Microsoftのドキュメントを参照してください。Citrixによると、VMの起動または割り当て解除アクションがあるたびにStorageTypeの更新が行われます。したがって、VMあたりの電源操作の回数を1日2回に制限してください。たとえば、午前中にVMを起動するための電源操作を1回、夕方にVMを割り当て解除するための電源操作を1回行います。

ストレージの種類を下位層に変更する

手順に進む前に、要件と制限を参照してください。

カスタムプロパティStorageTypeAtShutdownを追加し、値をStandard_LRS (HDD)に設定して、New-ProvSchemeを使用してカタログを作成します。

注：

StorageTypeAtShutdownが空またはStandard_LRS (HDD)以外の値を持つ場合、操作は失敗します。

永続カタログの作成中にカスタムプロパティを設定する例：

$customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS“ />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>’
<!--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="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
<Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>’
<!--NeedCopy-->

注：

マシンプロファイルを使用する場合、カスタムプロパティはMachineProfileで定義されたプロパティよりも優先されます。

VMをシャットダウンし、AzureポータルでVMのストレージの種類を確認します。ディスクのストレージの種類は、StorageTypeAtShutdownカスタムプロパティで指定された下位層に変更されます。
VMをオンにします。ディスクのストレージの種類は、以下に記載されているストレージの種類に戻ります。
- OSディスクのStorageTypeカスタムプロパティ
- CustomPropertiesで指定した場合にのみ、WBCディスクのWBCDiskStorageTypeカスタムプロパティ。それ以外の場合は、StorageTypeに記載されているストレージの種類に戻ります。

既存のカタログに`StorageTypeAtShutdown`を適用する

手順に進む前に、要件と制限事項を参照してください。

既存のカタログに追加された新しいVMにStorageTypeAtShutdownを適用するには、Set-ProvSchemeを使用します。

既存のカタログにVMを追加する際にカスタムプロパティを設定する例:

$customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
<Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>’

$ProvScheme = Get-Provscheme -ProvisioningSchemeName $CatalogName

Set-ProvScheme -ProvisioningSchemeName $ProvScheme.ProvisioningSchemeName -CustomProperties $customProperties
<!--NeedCopy-->

既存のVMのストレージタイプをシャットダウン時に下位層に変更する

手順に進む前に、要件と制限事項を参照してください。

VMがシャットダウンされたときに、既存のVMのストレージタイプを下位層に変更することで、ストレージコストを節約できます。

VMがシャットダウンされたときに、カタログ内の既存のマシンのストレージタイプを下位層に変更するには:

PowerShellウィンドウを開きます。
Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。
Get-Provscheme -ProvisioningSchemeName $CatalogNameを実行します。

カスタムプロパティ文字列を変更します。

$customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>'
<!--NeedCopy-->

既存のカタログのプロビジョニングスキームを更新します。この更新は、Set-ProvSchemeの実行後に追加された新しいVMに適用されます。
```
Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties

```

既存のVMを更新してStorageTypeAtShutdownを有効にします。

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

次回マシンを起動すると、マシンのStorageTypeAtShutdownプロパティが更新されます。ストレージタイプは次回のシャットダウン時に変更されます。

カタログ内の各VMのStorageTypeAtShutdown値を表示するには、次のコマンドを実行します。

Get-ProvVM -ProvisioningSchemeName <catalog-name> | foreach { $vmName = $_.VMName; $storageTypeAtShutdown = ($_.CustomVmData | ConvertFrom-Json).StorageTypeAtShutdown.DiskStorageAccountType; return New-Object psobject -Property @{ "VMName" = $vmName; "StorageTypeAtShutdown" = $storageTypeAtShutdown } }
<!--NeedCopy-->

AzureのレガシーMCSカタログをマシンプロファイルベースのカタログに変換する

マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換するには、次の手順を実行します。

マシンカタログページで、変換するマシンカタログ名を右クリックし、マシンカタログの編集を選択します。
マシンカタログの編集 > マシンプロファイルページで、マシンプロファイルを使用する (Microsoft Entra ID に必須) チェックボックスをオンにします。
マシンプロファイルの選択をクリックします。
マシンプロファイルの選択ページで、マシンプロファイルとして使用する仮想マシンまたは起動テンプレートを選択します。
現在の一部の設定が新しいマシンプロファイルの設定と異なる場合は、使用する設定に必要なオプションを選択し、続行をクリックします。
適用をクリックします。

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

Set-ProvSchemeコマンドはプロビジョニングスキームを変更します。ただし、既存のマシンには影響しません。PowerShellコマンドSet-ProvVMUpdateTimeWindowを使用して、既存の永続マシンまたは非永続マシン、あるいはマシンセットに現在のプロビジョニングスキームを適用できます。既存のMCSプロビジョニング済みマシンの構成更新のタイムスロットをスケジュールすることもできます。スケジュールされたタイムスロット中の電源オンまたは再起動により、スケジュールされたプロビジョニングスキームの更新がマシンに適用されます。現在、Azureでは、ServiceOffering、MachineProfile、および次のカスタムプロパティを更新できます。

StorageType
WBCDiskStorageType
IdentityDiskStorageType
LicenseType
DedicatedHostGroupId
PersistWBC
PersistOsDisk
PersistVm
Zones

注:

Azure環境でマネージドディスクを使用するカタログの場合、StorageType、WBCDiskStorageType、およびIdentityDiskStorageTypeカスタムプロパティのみを更新できます。

Set-ProvVMUpdateTimeWindowを2回実行した場合、最新のコマンドが有効になります。

VMがSet-ProvVMUpdateTimeWindowで更新され、Zonesカスタムプロパティによって提供される現在の可用性ゾーンリストが、VMが現在使用しているゾーンを含まないように変更された場合、VMの永続ディスクは新しいゾーンにコピーされ、元のディスクは削除されます。たとえば、ゾーン3でプロビジョニングされ、Zonesカスタムプロパティが「1,2」に設定されて更新されたVMは、ゾーン1と2の間でマシンをバランスさせるために、どちらのゾーンのマシンが少ないかに応じて、VMとそのディスクをゾーン1または2のいずれかに移動します。

Zonesカスタムプロパティが完全にクリアされた場合（空の値に設定された場合）、VMのゾーンアフィニティは削除され、Azureは容量に基づいてVMを任意の可用性ゾーンに配置できるようになります。この場合、VMの永続ディスクは元のゾーンに残り、移動されません。

以下を更新できます。

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

プロビジョニングスキームに以下の変更を加えると、Azureの永続カタログの場合、VMインスタンスが再作成されます。

MachineProfileを変更する
LicenseType を削除
DedicatedHostGroupId を削除

注:

既存のマシンのOSディスクとそのすべてのデータはそのまま残り、新しいVMがそのディスクに接続されます。

既存のVMを更新する前に:

既存のマシンの構成を確認します。例:

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

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

マシンプロファイルの入力としてVMを使用する場合:

 Set-ProvScheme -ProvisioningSchemeName "my-catalog" -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<virtual-machine>.vm"
 <!--NeedCopy-->

マシンプロファイルの入力としてテンプレート仕様を使用する場合:

 Set-ProvScheme -ProvisioningSchemeName "my-catalog"
 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
 -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
 <!--NeedCopy-->

サービスオファリングのみを使用する場合:

 Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
 <!--NeedCopy-->

VMの現在のプロパティが現在のプロビジョニングスキームと一致するか、およびVMに保留中の更新アクションがあるかを確認します。例:
```
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion

```
特定のバージョンのマシンを見つけることもできます。例:
```
Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

```

既存のマシンに次回の再起動時に適用される更新を要求するには:

既存のマシンを更新し、次回の再起動時に更新が適用されるようにするには、次のコマンドを実行します。
- すべての既存のマシンを更新するには。例:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 
```
- 特定の仮想マシンのリストを更新する場合。例：
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 
```
- Get-ProvVM の出力に基づいてマシンを更新する場合。例：
```
 Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
 
```
注：
- StartsNow は、スケジュールされた開始時刻が現在の時刻であることを示します。
- 負の数（例：–1）の DurationInMinutes は、スケジュールの時間枠に上限がないことを示します。

更新がスケジュールされているマシンを検索します。例：

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

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

```

スケジュールされた時間枠内で次回起動時に最新のプロビジョニング設定に更新するようにVMをスケジュールするには：

次のコマンドを実行します。
- 開始時刻を現在時刻として更新をスケジュールするには：
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName vm1 -StartsNow -DurationInMinutes 120
 
```
- 週末に更新をスケジュールするには：
```
  Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1” -StartTimeInUTC “10/15/2022 9:00am” -DurationInMinutes (New –TimeSpan –Days 2).TotalMinutes
  
```
注：
- VMName はオプションです。指定しない場合、更新はカタログ全体に対してスケジュールされます。
- StartTimeInUTC の代わりに StartsNow を使用して、スケジュール開始時刻が現在時刻であることを示します。
- DurationInMinutes はオプションです。デフォルトは120分です。負の数（例：–1）は、スケジュールの時間枠に上限がないことを示します。

更新ステータスを確認します。

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

VM の電源を入れます。スケジュールされた時間枠の後にマシンの電源を入れた場合、構成の更新は適用されません。スケジュールされた時間枠内にマシンの電源を入れた場合、,
- マシンの電源がオフの場合、
  - マシンの電源を入れない場合、構成の更新は適用されません
  - マシンの電源を入れる場合、構成の更新が適用されます
- マシンの電源がオンの場合、
  - マシンを再起動しない場合、構成の更新は適用されません
  - マシンを再起動する場合、構成の更新が適用されます

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

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

Clear-ProvVMUpdateTimeWindow を実行します。例：
- 単一の VM に対してスケジュールされた構成の更新をキャンセルするには：
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 
```
- 複数の VM に対してスケジュールされた構成の更新をキャンセルするには：
```
  Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 
```

注：

VM は同じカタログのものである必要があります。

ディスク暗号化の変更

Azure仮想化環境でディスク暗号化を変更し、次の操作を実行できます。

New-ProvSchemeコマンドを使用して、マスターイメージのDESとは異なるディスク暗号化セット（DES）を持つMCSマシンカタログを作成します。例：

 $customProperties = @"
 <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <Property xsi:type="DiskEncryptionSetId" Name="Zones" Value="/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/testrsg/providers/Microsoft.Compute/diskEncryptionSets/test-diskEncryptionSet"/>
 </CustomProperties>
 "@
 New-ProvScheme -CleanOnBoot `
 -ProvisioningSchemeName $provisioningSchemeName `
 -HostingUnitName $hostingUnitName `
 -IdentityPoolName $identityPoolName `
 -InitialBatchSizeHint $numberOfVms `
 -masterImagePath $masterImagePath `
 -NetworkMapping $networkMapping `
 -CustomProperties $customProperties
 <!--NeedCopy-->

Set-ProvSchemeおよびSet-ProvVMUpdateTimeWindowコマンドを使用して、既存のMCSマシンカタログおよび既存のVMのディスク暗号化タイプを、あるDESキーから別のDESキーに変更します。VMを再起動すると、更新されたDESキーが表示されます。例：

 $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1" />
 </CustomProperties>'
 Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

以前CMEKが有効になっていなかったMCSマシンカタログとVMを、Set-ProvSchemeおよびSet-ProvVMUpdateTimeWindowコマンドを使用して、顧客管理の暗号化キー（CMEK）暗号化（DES）、ホストでのディスク暗号化、または二重暗号化を持つように更新します。さまざまな暗号化タイプについては、「Azure サーバー側暗号化」、「ホストでのAzureディスク暗号化」、および「マネージドディスクでの二重暗号化」を参照してください。

Set-ProvSchemeおよびSet-ProvVMUpdateTimeWindowコマンドを使用して、以前暗号化されていた既存のMCSマシンカタログとVMを非暗号化に更新します。例：

 $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
 </CustomProperties>'
 Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

プライベートエンドポイントでディスク暗号化を有効にします（ProxyHypervisorTrafficThroughConnectorで有効化されたホスト接続を使用したMCSマシンカタログ）。ProxyHypervisorTrafficThroughConnectorの詳細については、「Azure管理トラフィックのセキュアな環境を作成する」を参照してください。プライベートエンドポイントでディスク暗号化を有効にする方法については、「プライベートエンドポイントでディスク暗号化を有効にする」を参照してください。

プライベートエンドポイントでディスク暗号化を有効にする

Azureの制限により、現在、プライベートエンドポイントに対して顧客管理キーによるサーバー側暗号化を使用することはできません。ただし、既存のMCSマシンカタログとプライベートエンドポイントを持つVMをDESキーで暗号化するように更新することはできます。

プライベートエンドポイントを持つ既存のマシンカタログを更新する

プライベートエンドポイントを持つ既存のマシンカタログを更新する詳細な手順は次のとおりです。

ProxyHypervisorTrafficThroughConnectorを介してディスク暗号化なしでカタログを作成します。ProxyHypervisorTrafficThroughConnectorの詳細については、「Azure管理トラフィックのセキュアな環境を作成する」を参照してください。
Set-ProvSchemeを実行して、DiskEncryptionSetIdでカタログを更新します。

注：

DiskEcryptionSetIdはCustomPropertiesまたはMachineProfileを介して構成できます。CustomPropertiesとMachineProfileの両方で定義されている場合、CustomPropertiesで定義されているプロパティが適用されます。

CustomProperties を使用する場合の例:
```
$customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1"/>
</CustomProperties>'
Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties

```
MachineProfile を使用する場合の例: ディスク暗号化が有効になっている VM、またはディスク暗号化設定を含むテンプレート仕様を使用します:
```
Set-ProvScheme -ProvisioningSchemeName azure-catalog -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"

```
または、Studio を使用してマシンプロファイルを更新することもできます。

既存のカタログ VM を更新するには、Set-ProvVMUpdateTimeWindow を実行します。例:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

VM を再起動すると、Azure portal の VM のディスクで更新されたディスク暗号化を確認できます。
新しいカタログ VM を追加する前にディスク暗号化を解除するには、Set-ProvScheme を実行します。

注:

プライベートエンドポイントカタログを更新しているため、この手順が必要です。この手順を実行しないと、カタログに新しい VM を追加しようとしたときにエラーが発生します。

例:
```
$customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
</CustomProperties>'
Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties

```
カタログに新しい VM を追加します。

個々のカタログ VM を更新する

個々のカタログ VM を更新する詳細な手順は次のとおりです。

ProxyHypervisorTrafficThroughConnector を使用して、ディスク暗号化なしでカタログを作成します。ProxyHypervisorTrafficThroughConnector の詳細については、「Azure 管理トラフィックのセキュアな環境を作成する」を参照してください。

DiskEncryptionSetId を使用してカタログ VM を更新するには、Set-ProvVM を実行します。

注:

「DiskEcryptionSetId は CustomProperties または MachineProfile のいずれかを通じて構成できます。」.

「CustomProperties を使用する場合の例:」:

$customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1" />
</CustomProperties>'
Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -CustomProperties $customProperties
<!--NeedCopy-->

「MachineProfile を使用する場合の例:」:

Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"
<!--NeedCopy-->

「既存のカタログVMを更新するには、Set-ProvVMUpdateTimeWindow を実行します。例:」:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

「VMを再起動すると、AzureポータルでVMディスク上の更新されたディスク暗号化を確認できます。」.
「新しいVMをカタログに追加します。」.

「既存のカタログで一時ディスクをWBCディスクとして使用する」

「既存のMCSマシンカタログでは、Azure一時ディスクをライトバックキャッシュディスク (WBC) ディスクとして使用できます。既存のカタログとVMを更新するには、Set-ProvScheme PowerShellコマンドを使用します。」.

「前提条件」

「既存のカタログは、次の条件を満たしている必要があります。」:

「注:」:

「既存のカタログが以下の要件を満たしていない場合、WBCディスクは一時ディスク内に配置されません。」.

「MCSIOが有効になっている: カスタムプロパティ WriteBackCacheMemorySize、WriteBackCacheDiskSize、および UseWriteBackCache が有効になっています。」.
「エフェメラルOSディスクが有効になっていない。」.
「WBCは非永続的である: PersistWBC は false です。」.
UseTempDiskForWBC は null または false です。
一時ディスクのサイズは、（ライトバックキャッシュディスクサイズ + ページングファイル用の予約済み領域 + 1 GB のバッファースペース）の合計サイズよりも大きくする必要があります。

重要：

一時ディスクがあるサービスオファリングから一時ディスクがないサービスオファリングへの変更、またはその逆は許可されていません。

既存のカタログを更新する

既存のカタログを更新するには、次のコマンドを実行します。

既存のカタログで Set-ProvScheme を実行して、UseTempDiskForWBC を true に更新します。例：

Set-ProvScheme -ProvisioningSchemeName name -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"Standard_LRS`"/><Property xsi:type=`"StringProperty`" Name=`"UseManagedDisks`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"ManagedDisksPreview`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"PersistOsDisk`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"UseTempDiskForWBC`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"PersistWBC`" Value=`"False`"/></CustomProperties>"
<!--NeedCopy-->

新しいマシンをカタログに追加して電源を入れます。新しいVMには、一時ディスク内にWBCディスクがあります。

Azure VM、スナップショット、OSディスク、およびギャラリーイメージ定義の情報を取得する

OSディスクと種類、スナップショット、ギャラリーイメージ定義を含むAzure VMの情報を表示できます。この情報は、マシンカタログが割り当てられている場合、マスターイメージ上のリソースに対して表示されます。この機能を使用して、LinuxまたはWindowsイメージを表示および選択します。PowerShellプロパティ TemplateIsWindowsTemplate が AdditionDatafield パラメーターに追加されました。このフィールドには、Azure固有の情報（VMの種類、OSディスク、ギャラリーイメージ情報、OSの種類情報）が含まれています。TemplateIsWindowsTemplate を True に設定するとOSの種類がWindowsであることを示し、TemplateIsWindowsTemplate を False に設定するとOSの種類がLinuxであることを示します。

ヒント：

TemplateIsWindowsTemplate PowerShellプロパティによって表示される情報は、Azure APIから派生しています。場合によっては、このフィールドが空になることがあります。たとえば、データディスクからのスナップショットには TemplateIsWindowsTemplate フィールドが含まれていません。これは、スナップショットからOSの種類を取得できないためです。

たとえば、PowerShellを使用してWindows OSタイプの場合にAzure VM AdditionData パラメーターを True に設定します。

PS C:\Users\username> (get-item XDHyp:\HostingUnits\mynetwork\image.folder\username-dev-testing-rg.resourcegroup\username-dev-tsvda.vm).AdditionalData
Key Value
ServiceOfferingDescription Standard_B2ms
HardDiskSizeGB 127
ResourceGroupName FENGHUAJ-DEV-TESTING-RG
ServiceOfferingMemory 8192
ServiceOfferingCores 2
TemplateIsWindowsTemplate True
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SupportedMachineGenerations Gen1,Gen2
<!--NeedCopy-->

Azure VM、マネージドディスク、スナップショット、Azure VHD、およびARMテンプレートのリージョン名情報を取得する

Azure VM、マネージドディスク、スナップショット、Azure VHD、およびARMテンプレートのリージョン名情報を表示できます。この情報は、マシンカタログが割り当てられている場合、マスターイメージ上のリソースに対して表示されます。AdditionalData パラメーターを指定してPowerShellコマンドを実行すると、RegionName と呼ばれるPowerShellプロパティがリージョン名情報を表示します。

例えば、Azure で VM 情報を取得するには、次の PowerShell コマンドを使用します。

PS C:\Windows\system32> (get-item XDHyp:\HostingUnits\myAzureNetwork\image.folder\hu-dev-testing-rg.resourcegroup\hu-dev-tsvda.vm).AdditionalData
Key Value
HardDiskSizeGB 127
ResourceGroupName HU-DEV-TESTING-RG
RegionName East US
TemplateIsWindowsTemplate True
LicenseType
ServiceOfferingDescription Standard_B2ms
ServiceOfferingMemory 8192
ServiceOfferingCores 2
SupportedMachineGenerations Gen1,Gen2
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SecurityType
SecureBootEnabled
VTpmEnabled
<!--NeedCopy-->

MCS カタログのクローンを作成する

既存の永続的および非永続的 MCS カタログを複数のカタログに分割します。元のプロビジョニングスキームのクローンを作成することで、特定の VM サブセットに異なるカタログレベルのポリシーと構成を適用できます。この機能は、組織内の異なる機能ロール（財務や役員など）が、標準ユーザーと比較して異なるリソース構成（例えば、バックアップ制限）を必要とする場合に特に役立ちます。

使用例

管理者は大規模な VM カタログを管理しています。役員チームは、標準ポリシーで許可されているよりも多くのバックアップを必要とします。管理者は Copy-ProvScheme コマンドを使用して、既存のカタログプロビジョニングスキームを新しいカタログにクローンします。これにより、管理者は新しい役員カタログに専用のバックアップポリシーを適用しつつ、組織の他の部分には元の設定を維持できます。

適用範囲

Azure 環境
永続的および非永続的 MCS カタログ
MCS でプロビジョニングされた Citrix Provisioning カタログ

制限事項

プロビジョニングスキーム: プロビジョニングスキームの最新バージョンのみがコピーされます。
バックアップスケジュール: バックアップスケジュールは新しいカタログにコピーされません。新しいカタログには独自のバックアップスケジュールを設定する必要があります。
ID プール: ID 関連のオブジェクトはクローンされず、同じ ADAccountIdentityPool を使用して共有されたままになります。
デリバリーグループ: クローン作成プロセス中に、デリバリーグループの操作とユーザー割り当ては変更または関連付けられません。

重要な考慮事項

リソースグループ (ターゲットロケーション):
- TargetLocation (Azure リソースグループ) を提供しない場合:
  - Citrix 管理のリソースグループの場合、新しい Citrix 管理のリソースグループが作成されます。
  - BYO (Bring Your Own) リソースグループの場合、新しいプロビジョニングスキームのリソースは同じリソースグループに作成されます。
- TargetLocation を提供する場合:
  - リソースは、提供されたリソースグループに作成されます。
  - 指定されたリソースグループは、Azure にすでに存在している必要があります。
ベースディスクスナップショット: リソースグループの構成に関係なく、ベースディスクスナップショットのコピーは常に作成されます。

前提条件

既存のプロビジョニングスキーム (ソースカタログ) が利用可能である必要があります。
ターゲットロケーションを指定する場合、ターゲットの Azure リソースグループが存在している必要があります。

PowerShell を使用して構成する

PowerShell ウィンドウを開きます。
Copy-ProvScheme コマンドを、必要なパラメーターである SourceProvisioningSchemeName (または SourceProvisioningSchemeUid) と TargetProvisioningSchemeName を使用して実行します。

例 1: プロビジョニングスキームを名前でコピーする。

この例では、「Backup」という名前のスキームを「TestCopy」という名前の新しいスキームにコピーします。
```
Copy-ProvScheme -SourceProvisioningSchemeName Backup -TargetProvisioningSchemeName TestCopy

```
例2：Uidでプロビジョニングスキームを特定のリソースグループにコピーする

この例では、Uidを使用してスキームをコピーし、「TestRg」という名前のターゲットリソースグループを指定します。
```
Copy-ProvScheme -SourceProvisioningSchemeUid 771e205d-1ee5-4ad2-b044-ecf3d7f24ec7 -TargetProvisioningSchemeName TestCopy -TargetLocation TestRg

```

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

以下は、MCSがAzureプラットフォーム上のリソースに追加するタグです。表のタグは「key”:”value」として表されます。

リソース名	タグ
IDディスク	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
イメージ	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
NIC	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
OSディスク	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
準備用VM	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
公開スナップショット	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
リソースグループ	“CitrixResource” : “内部”
	CitrixSchemaVersion: 2.0
	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
ストレージアカウント	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
カタログ内のVM	“CitrixプロビジョニングスキームID” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”
WBCディスク	“CitrixプロビジョニングスキームID” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “内部”

注:

MCSによって作成されたリソースとして識別するためにCitrixResourceタグが追加されている場合、VMはCitrixインベントリに表示されません。タグを削除または名前変更することで、表示させることができます。

タグの削除

カタログまたはVMを作成すると、以下のリソースにタグが作成されます。

リソースグループ
仮想マシン
OSディスク
IDディスク
ネットワークインターフェイス
ストレージアカウント

CitrixデータベースからVMとマシンカタログを削除し、タグを削除できます。以下を使用できます。

マシンカタログから単一のVMまたはVMのリストからVMとタグを削除するには、ForgetVMパラメーターを指定したRemove-ProvVMを使用します。
Citrixデータベースからマシンカタログを削除し、マシンカタログ全体からタグを削除するには、ForgetVMパラメーターを指定したRemove-ProvSchemeを使用します。

この機能は、永続VMにのみ適用されます。

これを行うには：

PowerShellウィンドウを開きます。
Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。
CitrixデータベースからVMを削除し、VMからタグを削除するには、Remove-ProvVMを実行します。例：
```
Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM

```
Citrixデータベースからマシンカタログを削除し、マシンカタログからタグを削除するには、Remove-ProvSchemeを実行します。例：
```
Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM

```
注：

Remove-ProvSchemeでForgetVMパラメーターを使用すると、プロビジョニングスキームがBYORG（bring your own resource group）またはCitrix管理リソースグループのいずれかに存在する場合、MCSはベースディスクスナップショットを含むすべてのスナップショットを削除します。

詳細情報

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

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

Microsoft Azureカタログを管理する

September 3, 2026

寄稿者:

C C

September 3, 2026

寄稿者:

C C

この記事の概要

VMがシャットダウンされたときにストレージタイプを下位層に変更する
AzureのレガシーMCSカタログをマシンプロファイルベースのカタログに変換する
プロビジョニングされたマシンを現在のプロビジョニングスキームの状態に更新する
ディスク暗号化の変更
「既存のカタログで一時ディスクをWBCディスクとして使用する」
Azure VM、スナップショット、OSディスク、およびギャラリーイメージ定義の情報を取得する
Azure VM、マネージドディスク、スナップショット、Azure VHD、およびARMテンプレートのリージョン名情報を取得する
MCS カタログのクローンを作成する
MCSによって作成されたリソースを識別する
タグの削除
詳細情報

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

Microsoft Azureカタログを管理する

VMがシャットダウンされたときにストレージタイプを下位層に変更する

要件

制限

ストレージの種類を下位層に変更する

既存のカタログにStorageTypeAtShutdownを適用する

既存のVMのストレージタイプをシャットダウン時に下位層に変更する

AzureのレガシーMCSカタログをマシンプロファイルベースのカタログに変換する

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

ディスク暗号化の変更

プライベートエンドポイントでディスク暗号化を有効にする

プライベートエンドポイントを持つ既存のマシンカタログを更新する

個々のカタログ VM を更新する

「既存のカタログで一時ディスクをWBCディスクとして使用する」

「前提条件」

既存のカタログを更新する

Azure VM、スナップショット、OSディスク、およびギャラリーイメージ定義の情報を取得する

Azure VM、マネージドディスク、スナップショット、Azure VHD、およびARMテンプレートのリージョン名情報を取得する

MCS カタログのクローンを作成する

使用例

適用範囲

制限事項

重要な考慮事項

前提条件

PowerShell を使用して構成する

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

タグの削除

詳細情報

この記事の概要

既存のカタログに`StorageTypeAtShutdown`を適用する