Microsoft Azureカタログの管理
マシンカタログの管理では、マシンカタログを管理するウィザードについて説明します。以下の情報では、Microsoft Azure Resource Managerクラウド環境に固有の詳細について説明します。
注：
Microsoft Azureカタログを管理する前に、Microsoft Azureカタログの作成を完了する必要があります。Microsoft Azureカタログの作成を参照してください。
VMシャットダウン時のストレージタイプの下位層への変更
VMをシャットダウンするときに、管理ディスクのストレージタイプを下位層に切り替えることで、ストレージコストを節約できます。これを行うには、StorageTypeAtShutdownカスタムプロパティを使用します。
VMをシャットダウンすると、ディスクのストレージタイプは下位層（StorageTypeAtShutdownカスタムプロパティで指定）に変更されます。VMの電源をオンにすると、ストレージタイプは元のタイプ（StorageTypeカスタムプロパティまたはWBCDiskStorageTypeカスタムプロパティで指定）に戻ります。
重要：
ディスクは、VMの電源が少なくとも1回オンになるまで存在しません。そのため、VMの電源を初めてオンにするときにストレージタイプを変更することはできません。
ストレージタイプを下位層に変更した後、VMの起動に少し時間がかかる場合があります。
要件
- 管理ディスクに適用されます。これは、カスタムプロパティ
UseManagedDisksをtrueに設定することを意味します。 - 永続OSディスクを持つ永続および非永続カタログに適用されます。これは、カスタムプロパティ
persistOsDiskをtrueに設定することを意味します。- 永続WBCディスクを持つ非永続カタログに適用されます。これは、カスタムプロパティ
persistWBCをtrueに設定することを意味します。
- 永続WBCディスクを持つ非永続カタログに適用されます。これは、カスタムプロパティ
制限
- 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回とします。
ストレージタイプの下位層への変更
-
カスタムプロパティ
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に記載されているストレージタイプに戻ります。
- OSディスクの
既存のカタログへの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ウィンドウを開きます。
-
-
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の実行後に追加された新しいVMに適用されます。Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties <!--NeedCopy-->
-
- 既存のVMを更新して、
StorageTypeAtShutdownを有効にします。
- Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1 <!--NeedCopy--> - 既存のVMを更新して、
-
次回マシンを起動すると、マシンの
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、および以下のカスタムプロパティを更新できます。
StorageTypeWBCDiskStorageTypeIdentityDiskStorageType-
LicenseTypeDedicatedHostGroupIdPersistWBCPersistOsDiskPersistVmZones
注:
- Azure環境でマネージドディスクを使用するカタログの場合にのみ、
StorageType、WBCDiskStorageType、およびIdentityDiskStorageTypeカスタムプロパティを更新できます。Set-ProvVMUpdateTimeWindowを2回実行した場合、最新のコマンドが有効になります。
Set-ProvVMUpdateTimeWindowでVMが更新され、Zonesカスタムプロパティによって提供される現在の可用性ゾーンリストが、VMが現在使用しているゾーンを含まないように変更された場合、VMの永続ディスクは新しいゾーンにコピーされ、元のディスクは削除されます。例えば、ゾーン3でプロビジョニングされたVMが、Zonesカスタムプロパティを「1,2」に設定して更新された場合、VMとそのディスクは、ゾーン1と2のどちらか、マシン数が少ない方に移動され、ゾーン1と2の間でマシンがバランスされます。- Zonesカスタムプロパティが完全にクリアされた場合 (空の値に設定された場合)、VMのゾーンアフィニティが削除され、Azureは容量に基づいて任意の可用性ゾーンにVMを配置できるようになります。この場合、VMの永続ディスクは元のゾーンに残り、移動されません。
更新できるもの:
- 単一のVM
- 特定のVMのリスト、またはプロビジョニングスキームIDに関連付けられているすべての既存の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 <!--NeedCopy-->特定のバージョンのマシンを見つけることもできます。例えば、
Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion <!--NeedCopy-->
既存のマシンに次の再起動時に適用されるように更新を要求するには:
-
- 以下のコマンドを実行して、既存のマシンを更新し、次の再起動時に更新が適用されるようにします。
-
すべての既存のマシンを更新する場合。例えば、
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は、スケジュールされた開始時刻が現在の時刻であることを示します。 -
DurationInMinutesに負の数 (例えば、-1) を指定すると、スケジュールの時間枠に上限がないことを示します。
-
- 更新がスケジュールされているマシンを見つけます。例えば、
Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter <!--NeedCopy-->
-
マシンを再起動します。次の電源投入時に、プロパティの変更が既存のマシンに適用されます。以下のコマンドを使用して、更新されたステータスを確認できます。例えば、
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion <!--NeedCopy-->
スケジュールされた時間枠で次回起動するときに、VMが最新のプロビジョニング設定に更新されるようにスケジュールするには:
-
以下のコマンドを実行します:
-
開始時刻を現在時刻として更新をスケジュールする場合:
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）は、スケジュールの時間枠に上限がないことを示します。
-
-
更新ステータスを確認します。
Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion <!--NeedCopy--> -
VMの電源をオンにします。スケジュールされた時間枠の後にマシンの電源をオンにした場合、構成の更新は適用されません。スケジュールされた時間枠内にマシンの電源をオンにした場合、
- マシンが電源オフの状態で、
- マシンの電源をオンにしない場合、構成の更新は適用されません
- マシンの電源をオンにする場合、構成の更新が適用されます
- マシンが電源オンの状態で、
- マシンを再起動しない場合、構成の更新は適用されません
- マシンを再起動する場合、構成の更新が適用されます
- マシンが電源オフの状態で、
構成の更新をキャンセルするには:
単一のVM、複数のVM、またはカタログ全体の構成の更新をキャンセルすることもできます。構成の更新をキャンセルするには:
-
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--> -
以前は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 <!--NeedCopy-->
-
MachineProfile を使用する場合の例: ディスク暗号化が有効なVM、またはディスク暗号化設定を持つテンプレート仕様を使用します。
Set-ProvScheme -ProvisioningSchemeName azure-catalog -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm" <!--NeedCopy-->- または、Studioを使用してマシンプロファイルを更新することもできます。-
-
Set-ProvVMUpdateTimeWindowを実行して、既存のカタログVMを更新します。例:
-
- Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1 <!--NeedCopy--> -
-
- VMを再起動した後、Azureポータルで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
<!--NeedCopy--> ```
- カタログに新しい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を実行して、既存のカタログVMを更新します。例:
- Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1 <!--NeedCopy--> -
- VMを再起動すると、AzureポータルでVMディスク上の更新されたディスク暗号化を確認できます。
-
- カタログに新しいVMを追加します。
既存のカタログで一時ディスクをWBCディスクとして使用
既存のMCSマシンカタログでは、Azure一時ディスクをライトバックキャッシュディスク (WBC) ディスクとして使用できます。Set-ProvScheme PowerShellコマンドを使用して、既存のカタログとVMを更新します。
前提条件
既存のカタログは、次の条件を満たしている必要があります。
注記:
既存のカタログが次の要件を満たしていない場合、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ディスク、およびギャラリーイメージ定義の情報の取得
Azure VMに関する情報（OSディスクと種類、スナップショット、ギャラリーイメージ定義を含む）を表示できます。この情報は、マシンカタログが割り当てられている場合にマスターイメージ上のリソースに対して表示されます。この機能を使用して、LinuxまたはWindowsイメージを表示および選択できます。AdditionDatafield パラメーターにPowerShellプロパティ TemplateIsWindowsTemplate が追加されました。このフィールドには、VMの種類、OSディスク、ギャラリーイメージ情報、OSの種類情報など、Azure固有の情報が含まれています。TemplateIsWindowsTemplate を True に設定するとOSの種類がWindowsであることを示し、TemplateIsWindowsTemplate を False に設定するとOSの種類がLinuxであることを示します。
ヒント:
TemplateIsWindowsTemplatePowerShellプロパティによって表示される情報は、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):
-
TargetLocation(Azureリソースグループ) を指定しない場合:- Citrix管理リソースグループの場合、新しいCitrix管理リソースグループが作成されます。
- BYO (Bring Your Own) リソースグループの場合、新しいプロビジョニングスキームリソースは同じリソースグループに作成されます。
-
TargetLocationを指定する場合:- リソースは指定されたリソースグループに作成されます。
- 指定されたリソースグループはAzureに既に存在している必要があります。
-
-
ベースディスクスナップショット: リソースグループの構成に関係なく、ベースディスクスナップショットのコピーが常に作成されます。
前提条件
- 既存のプロビジョニングスキーム (ソースカタログ) が利用可能である必要があります。
- ターゲットの場所を指定する場合、ターゲットのAzureリソースグループが存在している必要があります。
PowerShellを使用した構成
- PowerShellウィンドウを開きます。
-
必要なパラメーター (
SourceProvisioningSchemeName(またはSourceProvisioningSchemeUid) およびTargetProvisioningSchemeName) を使用してCopy-ProvSchemeコマンドを実行します。例 1: 名前でプロビジョニングスキームをコピーします。
この例では、「Backup」という名前のスキームを「TestCopy」という新しいスキームにコピーします。
Copy-ProvScheme -SourceProvisioningSchemeName Backup -TargetProvisioningSchemeName TestCopy <!--NeedCopy-->例 2: Uidでプロビジョニングスキームを特定のリソースグループにコピーします。
この例では、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にのみ適用されます。
これを行うには:
- PowerShell ウィンドウを開きます。
- asnp citrix* を実行して、Citrix固有のPowerShellモジュールをロードします。
-
Remove-ProvVMを実行して、CitrixデータベースからVMを削除し、VMからタグを削除します。例:
Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM <!--NeedCopy--> -
Remove-ProvSchemeを実行して、Citrixデータベースからマシンカタログを削除し、マシンカタログからタグを削除します。例:Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM <!--NeedCopy-->注:
Remove-ProvSchemeでForgetVMパラメーターを使用すると、プロビジョニングスキームがBYORG (Bring Your Own Resource Group) またはCitrix管理リソースグループのいずれかに存在する場合、MCSはベースディスクスナップショットを含むすべてのスナップショットを削除します。