Microsoft Azureカタログを管理する

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

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

• StorageType
• WBCDiskStorageType
• IdentityDiskStorageType
• LicenseType
• DedicatedHostGroupId
• PersistWBC
• PersistOsDisk
• PersistVm

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

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

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

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

1. Clear-ProvVMUpdateTimeWindowを実行します。例:
   • 単一のVMにスケジュールされた構成の更新をキャンセルするには:
     Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
   • 複数のVMにスケジュールされた構成の更新をキャンセルするには:
     Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
     注:
     VM は同じカタログのものである必要があります。

個々のVMのプロパティを更新する

• CustomProperties
• ServiceOffering
• MachineProfile

• VMのプロパティを更新する
• マシンカタログが更新された後も、VMで更新されたプロパティを保持する
• VMに適用された構成の更新を元に戻す(#revert-the-configuration-updates-applied-to-a-vm)

1. PowerShellウィンドウを開きます。
2. Citrix固有のPowerShellモジュールをロードするためにasnp citrix*を実行します。
3. 既存のマシンカタログの構成を確認します。例：
   Get-ProvScheme -ProvisioningSchemeName AzureCatalog
4. 更新を適用するVMの構成を確認します。例：
   Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

ディスク暗号化の変更

• 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
• 既存の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を、Set-ProvScheme および Set-ProvVMUpdateTimeWindow コマンドを使用して、顧客管理の暗号化キー（CMEK）暗号化（DES）、ホストでのディスク暗号化、または二重暗号化を持つように更新します。異なる暗号化タイプについては、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マシンカタログ）。プライベートエンドポイントを使用したディスク暗号化を有効にする方法については、プライベートエンドポイントを使用したディスク暗号化を有効にするを参照してください。

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

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

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

タグの削除

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

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

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はベースディスクスナップショットを含むすべてのスナップショットを削除します。

詳細情報

• 接続とリソースの作成および管理
• Microsoft Azureへの接続
• マシンカタログの作成
• Microsoft Azureカタログの作成
• マシンカタログの管理