Citrix DaaS

Microsoft Azureカタログの管理

September 15, 2025

寄稿者:

C C

注

2023年7月より、MicrosoftはAzure Active Directory（Azure AD）の名前をMicrosoft Entra IDに変更しました。このドキュメントでは、Azure Active Directory、Azure AD、またはAADへの言及はすべて、Microsoft Entra IDを意味することになります。

「マシンカタログの管理」では、マシンカタログを管理するウィザードについて説明します。以下の情報は、Microsoft Azure Resource Managerクラウド環境に固有の詳細について説明しています。

注

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

仮想マシンのシャットダウン時にストレージの種類をダウングレードする

仮想マシンのシャットダウン時に管理対象ディスクのストレージの種類をダウングレードすると、ストレージコストを節約できます。これを行うには、カスタムプロパティのStorageTypeAtShutdownを使用します。

仮想マシンをシャットダウンすると、ディスクのストレージの種類が（カスタムプロパティStorageTypeAtShutdownで指定されたものに）ダウングレードされます。仮想マシンの電源をオンにすると、ストレージの種類が（カスタムプロパティStorageTypeまたはカスタムプロパティWBCDiskStorageTypeで指定されている）元に戻ります。

重要:

ディスクは、仮想マシンの電源を少なくとも1回オンにするまで存在しません。このため、仮想マシンの初回電源投入時にストレージの種類を変更することはできません。

ストレージの種類をダウングレードすると、VMの起動にかかる時間が少し長くなる場合があります。

要件

管理対象ディスクに適用できます。これは、カスタムプロパティ< UseManagedDisksをtrueに設定することを意味します。
永続OSディスクがある永続カタログおよび非永続カタログに適用できます。これは、カスタムプロパティpersistOsDiskをtrueに設定することを意味します。
永続WBCディスクがある非永続カタログに適用できます。これは、カスタムプロパティpersistWBCをtrueに設定することを意味します。

制限事項

Microsoftによると、ディスクの種類を変更できるのは1日に2回のみです。 Microsoftドキュメントを参照してください。 Citrixに関しては、StorageTypeの更新はVMの開始または割り当て解除操作があるたびに行われます。したがって、VMごとの電源操作の数を1日あたり2回に制限します。たとえば、朝に1回の電源操作でVMを起動し、夕方にもう1回の電源操作でVMの割り当てを解除します。

ストレージの種類をダウングレードするには

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

カスタムプロパティ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で定義されたプロパティよりも優先されます。

仮想マシンをシャットダウンし、Azure Portalで仮想マシンのストレージの種類を確認します。ディスクのストレージの種類がカスタムプロパティStorageTypeAtShutdownで指定されたものにダウングレードされます。
仮想マシンの電源を入れます。ディスクのストレージの種類は、以下に記載されているストレージの種類に切り替わります：
- OSディスクのカスタムプロパティStorageType
- WBCディスクのカスタムプロパティWBCDiskStorageTypeはCustomPropertiesで指定している場合のみです。それ以外の場合は、StorageTypeに記載されているストレージの種類に切り替わります。

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

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

Set-ProvSchemeを使用して、既存のカタログに追加された新しい仮想マシンにStorageTypeAtShutdownを適用します。

仮想マシンを既存のカタログに追加するときにカスタムプロパティを設定する例：

  $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ウィンドウを開きます。
asnp citrix*を実行し、Citrix固有のPowerShellモジュールをロードします。
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の実行後に追加された新しい仮想マシンに適用されます。
```
  Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties

```

既存の仮想マシンを更新して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カタログをマシンプロファイルベースのカタログに変換

非マシンプロファイルベースのマシンカタログをマシンプロファイルベースのマシンカタログに変換するには、次の手順を完了します：

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

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

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

StorageType
WBCDiskStorageType
IdentityDiskStorageType
LicenseType
DedicatedHostGroupId
PersistWBC
PersistOsDisk
PersistVm

注

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

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

以下を更新できます：

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

プロビジョニングスキームに次の変更を加えた後、Azureの永続カタログのVMインスタンスが再作成されます：

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

注

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

既存の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のディスク暗号化の種類を1つの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-->

Set-ProvSchemeおよびSet-ProvVMUpdateTimeWindowコマンドを使用して、以前に顧客管理の暗号化キー（CMEK）が有効になっていなかったMCSマシンカタログとVMを更新し、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
<!--NeedCopy-->

MachineProfileを使用する場合の例：ディスク暗号化が有効になっているVMか、ディスク暗号化設定を含むテンプレートスペックを使用します：

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

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

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管理トラフィックのための安全な環境の作成」を参照してください。

Set-ProvVMを実行してカタログVMをDiskEncryptionSetIdで更新します。

注

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

Set-ProvVMUpdateTimeWindowを実行して、既存のカタログ仮想マシンを更新します。次に例を示します：

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

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

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

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

前提条件

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

注

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

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

重要:

サービスオファリングを一時ディスクのあるものからないものに変更したり、その逆を行ったりすることはできません。

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

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

既存のカタログで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であることを示します。

ヒント：

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

たとえば、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仮想マシン、管理対象ディスク、スナップショット、Azure VHD、およびARMテンプレートのリージョン名情報を取得

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

たとえば、次のPowerShellコマンドを使用して、Azureの仮想マシン情報を取得します。

  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がAzureプラットフォームのリソースに追加するタグです。表のタグは、「”キー”:”値”」として表示されます。

リソース名	タグ
IDディスク	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
イメージ	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
NIC	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
OSディスク	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
準備用の仮想マシン	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
公開されたスナップショット	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
リソースグループ	“CitrixResource” : “Internal”
	CitrixSchemaVersion: 2.0
	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
ストレージアカウント	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
カタログ内のVM	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
WBCディスク	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”

注

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

タグの削除

カタログまたは仮想マシンを作成すると、次のリソースにタグが作成されます：

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

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

Remove-ProvVMをForgetVMパラメーターとともに使用して、マシンカタログの単一の仮想マシンまたは仮想マシンの一覧から仮想マシンとタグを削除します。
Remove-ProvSchemeをForgetVMパラメーターとともに使用して、Citrixデータベースから単一のマシンカタログを削除し、マシンカタログ全体からタグを削除します。

この機能は、永続的な仮想マシンにのみ適用されます。

これを行うには、以下の手順を実行します：

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

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

```
注

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

追加情報

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

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

Microsoft Azureカタログの管理

September 15, 2025

寄稿者:

C C

September 15, 2025

寄稿者:

C C

この記事の概要

仮想マシンのシャットダウン時にストレージの種類をダウングレードする
Azureで従来のMCSカタログをマシンプロファイルベースのカタログに変換
プロビジョニングされたマシンを現在のプロビジョニングスキームの状態に更新する
ディスク暗号化を変更する
一時ディスクを既存のカタログのWBCディスクとして使用する
Azure VM、スナップショット、OSディスク、およびギャラリーイメージ定義の情報の取得
Azure仮想マシン、管理対象ディスク、スナップショット、Azure VHD、およびARMテンプレートのリージョン名情報を取得
MCSによって作成されたリソースの特定
タグの削除
追加情報

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

Microsoft Azureカタログの管理

仮想マシンのシャットダウン時にストレージの種類をダウングレードする

要件

制限事項

ストレージの種類をダウングレードするには

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

シャットダウン時に既存のVMのストレージの種類を下位レベルに変更する

Azureで従来のMCSカタログをマシンプロファイルベースのカタログに変換

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

ディスク暗号化を変更する

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

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

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

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

前提条件

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

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

Azure仮想マシン、管理対象ディスク、スナップショット、Azure VHD、およびARMテンプレートのリージョン名情報を取得

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

タグの削除

追加情報

この記事の概要

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