Microsoft Azureカタログを管理する

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

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回実行します。

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

手順を進める前に、要件と制限事項を参照してください。
  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>’
    非永続カタログの作成中にカスタムプロパティを設定する例:
    $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>’
    注:
    マシンプロファイルを使用する場合、カスタムプロパティはMachineProfileで定義されたプロパティよりも優先されます。
  2. VMをシャットダウンし、AzureポータルでVMのストレージの種類を確認します。ディスクのストレージの種類は、StorageTypeAtShutdownカスタムプロパティで指定された下位層に変更されます。
  3. VMをオンにします。ディスクのストレージの種類は、以下に記載されているストレージの種類に戻ります。
    • OSディスクのStorageTypeカスタムプロパティ
    • WBCディスクのWBCDiskStorageTypeカスタムプロパティ(CustomPropertiesで指定した場合のみ)。それ以外の場合は、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

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

手順を進める前に、要件と制限事項を参照してください。
VMのシャットダウン時に既存のVMのストレージタイプを下位層に変更することで、ストレージコストを節約できます。
VMのシャットダウン時に、カタログ内の既存マシンのストレージタイプを下位層に変更するには:
  1. PowerShellウィンドウを開きます。
  2. Citrix固有のPowerShellモジュールをロードするために、asnp citrix*を実行します。
  3. Get-Provscheme -ProvisioningSchemeName $CatalogNameを実行します。
  4. カスタムプロパティ文字列を変更します。
    $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>'
  5. 既存のカタログのプロビジョニングスキームを更新します。この更新は、Set-ProvSchemeの実行後に追加された新しいVMに適用されます。
    Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties
  6. 既存のVMを更新してStorageTypeAtShutdownを有効にします。
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
  7. 次回マシンを起動すると、マシンのStorageTypeAtShutdownプロパティが更新されます。ストレージタイプは次回のシャットダウン時に変更されます。
  8. カタログ内の各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 } }

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

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

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

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
  • 特定のVMのリスト、またはプロビジョニングスキームIDに関連付けられている既存のすべてのVM
  • 特定のVMのリスト、またはプロビジョニングスキーム名(マシンカタログ名)に関連付けられている既存のすべてのVM
プロビジョニングスキームに以下の変更を加えると、Azureの永続カタログの場合、VMインスタンスが再作成されます:
  • MachineProfileを変更する
  • 削除 LicenseType
  • 削除 DedicatedHostGroupId
注:
既存のマシンのOSディスクとそのすべてのデータはそのまま残り、新しいVMがそのディスクに接続されます。
既存のVMを更新する前に:
  1. 既存のマシンの構成を確認します。例えば、,
    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
  2. プロビジョニングスキームを更新します。例えば、,
    • マシンプロファイルの入力としてVMを使用する場合:
      Set-ProvScheme -ProvisioningSchemeName "my-catalog" -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<virtual-machine>.vm"
    • マシンプロファイルの入力としてテンプレート仕様を使用する場合:
      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"
    • サービス提供のみの場合:
      Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
  3. VMの現在のプロパティが現在のプロビジョニングスキームと一致しているか、およびVMに保留中の更新アクションがあるかを確認します。例えば、,
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
    特定のバージョンのマシンを見つけることもできます。例えば、,
    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
既存のマシンに次回の再起動時に適用される更新を要求するには:
  1. 既存のマシンを更新し、次回の再起動時に更新が適用されるようにするには、次のコマンドを実行します。
    • すべての既存のマシンを更新するには。例えば、,
      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 は、スケジュールの時間枠に上限がないことを示します。
  2. 更新がスケジュールされているマシンを見つける。例:
    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
  3. マシンを再起動します。次回の電源投入時に、プロパティの変更が既存のマシンに適用されます。以下のコマンドを使用して、更新されたステータスを確認できます。例:
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
スケジュールされた時間枠内で次回起動時に最新のプロビジョニング設定に更新するようにVMをスケジュールするには:
  1. 次のコマンドを実行します。
    • 開始時刻を現在時刻として更新をスケジュールするには:
      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)は、スケジュールの時間枠に上限がないことを示します。
  2. 更新ステータスを確認します。
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion
  3. VM の電源を入れます。スケジュールされた時間枠の後にマシンの電源を入れた場合、構成の更新は適用されません。スケジュールされた時間枠内にマシンの電源を入れた場合、,
    • マシンがオフになっていて、
      • マシンの電源を入れない場合、構成の更新は適用されません
      • マシンの電源を入れる場合、構成の更新が適用されます
    • マシンの電源が入っていて、
      • マシンを再起動しない場合、構成の更新は適用されません
      • マシンを再起動する場合、構成の更新が適用されます
構成の更新をキャンセルするには:
単一のVM、複数のVM、またはカタログ全体の構成更新をキャンセルすることもできます。構成更新をキャンセルするには:
  1. Clear-ProvVMUpdateTimeWindow を実行します。例:
    • 単一のVMに対してスケジュールされた構成更新をキャンセルするには:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
    • 複数のVMに対してスケジュールされた構成更新をキャンセルするには:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
注:
VM は同じカタログのものである必要があります。

ディスク暗号化の変更

Azure仮想化環境でディスク暗号化を変更し、次の操作を実行できます。
  • マスターイメージのDESとは異なるディスク暗号化セット(DES)を使用してMCSマシンカタログを作成するには、New-ProvSchemeコマンドを使用します。例:
    $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
  • 既存のMCSマシンカタログおよび既存のVMのディスク暗号化タイプを、あるDESキーから別のDESキーに変更するには、Set-ProvSchemeおよびSet-ProvVMUpdateTimeWindowコマンドを使用します。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
  • 以前CMEKが有効になっていなかったMCSマシンカタログとVMを、顧客管理の暗号化キー(CMEK)暗号化(DES)、ホストでのディスク暗号化、または二重暗号化を持つように更新するには、Set-ProvSchemeおよびSet-ProvVMUpdateTimeWindowコマンドを使用します。異なる暗号化タイプについては、Azureサーバー側暗号化、ホストでのAzureディスク暗号化、およびマネージドディスクの二重暗号化を参照してください。
  • 以前暗号化されていた既存のMCSマシンカタログとVMを非暗号化にするには、Set-ProvSchemeおよびSet-ProvVMUpdateTimeWindowコマンドを使用します。例:
    $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
  • プライベートエンドポイントでディスク暗号化を有効にする(ProxyHypervisorTrafficThroughConnectorで有効化されたホスト接続を使用したMCSマシンカタログ)。ProxyHypervisorTrafficThroughConnectorの詳細については、Azure管理トラフィックのセキュアな環境を作成するを参照してください。プライベートエンドポイントでディスク暗号化を有効にする方法については、プライベートエンドポイントでディスク暗号化を有効にするを参照してください。

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

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

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

プライベートエンドポイントを持つ既存のマシンカタログを更新する詳細な手順は次のとおりです。
  1. ProxyHypervisorTrafficThroughConnectorを介してディスク暗号化なしでカタログを作成します。ProxyHypervisorTrafficThroughConnectorの詳細については、Azure管理トラフィックのセキュアな環境を作成するを参照してください。
  2. DiskEncryptionSetIdを使用してカタログを更新するには、Set-ProvSchemeを実行します。
    注:
    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 を使用してマシンプロファイルを更新することもできます。
  3. 既存のカタログ VM を更新するには、Set-ProvVMUpdateTimeWindow を実行します。例:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
  4. VM を再起動すると、Azure portal の VM のディスクで更新されたディスク暗号化を確認できます。
  5. 新しいカタログ 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
  6. カタログに新しい VM を追加します。

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

個々のカタログ VM を更新する詳細な手順は次のとおりです。
  1. ProxyHypervisorTrafficThroughConnector を使用して、ディスク暗号化なしでカタログを作成します。ProxyHypervisorTrafficThroughConnector の詳細については、「Azure マネージドトラフィックのセキュアな環境を作成する」を参照してください。
  2. DiskEncryptionSetId を使用してカタログ VM を更新するには、Set-ProvVM を実行します。
    注:
    The 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
    MachineProfile を使用する場合の例:
    Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"
  3. 既存のカタログVMを更新するには、Set-ProvVMUpdateTimeWindow を実行します。例:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1
  4. VM を再起動すると、Azure portal の VM ディスクで更新されたディスク暗号化を確認できます。
  5. 新しいVMをカタログに追加します。

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

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

前提条件

既存のカタログは、次の条件を満たしている必要があります。
注:
既存のカタログが次の要件を満たしていない場合、WBCディスクは一時ディスク内に配置されません。
  • MCSIOが有効になっている: カスタムプロパティ WriteBackCacheMemorySize、WriteBackCacheDiskSize、および UseWriteBackCache が有効になっています。
  • エフェメラルOSディスクが有効になっていない。
  • WBCは非永続的である: PersistWBC は false です。
  • UseTempDiskForWBC が null または false です。
  • 一時ディスクのサイズは、(ライトバックキャッシュディスクサイズ + ページングファイル用の予約済み領域 + 1 GB のバッファースペース)の合計サイズよりも大きくする必要があります。
重要:
一時ディスクがあるサービスオファリングから一時ディスクがないサービスオファリングへの変更、またはその逆の変更は許可されていません。

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

既存のカタログを更新するには、次のコマンドを実行します。
  1. 既存のカタログで 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>"
  2. カタログに新しいマシンを追加して電源を入れます。新しい VM には、一時ディスク内に WBC ディスクがあります。

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

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

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

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を使用した構成

  1. PowerShellウィンドウを開きます。
  2. 必要なパラメーター: SourceProvisioningSchemeName (または SourceProvisioningSchemeUid) と TargetProvisioningSchemeName を使用して、Copy-ProvScheme コマンドを実行します。
    例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 "CitrixプロビジョニングスキームID" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "内部"
OSディスク "CitrixプロビジョニングスキームID" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "内部"
準備VM "CitrixプロビジョニングスキームID" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "内部"
公開スナップショット "CitrixプロビジョニングスキームID" : "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ディスク
  • 識別ディスク
  • ネットワークインターフェイス
  • ストレージアカウント
CitrixデータベースからVMとマシンカタログを削除し、タグを削除できます。以下を使用できます。
  • マシンカタログから単一のVMまたはVMのリストからVMとタグを削除するには、ForgetVMパラメーターを指定したRemove-ProvVMを使用します。
  • Citrixデータベースからマシンカタログを削除し、マシンカタログ全体からタグを削除するには、ForgetVMパラメーターを指定したRemove-ProvSchemeを使用します。
この機能は、永続VMにのみ適用されます。
これを行うには:
  1. PowerShellウィンドウを開きます。
  2. Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。
  3. CitrixデータベースからVMを削除し、VMからタグを削除するには、Remove-ProvVMを実行します。 例:
    Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM
  4. Citrixデータベースからマシンカタログを削除し、マシンカタログからタグを削除するには、Remove-ProvSchemeを実行します。例:
    Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM
    注:
    Remove-ProvSchemeでForgetVMパラメーターを使用すると、プロビジョニングスキームがBYORG(Bring Your Own Resource Group)またはCitrix管理リソースグループのいずれかに存在する場合、MCSはベースディスクスナップショットを含むすべてのスナップショットを削除します。

詳細情報