Amazon WorkSpaces Core マネージドインスタンスのカタログを作成する
「(/ja-jp/citrix-virtual-apps-desktops/install-configure/machine-catalogs-create)」では、マシンカタログを作成するウィザードについて説明します。以下の情報は、Amazon WorkSpaces Core マネージドインスタンスに固有の詳細を扱います。
注:
現在、永続VMと非永続VMの両方のカタログ(
CleanOnBootプロパティがTrueまたはFalseのもの)の作成がサポートされています。
前提条件
Amazon WorkSpaces Core マネージドインスタンスのカタログを作成する前に、以下を完了しておく必要があります。
- Amazon WorkSpaces Core マネージドインスタンスへの接続。「(/ja-jp/citrix-virtual-apps-desktops/install-configure/connections/connection-amazon-wsc.html)」を参照してください。
- 準備されたイメージ。「(/ja-jp/citrix-virtual-apps-desktops/install-configure/create-prepared-image-amazon-wsc.html)」を参照してください。
イメージ準備中のネットワーク設定
イメージ準備中、元のVMに基づいて準備用仮想マシン(VM)が作成されます。この準備用VMはネットワークから切断されます。準備用VMからネットワークを切断するために、すべてのインバウンドおよびアウトバウンドトラフィックを拒否するネットワークセキュリティグループが作成されます。このネットワークセキュリティグループは永続的であり、再利用されます。ネットワークセキュリティグループの名前は Citrix.XenDesktop.IsolationGroup-GUID で、GUIDはランダムに生成されます。
マシンプロファイルベースのマシンカタログ
マシンプロファイルを使用して、EC2インスタンス(VM)または起動テンプレートバージョンからハードウェアプロパティをキャプチャし、プロビジョニングされたマシンに適用できます。キャプチャされるプロパティには、例えば、テナンシータイプ、インスタンスタイプ、セキュリティグループ、ネットワークマッピング、EBSボリュームプロパティ、EBS最適化、CPUオプション、ハイバネーション機能、およびその他のサポートされているAWS構成が含まれます。
マシンプロファイルの入力として、AWS EC2インスタンス(VM)またはAWS起動テンプレートバージョンを使用できます。
注:
- EBSボリュームプロパティは、マシンプロファイルからのみ派生します。
- Instance Metadata Service (IMDS) V2 のみがサポートされており、IMDS V1 はサポートされていません。詳細については、「How Instance Metadata Service Version 2 works」を参照してください。
AWS テナンシー
AWS は、共有テナンシー(デフォルトタイプ)と専用テナンシーの2つのテナンシーオプションを提供しています。共有テナンシーとは、異なる顧客の複数のAmazon WorkSpaces Coreインスタンスが同じ物理ハードウェア上に存在する可能性があることを意味します。専用テナンシーとは、Amazon WorkSpaces Coreインスタンスが、お客様が展開した他のインスタンスと同じハードウェア上でのみ実行されることを意味します。
注:
専用インスタンスのみがサポートされています(専用ホストは現在サポートされていません)。他の顧客は同じハードウェアを使用しません。
テナンシータイプはマシンプロファイルから取得されます
MCS を使用して AWS でマシンをプロビジョニングするためのカタログを作成する場合、テナンシータイプはマシンプロファイルから取得されます。
- 共有ハードウェア:この設定は、ほとんどの展開に適しています。複数の顧客が互いにやり取りすることなくハードウェアを共有します。共有ハードウェアを使用することは、Amazon EC2 インスタンスを実行するための最も安価なオプションです。
- 専用インスタンス:この設定は、特定のセキュリティまたはコンプライアンス要件を持つ展開により適しています。専用インスタンスを使用すると、他の AWS 顧客とは別のホストを持つという利点を享受できますが、ホスト全体に対して料金を支払う必要はありません。ホストの容量について心配する必要はありませんが、インスタンスの料金は高くなります。さらに、専用インスタンスは、Bring Your Own License (BYOL) のサポートが限定的です。
柔軟な課金
Amazon WorkSpaces Core マネージドインスタンスは、次の2つの課金モードをサポートしています。
| 課金モード | 説明 |
|---|---|
| 月額 | 固定の月額定額課金。永続デスクトップや予測可能なワークロードに最適です。 |
| 時間単位 | 従量課金。これは、課金モードが明示的に指定されていない場合のAWSのデフォルト設定です。 |
これらのオプションは、ワークロードの永続性と使用パターンに基づいてコンピューティングコストを管理するための柔軟性を提供します。
この機能を使用するには、Amazon WorkSpaces課金サービスを使用する必要があります。デフォルトでは、MCSはこのサービスを使用してインスタンスをプロビジョニングおよび管理し、永続的なワークロードに対してより競争力のある定額料金の恩恵を受けることができます。
前提条件と考慮事項
-
AWSアカウントの設定:AWSアカウントは、WorkSpaces課金サービスを使用するように構成されている必要があります。AWSアカウントはデフォルトで切り替えられますが、一部の顧客は、WorkSpaces Coreマネージドインスタンスを使用するために、AWSにレガシーEC2課金サービスを維持するよう要求する場合があります。
注:
アカウントがレガシーEC2課金サービスを使用している場合、月単位の課金オプションは利用できません。
- ホスト接続:柔軟な課金は、Amazon WorkSpaces Coreホスト接続にのみ適用されます。標準のAWS EC2ホスト接続ではサポートされていません。
- スポットインスタンス:スポットインスタンスは、WorkSpaces課金サービスではサポートされていません。
- 混合課金:AWSアカウントは、コアマネージドインスタンスに対してWorkSpaces課金またはEC2課金のいずれかを使用する必要があります。単一のアカウント内で両方を混在させることはサポートされていません。
- 互換性:特定のインスタンスタイプ、プラットフォームタイプ(OS)、およびテナンシータイプのみが特定の課金モードと互換性があります。MCSは、選択内容(サービス提供、マシンプロファイル、および準備済みイメージ)が選択した課金モードと一致することを確認するために、事前チェックを実行します。
特定の課金モードでマシンカタログを作成するを参照してください。
カタログを作成する
Amazon WorkSpaces Coreマネージドインスタンスのカタログを作成するには、準備済みイメージとマシンプロファイルが必要です。マシンプロファイルの入力として、AWS VMインスタンスまたはAWS起動テンプレートバージョンを使用できます。
カタログは以下を使用して作成できます。
Web Studio を使用してカタログを作成する
イメージノードからマシンカタログを作成する
イメージノードのカタログの作成オプションを使用して、イメージバージョンでカタログを作成します。
または、マシンカタログノードでカタログを作成する際にバージョンを選択し、カタログ作成ワークフローで準備されたイメージオプションにリンクすることもできます。マシンカタログノードからマシンカタログを作成するを参照してください。
イメージノードから MCS マシンカタログを作成するには、次の手順を実行します。
- イメージバージョンを選択し、カタログの作成をクリックします。はじめにページで次へをクリックします。
- マシン管理ページとイメージページでは、選択したイメージバージョンに基づいて設定が事前に選択されています。イメージページで、選択した準備済みイメージのメモを入力します。
- 次のページで設定を完了します。
- 概要ページで、マシンカタログの詳細を確認します。マシンカタログの名前と説明を入力します。完了をクリックします。
- マシンカタログノードに移動して、作成されたマシンカタログを表示します。
マシンカタログノードからマシンカタログを作成する
マシンカタログノードから MCS マシンカタログを作成するには、次の手順を実行します。
- 左側のナビゲーションペインで「マシンカタログ」をクリックします。
- 「マシンカタログの作成」をクリックします。「マシンカタログのセットアップ」ページが表示されます。
- 「マシンタイプ」ページで、カタログのマシンタイプ(たとえば、「マルチセッションOS」)を選択します。
-
「マシン管理」ページで、次の設定を選択します。
- 「電源管理されているマシン(仮想マシンやブレードPCなど)」を選択します。
- 「Citrixプロビジョニングテクノロジー」を選択します。次に、「Citrix Machine Creation Services™」を選択します。
- 「リソース」フィールドで、ホスト接続の作成時に構成したリソース(アベイラビリティゾーンまたはローカルゾーン)を選択し、「次へ」をクリックします。
- 「デスクトップエクスペリエンス」ページで、ユーザーがログオンしたときに使用するランダムデスクトップまたは静的デスクトップを選択します。静的デスクトップが選択されている場合は、ユーザーがローカルディスクで行った変更を保存するかどうか(永続的または非永続的)をさらに指定します。
-
「イメージ」ページで、「イメージの選択」をクリックして、マシンカタログ用の準備済みイメージを選択します。作成した準備済みバージョンを選択します。イメージのバージョン名をクリックします。選択したイメージバージョンの詳細を表示するには、下線が引かれているバージョン番号をクリックします。「完了」をクリックします。
準備済みイメージに関連付けられたマシンプロファイルが表示され、そのハードウェアプロパティ(インスタンスタイプ、テナンシータイプ、ネットワークマッピング、セキュリティグループ、ボリュームプロパティなど)がカタログ内のマシンを作成するために使用されます。マシンプロファイルのソースを別のVMまたは起動テンプレートバージョンに変更するには、編集ボタンをクリックします。
-
「仮想マシン」ページで:
- カタログのVM数を入力します。
- デフォルトのマシン仕様が表示されます。これはマシンプロファイルに基づいています。変更するには、編集アイコンを選択し、マシン仕様を選択します。
- 「NIC」ページで、VMのNIC(またはENI)を選択します。
-
「マシンID」ページで、カタログ内のマシンのマシンIDタイプを構成します。
- ドメイン参加済みマシン (オンプレミスActive DirectoryまたはMicrosoft Entraハイブリッド参加) を構成するには、ドメインを選択し、このマシンカタログで作成されるVM用の新しいADアカウントを作成します。プロビジョニングされたVMは、選択したドメインに参加します。ドメイン非参加マシンをプロビジョニングするには、ドメイン非参加オプションを選択します。
- VM用に作成される新しいアカウントのアカウント命名スキームを指定します。
- ドメイン資格情報ページで、資格情報の入力をクリックして、選択したドメインの資格情報を提供します。プロンプトが表示されたら、管理者レベルのユーザー名とパスワードを入力します。以前に当社の製品ドキュメントに従ってドメイン資格情報を保存している場合は、サービスアカウントを使用することもできます。
- 概要ページが表示されるまで、残りのページをクリックして進みます。マシンカタログの名前を入力し、完了を選択してマシンカタログを作成します。
AWSローカルゾーンでのマシンカタログの作成に関する制限事項
- 特定のローカルゾーンは特定のハードウェア構成のみをサポートします (例: パースのローカルゾーンはGP3ボリュームをサポートせず、GP2のみをサポートします)。
- すべてのローカルゾーンでgp2のみが普遍的にサポートされており、すべてがgp3をサポートしているわけではないため、IDディスクの作成はデフォルトでgp2ボリュームタイプを使用します。
- 目的のローカルゾーンでサポートされているハードウェア仕様を持つマシンプロファイルを選択する必要があります。
- 準備済みイメージAMIスナップショットとIDディスクスナップショットは、ローカルゾーンではなくリージョンに配置されるのがデフォルトです (ローカルゾーンでのEBSスナップショットサポートの可視性に関するAWSの制限のため)。
- 完全なEC2およびEBSサービスをサポートするローカルゾーンのみがサポートされるゾーンです。
PowerShellを使用してカタログを作成する
準備済みイメージバージョン仕様とマシンプロファイルを使用してカタログを作成する
-
準備済みイメージバージョン仕様から
New-ProvSchemeコマンドを使用してMCS非永続マシンカタログを作成します。例:New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”] <!--NeedCopy--> -
準備済みイメージバージョン仕様から
New-ProvSchemeコマンドを使用してMCS永続マシンカタログを作成します。例:New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”] <!--NeedCopy-->
カタログを作成するためのPowerShellコマンドの完全なセットの例:
$Catalog = New-BrokerCatalog -AllocationType "Random" -IsRemotePC $False -MinimumFunctionalLevel "L7_20" -Name "wsccatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool -AllowUnicode -Domain "domainname" -IdentityPoolName "wsccatalog" -IdentityType "ActiveDirectory" -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName wsccatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName wsc -IdentityPoolName wsccatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName wsccatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->
マシンプロファイルを更新する
マシンプロファイルで最初にプロビジョニングされたカタログの、マシンプロファイルを更新するには、次の手順を実行します。MCSマシンカタログを編集する際に、マシンプロファイルソースのテナンシータイプとハイバネーション機能を変更することもできます。
-
Set-ProvSchemeコマンドを実行します。例:Set-ProvScheme ` -ProvisioningSchemeUid "<ID" ` -MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm" <!--NeedCopy-->
特定の課金モードでマシンカタログを作成する
現在、マシンカタログを作成する際に課金モードを指定できるのはPowerShellのみです。
PowerShellを使用する
PowerShellで課金モードを指定するには、New-ProvScheme コマンドで CustomProperties パラメーターを使用します。
$custprop = "BillingMode,Monthly"
New-ProvScheme -ProvisioningSchemeName "MyCatalog" `
-ImageVersionSpecUid $ImageVersionSpecUid `
-HostingUnitName "wsc-unit" `
-IdentityPoolName "MyIdentityPool" `
-MachineProfile "XdHyp:\HostingUnits\wsc-unit\machine-profile lt-123.launchtemplate\lt-123 (1).launchtemplateversion" `
-CustomProperties $custprop `
-CleanOnBoot
<!--NeedCopy-->
注:
BillingModeプロパティが省略されている場合、カタログはデフォルトでHourlyになります。
既存のカタログの課金モードを変更する
既存のカタログを Monthly から Hourly に、またはその逆に変換できます。この変更は、カタログ内の新規および既存のVMの両方に適用できます。
更新に関する重要な考慮事項
- サービスウィンドウ:既存のVMは、課金変更を適用するためにサービスウィンドウまたは電源サイクルを経る必要があります。
- 検証:MCSは、変更を適用する前に、既存のインスタンスタイプとプラットフォームが新しい課金モードと互換性があることを検証します。
PowerShellを使用した更新
-
カタログに追加された新しいVMのみの課金モードを更新するには、プロビジョニングスキームの課金モードカスタムプロパティを更新します。
$custprop = "BillingMode,Hourly" Set-ProvScheme -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop <!--NeedCopy--> -
カタログ内の新規および既存のVMの課金モードを更新するには、更新されたカスタムプロパティを持つ新しいプロビジョニングスキームバージョンを作成し、その新しいバージョンをすべてのVMに適用します。
$custprop = "BillingMode,Hourly" New-ProvSchemeVersion -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop New-ProvSchemeHardwareUpdate -ProvisioningSchemeVersion 2 ` -StartsNow -AllVMs ` -MaxDurationInMinutes 100 ` -ProvisioningSchemeName "MyCatalog" <!--NeedCopy-->
課金情報の監視
カタログおよび個々の仮想マシンの課金モードを確認できます。
アカウントの課金資格を確認するには、次のPowerShellコマンドを実行します。
-
CustomPropertiesの一部として
BillingModeを返しますGet-ProvScheme –ProvisioningSchemeName “"MyCatalog" " | Select ProvisioningSchemeName, CustomProperties <!--NeedCopy--> -
VMInfoの一部として
BillingModeを返しますGet-ProvVMDetails –ProvisioningSchemeName “"MyCatalog" " | Select-Object -ExpandProperty VMInfo <!--NeedCopy-->
トラブルシューティングと検証
MCSには、互換性のない構成を防ぐための事前チェックが含まれています。カタログの作成または編集中に、次のエラーが発生する可能性があります。
-
NoInstanceConfigFoundForBillingMode: 選択されたサービスオファリング(インスタンスタイプ)、テナンシー、およびプラットフォームタイプが、選択された課金モードでサポートされていない場合に発生します。
- Spot Instance Not Supported: WorkSpacesホスト接続でスポットインスタンスを使用しようとすると、検証が失敗します。
- EC2 billing restriction: AWSアカウントがレガシーEC2課金モデルを使用している場合、月次課金モードを設定しようとすると検証エラーが発生します。
PowerShellを使用して起動テンプレートバージョンでカタログを作成する
起動テンプレートバージョンをマシンプロファイル入力として使用して、MCSマシンカタログを作成できます。また、マシンプロファイルカタログの入力をVMから起動テンプレートバージョンへ、および起動テンプレートバージョンからVMへ更新することもできます。
AWS EC2コンソールでは、起動テンプレートのインスタンス構成情報をバージョン番号とともに提供できます。マシンカタログの作成または更新時に、起動テンプレートバージョンをマシンプロファイル入力として指定すると、そのバージョンの起動テンプレートからのプロパティがプロビジョニングされたVDA VMにコピーされます。
以下のプロパティは、マシンプロファイル入力を使用するか、New-ProvScheme または Set-ProvScheme コマンドのパラメータとして明示的に指定できます。New-ProvScheme または Set-ProvScheme コマンドで指定された場合、これらのプロパティのマシンプロファイル値よりも優先されます。
- サービス提供
- ネットワーク
注:
マシンプロファイルの起動テンプレートでサービス提供が指定されていない場合、または
New-ProvSchemeコマンドのパラメータとして指定されていない場合、適切なエラーが発生します。
起動テンプレートバージョンをマシンプロファイル入力として使用してカタログを作成するには:
- PowerShell ウィンドウを開きます。
- Citrix固有のPowerShellモジュールをロードするには、
asnp citrix*を実行します。 -
起動テンプレートの起動テンプレートバージョンの一覧を取得します。例:
XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath <!--NeedCopy--> -
IDプールが作成されていない場合は作成します。例:
New-AcctIdentityPool ` -IdentityPoolName "abc11" ` -NamingScheme "abc1-##" ` -NamingSchemeType Numeric ` -Domain "citrix-xxxxxx.local" ` -ZoneUid "xxxxxxxx" ` <!--NeedCopy--> -
起動テンプレートバージョンをマシンプロファイル入力として使用してプロビジョニングスキームを作成します。例:
New-ProvScheme ` -ProvisioningSchemeName "MPLT1" ` -HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" ` -IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" ` -ImageVersionSpecUid ‘24dfb047-e867-527g-896c-25664xxxxx1t’ ` -CleanOnBoot ` -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion" <!--NeedCopy--> -
プロビジョニングスキームをブローカーカタログとして登録します。例:
New-BrokerCatalog -Name "MPLT1" ` -AllocationType Random ` -Description "Machine profile catalog" ` -ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx ` -ProvisioningType Mcs ` -SessionSupport MultiSession ` -PersistUserChanges Discard <!--NeedCopy--> - カタログの作成を完了します。
マシンプロファイルソースを更新する
マシンプロファイルカタログの入力を、VMから起動テンプレートバージョンへ、または起動テンプレートバージョンからVMへ更新することもできます。例:
-
マシンプロファイルカタログの入力をVMから起動テンプレートバージョンに更新するには:
Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" ` -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion" <!--NeedCopy--> -
マシンプロファイルカタログの入力を起動テンプレートバージョンからVMに更新するには:
Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" ` -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm" <!--NeedCopy-->
MCSIOが有効なカタログ
MCSストレージ最適化 (MCSIO) は、ディスク操作をメモリまたは小型の高速ディスクにキャッシュすることで、VMのパフォーマンスを向上させます。PowerShellコマンドを使用して、MCSIOが有効な非永続カタログを作成できます。このようなカタログを作成するには、AMIインスタンスの準備中にVDAをインストールまたはアップグレードする際に、MCSIOドライバーをインストールする必要があります。デフォルトでは、このドライバーはインストールされていません。
MCSIO AMIが準備された後(VDAのインストール時に、MCSIOドライバーをインストールに含めるオプションを選択した場合)、MCSIOが有効な非永続カタログを作成できます。
注:
Studioを使用してMCSIOをディスクキャッシュのみ(メモリキャッシュなし)で構成するオプションは、すべてのハイパーバイザーおよびクラウドサービス環境で削除されました。
MCSIOが有効なカタログを作成する
New-ProvScheme PowerShellコマンドに追加された4つのパラメーターは次のとおりです。
-
UseWriteBackCache: 指定されたプロビジョニングスキームのキャッシュ(ライトバックキャッシュ)をオンにします -
WriteBackCacheDiskSize: キャッシュに使用される一時ディスクのサイズをGB単位で指定します -
WriteBackCacheMemorySize: キャッシュに使用するメモリ量をMB単位で指定します。これはオプションのパラメーターです。
注:
WriteBackCacheDiskSizeの値はゼロより大きくする必要があります。これは、少なくとも1 GBのキャッシュディスクストレージが必要なためです。キャッシュディスクのサイズはOSディスクのサイズより大きくしてはいけません。WriteBackCacheMemorySizeの値はゼロ以外で、マシンカタログのメモリサイズよりも小さくする必要があります。
MCSIOに影響を与えるカスタムプロパティは次のとおりです。
-
WBCDiskStorageType: Amazon WorkSpaces Core Managed Instancesの一時ディスクに使用されるボリュームタイプを定義します。このパラメーターは、volume-type[:iops][:throughput]の形式で文字列引数を取ります。ボリュームタイプは次のとおりです。- gp2: このボリュームタイプにはiopsおよびthroughputパラメーターを使用しないでください。
- gp3: このボリュームタイプにはiopsおよびthroughputパラメーターを使用してください。
- io1: このボリュームタイプにはiopsパラメーターのみを使用してください。
- io2: このボリュームタイプにはiopsパラメーターのみを使用してください。
デフォルトのボリュームタイプはgp2です。
-
PersistWBC: Amazon WorkSpaces Core Managed Instancesの電源がオフになったときに、キャッシュディスクを保持するか破棄するかを制御します。trueに設定されている場合、キャッシュディスクは保持されます。falseに設定されている場合(デフォルト)、キャッシュディスクはAMIインスタンスの電源がオンになっている間のみ作成され、保持されます。 -
PersistOSDisk: Amazon WorkSpaces Core Managed Instancesの電源がオフになったときに、OSディスクを保持するか破棄するかを制御します。trueに設定されている場合、OSディスクは保持されます。falseに設定されている場合(デフォルト)、OSディスクはAMIインスタンスの電源がオンになっている間のみ作成され、保持されます。
MCSIOが有効な非永続カタログを作成するには、PowerShellウィンドウで次の手順を実行します。
- PowerShellウィンドウを開きます。
-
asnp citrix*を実行して、Citrix固有のPowerShellモジュールをロードします。 - ブローカーカタログとIDプールを作成します。
-
プロビジョニングスキームを作成します。例:
$HostingUnitUid = '0xxxx1d9-bbfc-xxxf-bxxb-exxxxxe008b2' $MasterImageVM = 'XDHyp:\HostingUnits\ctx-test\aws-apollo-non-persistent-multi-mcsio-vda-win2022 (ami-0bf1810488acbxxxb).template' $NetworkMap = @{ 'NetworkPath' = 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\10.0.128.0`/17 (vpc-0fa6e41d72507fxxx).network' } $SecurityGroup = $( 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\private.securitygroup' ) $ServiceOffering = 'XDHyp:\HostingUnits\ctx-test\T3 Medium Instance.serviceoffering' $CustomProperties = 'WBCDiskStorageType,gp3:6000:250;PersistWBC,false' $provScheme = New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid ` -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot ` - MasterImageVM $MasterImageVM ` -NetworkMap $NetworkMap ` -ServiceOffering $ServiceOffering ` -SecurityGroup $SecurityGroup ` -CustomProperties $CustomProperties ` -UseWriteBackCache -WriteBackCacheDiskSize 16 -WriteBackCacheMemorySize 256 <!--NeedCopy--> - カタログにVMを追加します。
MCSIO を使用して起動パフォーマンスを向上させる
MCSIO を有効にし、PersistWBC と PersistOSDisk のカスタムプロパティを true に設定すると、VM の起動パフォーマンスを向上させることができます。この設定により、VM は新しいキャッシュディスクを初期化したり、テンプレートからルートディスクを再作成したりする必要がないため、より高速に起動できます。
OS ディスクと ID ディスクを暗号化する
AWS KMS キー(カスタマー管理キーおよび AWS 管理キー)を使用して VM のカタログを作成できます。これらのキーは、OS ディスクと ID (Identity Disk) を暗号化するために使用できます。
- AWS 管理キーは毎年自動的にローテーションされます。
- カスタマー管理キーは自動ローテーションがオプションであり、手動で管理できます。
KMS キーの詳細については、以下の AWS ドキュメントを参照してください。
OS ディスクと ID ディスクの暗号化には、次のいずれかを構成します。
- 暗号化された準備済みイメージを使用します(例:KMS キーで暗号化された EBS ルートボリュームを含むインスタンスまたはスナップショットから作成された AMI)。
- 暗号化された EBS ルートボリュームを含むマシンプロファイルソース(VM または起動テンプレート)を使用します。
制限事項
次の制限事項を考慮してください。
- MCS は現在、準備済みイメージ AMI 上のディスクを 1 つのみサポートしています。
-
既存の暗号化されていないEBSボリュームやスナップショットを直接暗号化したり、既存の暗号化されたボリュームのKMSキーを変更したりすることはできません。これを行うには、次の手順を実行する必要があります。
- そのボリュームの新しいスナップショットを作成します。
- そのスナップショットから新しいボリュームを作成します。
- 新しいボリュームを暗号化します。
以下のAWSドキュメントを参照してください。
- 暗号化されていないリソースを暗号化する
- EBSボリュームの自動またはデフォルト暗号化の制限: 既存および新規のAmazon EBSボリュームを自動的に暗号化する。
ディスク暗号化を使用してカタログを作成する
ディスク暗号化を使用してMCSマシンカタログを作成するには、次の方法があります。
- 準備済みイメージ(暗号化されたディスクを持つマスターイメージからのイメージ管理を使用して作成)
- マシンプロファイル
マシンプロファイル入力を使用する際の考慮事項は次のとおりです。
- マシンプロファイル入力のKMSキーは、準備済みイメージのKMSキーよりも優先されます。
- マシンプロファイル入力が提供されない場合、準備済みイメージAMIのKMSキーがカタログVMのディスクを暗号化するために使用されます。
- マシンプロファイルにブロックデバイスマッピングが存在する場合、準備済みイメージテンプレート(AMI)とマシンプロファイルに存在するブロックデバイスは一致している必要があります。たとえば、AMIに
/dev/sda1で定義されたデバイスがある場合、マシンプロファイルにも/dev/sda1で定義されたデバイスが必要です。 - マシンプロファイルソースにキーがなく、準備されたイメージが暗号化されていない場合、カタログVMのディスクは暗号化されません。
- 準備されたイメージが暗号化されている場合、有効な入力と見なされるには、マシンプロファイルソースVMまたは起動テンプレートに暗号化されたルートボリュームが必要です。
既存のカタログを変更する
Set-ProvScheme PowerShellコマンドを使用して、既存のカタログを次のように変更できます。
- 新しいKMSキーを含むボリュームを持つマシンプロファイル入力。
- イメージ管理を使用して、暗号化されたAMIを持つマスターイメージから作成された準備済みイメージ。
重要な考慮事項:
- カタログに追加された新しいVMのボリュームは、新しいKMSキーで暗号化されます。
- 既存のマシンプロファイルがある場合に暗号化設定を更新するには、新しいマシンプロファイルで
Set-ProvSchemeを実行します。 - 既存のカタログを暗号化されたボリュームから暗号化されていないボリュームに変更することはできません。 暗号化された準備済みイメージAMIから暗号化されていない準備済みイメージAMIへのイメージ更新はできません。
VMインスタンスのNitroTPMとUEFIセキュアブートを有効にする
カタログを作成する際、NitroTPMおよび/またはUEFIセキュアブートが有効な準備済みイメージ (AMI) を選択できるようになりました。これにより、カタログ内のプロビジョニングされたVMもNitroTPMおよび/またはUEFIセキュアブートが有効になります。この実装により、VMのセキュリティと信頼性が確保されます。NitroTPMとUEFIセキュアブートの詳細については、Amazonドキュメントを参照してください。
制限事項
- 現在、NitroTPMとセキュアブートの両方を、中国を除くすべてのAWSリージョン(AWS GovCloud (US) リージョンを含む)で使用できます。
- 既存のカタログでNitroTPMとUEFIセキュアブートを有効にすることはできません。NitroTPMとUEFIセキュアブートが有効なカタログが必要な場合は、新しいカタログを作成してください。
主要な手順
- AWS環境をセットアップします。
- AWSへの接続を作成します。
- NitroTPMおよび/またはUEFIセキュアブートが有効なマスターイメージ (AMI) を作成します。(#create-an-ami-that-supports-nitrotpm-and-uefi-secure-boot).
- マスターイメージから準備済みイメージを作成します。詳細については、「Amazon WorkSpaces Coreマネージドインスタンス用の準備済みイメージを作成する」を参照してください。(/ja-jp/citrix-virtual-apps-desktops/install-configure/create-prepared-image-amazon-wsc.html).
- Web Studioのカタログ作成メニューでNitroTPMとUEFIセキュアブートが有効な準備済みイメージを選択するか、PowerShellコマンドを使用してプロビジョニングスキームを作成する際に、マシンカタログを作成します。
作成されたカタログに追加されたVMには、NitroTPMとUEFIセキュアブートが有効になっています。
NitroTPMとUEFIセキュアブートをサポートするAMIを作成する
-
NitroTPMおよび/またはUEFIセキュアブートが有効なVMからAMIを作成できます。
- AWS Marketplaceイメージを使用してインスタンスを作成します。例:
TPM-Windows_Server-2022-English-Full-Base on the aws-marketplaceを検索します。 - シングルセッションまたはマルチセッションVDAをダウンロードします。
- そのVMからAMIを作成します。
- AWS Marketplaceイメージを使用してインスタンスを作成します。例:
-
register-imageコマンドを使用します。
--boot-mode (string) --tpm-support (string) <!--NeedCopy-->詳細については、register-image を参照してください。
以下のAWSドキュメントを参照してください。
- EC2インスタンスタイプでサポートされているブートモードを決定する(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-type-boot-mode.html)
- Amazon EC2インスタンスでNitroTPMを使用するための要件(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enable-nitrotpm-prerequisites.html)/.
Delivery Controller™ホストからPowerShellウィンドウを開き、特定の項目を確認できます。
-
サービスオファリングがNitroTPMまたはUEFIセキュアブートをサポートしているか
(Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.BootMode (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.NitroTpmSupportVersions <!--NeedCopy--> -
テンプレートがNitroTPMまたはUEFIセキュアブートをサポートしているか
(Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.BootMode (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.TpmSupport <!--NeedCopy-->
既存のカタログのサービスオファリングを更新する
既存のカタログのサービスオファリングはSet-ProvSchemeを使用して変更できます。この変更は新しく追加されたVMに適用されます。ただし、次のシナリオではエラーが発生します。
| AMIのブートモード | AMIはNitro TPMをサポートしていますか? | サービスオファリングはNitroTPMとUEFIセキュアブートをサポートしていますか? |
|---|---|---|
| UEFI | いいえ | いいえ |
| レガシーBIOS | はい | いいえ |
| UEFI | はい | いいえ |
| UEFI 優先 | はい | いいえ |
VM のタグをコピーする
マシンプロファイルで指定された NIC およびディスク(ID ディスク、ライトバックキャッシュディスク、OS ディスク)のタグを、MCS マシンカタログで新しく作成された VM にコピーできます。これらのタグは、マシンプロファイルのソース(AWS VM インスタンスまたは AWS 起動テンプレートバージョン)のいずれかで指定できます。この機能は、永続および非永続マシンカタログと VM に適用されます。
注:
- AWS EC2 コンソールでは、起動テンプレートバージョンのリソースタグの下にネットワークインターフェイスのタグの値が表示されません。ただし、PowerShell コマンド
aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12を実行してタグの仕様を確認できます。- マシンプロファイルソース(VM または起動テンプレートバージョン)に 2 つのネットワークインターフェイス(eni-1 と eni-2)があり、eni-1 にタグ t1、eni-2 にタグ t2 がある場合、VM は両方のネットワークインターフェイスのタグを取得します。
PowerShell を使用して VM インスタンスをフィルタリングする
マシンプロファイル VM として使用する AWS VM インスタンスは、マシンカタログが正しく作成され機能するために互換性がある必要があります。マシンプロファイルの入力 VM として使用できる AWS VM インスタンスを一覧表示するには、Get-HypInventoryItem コマンドを使用します。このコマンドは、ホスティングユニットで利用可能な VM のインベントリをページングおよびフィルタリングできます。
ページネーション:
Get-HypInventoryItem は、2つのページネーションモードをサポートしています。
- ページングモードでは、
-MaxRecordsと-Skipパラメーターを使用してアイテムのセットを返します。-
-MaxRecords: デフォルトは 1 です。これは、返すアイテムの数を制御します。 -
-Skip: デフォルトは 0 です。これは、ハイパーバイザー内のリストの絶対的な先頭(または絶対的な末尾)からスキップするアイテムの数を制御します。
-
- スクロールモードでは、
-MaxRecords、-ForwardDirection、および-ContinuationTokenパラメーターを使用してレコードのスクロールを可能にします。-
-ForwardDirection: デフォルトは True です。これは-MaxRecordsとともに使用され、一致するレコードの次のセットまたは前のセットのいずれかを返します。 -
-ContinuationToken: これは、ContinuationTokenで指定されたアイテムの直後(またはForwardDirectionが false の場合は直前)のアイテムを返しますが、そのアイテム自体は含みません。
-
ページネーションの例:
-
最も名前の小さいマシンテンプレートの単一レコードを返します。
AdditionalDataフィールドにはTotalItemsCountとTotalFilteredItemsCountがあります。Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template <!--NeedCopy--> -
最も名前の小さいマシンテンプレートのレコードを10件返します。
Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name <!--NeedCopy--> -
最も名前の大きいレコードで終わるレコードの配列を返します。
Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name <!--NeedCopy--> -
指定された
ContinuationTokenに関連付けられたマシンテンプレートから始まるレコードの配列を返します。Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10 <!--NeedCopy-->
フィルタリング:
フィルタリングには、以下の追加のオプションパラメーターがサポートされています。これらのパラメーターは、ページネーションオプションと組み合わせることができます。
-
-ContainsName "my_name": 指定された文字列が AMI 名の一部と一致する場合、その AMI はGetの結果に含まれます。例:Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name <!--NeedCopy--> -
-Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': AMIにこれらのタグのいずれかが少なくとも1つある場合、それはGetの結果に含まれます。例:Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name <!--NeedCopy-->注:
2つのタグ値がサポートされています。タグなしタグ値は、タグのリストに指定されたタグがない項目と一致します。すべての値タグ値は、タグの値に関係なくタグを持つ項目と一致します。それ以外の場合、一致は、項目にタグがあり、その値がフィルターで指定された値と等しい場合にのみ発生します。
-
-Id "ami-0a2d913927e0352f3": AMIが指定されたIDと一致する場合、それはGetの結果に含まれます。例:Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx <!--NeedCopy-->
AdditionalDataパラメーターでのフィルタリング:
AdditionalDataフィルターパラメーターは、テンプレートまたはVMを、その機能、サービス提供、またはAdditionalDataにある任意のプロパティに基づいて一覧表示します。例:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->
互換性のないVMを示すために、-Warnパラメーターを追加することもできます。VMは、Warningという名前のAdditionalDataフィールドとともに含まれます。例:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->
次のステップ
- Amazon WorkSpaces Coreカタログの管理については、Amazon WorkSpaces Coreマネージドインスタンスのカタログを管理するを参照してください。
詳細情報
- AWS仮想化環境
- Amazon WorkSpaces Coreマネージドインスタンスへの接続
- イメージ管理
- Amazon WorkSpaces Coreマネージドインスタンス用の準備済みイメージを作成する
- Amazon WorkSpaces Core GitHub PowerShellの例については、citrix-mcs-sdk-samples-Amazon WorkSpaces Coreを参照してください。