製品ドキュメント
Citrix DaaS™
PDFを表示

Microsoft Azureカタログの管理

April 7, 2026
寄稿者: 
C C

マシンカタログの管理では、マシンカタログを管理するウィザードについて説明します。以下の情報では、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ドキュメント](https://learn.microsoft.com/ja-jp/azure/virtual-machines/disks-convert-types?tabs=azure-powershell#restrictions)を参照してください。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>’
<!--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で定義されたプロパティよりも優先されます。

  2. VMをシャットダウンし、AzureポータルでVMのストレージタイプを確認します。ディスクのストレージタイプは、StorageTypeAtShutdownカスタムプロパティで指定された下位層に変更されます。
  3. 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シャットダウン時に下位層に変更するには：

    1. PowerShellウィンドウを開きます。
    1. asnp citrix*を実行して、Citrix固有のPowerShellモジュールをロードします。
    1. Get-Provscheme -ProvisioningSchemeName $CatalogNameを実行します。
    1. カスタムプロパティ文字列を変更します。

-  $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-->
  1. 既存のカタログのプロビジョニングスキームを更新します。この更新は、Set-ProvSchemeの実行後に追加された新しいVMに適用されます。

-  Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties

<!--NeedCopy-->
    1. 既存のVMを更新して、StorageTypeAtShutdownを有効にします。
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
<!--NeedCopy-->
  1. 次回マシンを起動すると、マシンのStorageTypeAtShutdownプロパティが更新されます。ストレージタイプは次回のシャットダウン時に変更されます。

  2. 次のコマンドを実行して、カタログ内の各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カタログからマシンプロファイルベースのカタログへの変換

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

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

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

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 がディスクに接続されます。

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

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

    -  ``` Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion

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

-  マシンプロファイルの入力として 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”

    • ```

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

      • ```
      • Set-ProvScheme -ProvisioningSchemeName “my-catalog” -ServiceOffering “XDHyp:\HostingUnits<hosting-unit>\serviceoffering.folder<service-offering>.serviceoffering” ```

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

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

    特定のバージョンを持つマシンを見つけることもできます。例:

    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
<!--NeedCopy-->

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

    1. 既存のマシンを更新し、次回の再起動時に更新を適用するには、次のコマンドを実行します。

    • すべての既存のマシンを更新する場合。例:

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

    • 特定のリストのマシンを更新する場合。例:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 <!--NeedCopy-->

    • Get-ProvVM の出力に基づいてマシンを更新する場合。例:

  •      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
     <!--NeedCopy-->

    注:

    • StartsNow は、スケジュールされた開始時刻が現在時刻であることを示します。
    • 負の数 (例: –1) を指定した DurationInMinutes は、スケジュールの時間枠に上限がないことを示します。
    1. 更新がスケジュールされているマシンを見つけます。例:
     Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
 <!--NeedCopy-->
  1. マシンを再起動します。次回の電源投入時に、プロパティの変更が既存のマシンに適用されます。次のコマンドを使用して、更新されたステータスを確認できます。例:
  •  Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
 <!--NeedCopy-->

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

  1. 次のコマンドを実行します。

    • 開始時刻を現在時刻として更新をスケジュールする場合:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName vm1 -StartsNow -DurationInMinutes 120
 <!--NeedCopy-->

  • 週末に更新をスケジュールするには:

     ```
  Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1” -StartTimeInUTC “10/15/2022 9:00am” -DurationInMinutes (New –TimeSpan –Days 2).TotalMinutes
  <!--NeedCopy--> ```

注:

  • VMName はオプションです。指定しない場合、カタログ全体に対して更新がスケジュールされます。
  • StartTimeInUTC の代わりに StartsNow を使用して、スケジュールの開始時刻が現在時刻であることを示します。
  • DurationInMinutes はオプションです。デフォルトは120分です。負の数（例: –1）は、スケジュールの時間枠に上限がないことを示します。

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

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

  2. VM の電源をオンにします。スケジュールされた時間枠の後にマシンの電源をオンにした場合、構成の更新は適用されません。スケジュールされた時間枠内にマシンの電源をオンにした場合:

    • マシンがオフになっていて、
      • マシンの電源をオンにしない場合、構成の更新は適用されません
      • マシンの電源をオンにする場合、構成の更新が適用されます
    • マシンがオンになっていて、
      • マシンを再起動しない場合、構成の更新は適用されません
      • マシンを再起動する場合、構成の更新が適用されます

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

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

  1. Clear-ProvVMUpdateTimeWindow を実行します。例:

    • 単一の VM に対してスケジュールされた構成の更新をキャンセルするには:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 <!--NeedCopy-->

    • 複数の VM に対してスケジュールされた構成の更新をキャンセルするには:

        Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 <!--NeedCopy-->

注:

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

  • 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 キーで暗号化するように更新することはできます。

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

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

  1. ProxyHypervisorTrafficThroughConnector を介してディスク暗号化なしでカタログを作成します。ProxyHypervisorTrafficThroughConnector の詳細については、「Azure マネージドトラフィックのセキュアな環境の作成」を参照してください。

  2. 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”

  • ```

     -  または、Studio を使用してマシンプロファイルを更新することもできます。
      1. Set-ProvVMUpdateTimeWindow を実行して、既存のカタログ VM を更新します。例:
      • ```

  • Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1

    ```

    1. VM を再起動すると、Azure ポータルの VM のディスクで更新されたディスク暗号化を確認できます。

  1. 新しいカタログ 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
<!--NeedCopy--> ```
  1. カタログに新しいVMを追加します。

個々のカタログVMの更新

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

  1. ProxyHypervisorTrafficThroughConnector を介してディスク暗号化なしでカタログを作成します。ProxyHypervisorTrafficThroughConnector の詳細については、「Azure マネージドトラフィックのセキュアな環境を作成」を参照してください。

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

    注:

    DiskEncryptionSetId は、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--> ```
    1. Set-ProvVMUpdateTimeWindow を実行して、既存のカタログVMを更新します。例:

  • ```

  • Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1

  • ```

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

既存のカタログでのWBCディスクとしてのテンポラリディスクの使用

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

前提条件

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

注:

既存のカタログが以下の要件を満たしていない場合、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>"
<!--NeedCopy-->

  2. カタログに新しいマシンを追加し、電源を入れます。新しいVMには、テンポラリディスク内にWBCディスクがあります。

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

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

ヒント:

TemplateIsWindowsTemplate PowerShellプロパティによって表示される情報は、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 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):

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

    例2: Uidを使用してプロビジョニングスキームを特定のResource Groupにコピーします。

    この例では、Uidを使用してスキームをコピーし、「TestRg」という名前のターゲットリソースグループを指定します。

    Copy-ProvScheme -SourceProvisioningSchemeUid 771e205d-1ee5-4ad2-b044-ecf3d7f24ec7 -TargetProvisioningSchemeName TestCopy -TargetLocation TestRg
<!--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”
準備VM “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”

注:

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

タグの削除

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

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

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

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

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

これを行うには:

  1. PowerShell ウィンドウを開きます。
  2. asnp citrix* を実行して、Citrix固有のPowerShellモジュールをロードします。

  3. Remove-ProvVM を実行して、CitrixデータベースからVMを削除し、VMからタグを削除します。 例:

    Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM
<!--NeedCopy-->

  4. Remove-ProvScheme を実行して、Citrixデータベースからマシンカタログを削除し、マシンカタログからタグを削除します。例:

    Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM
<!--NeedCopy-->

    注:

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

詳細情報

Microsoft Azureカタログの管理
April 7, 2026
寄稿者: 
C C
April 7, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.