Amazon WorkSpaces Core Managed Instances のカタログを作成する

最終公開日 : Oct 24, 2026
(/ja-jp/citrix-daas/install-configure/machine-catalogs-create.html)では、マシンカタログを作成するウィザードについて説明します。以下の情報では、Amazon WorkSpaces Core Managed Instances に固有の詳細について説明します。
注：
現在、永続VMと非永続VMの両方のカタログ作成（CleanOnBootプロパティがTrueまたはFalseの場合）がサポートされています。
Related information
マシンカタログを作成する

前提条件

Amazon WorkSpaces Core Managed Instances のカタログを作成する前に、以下を完了しておく必要があります。
  1. Amazon WorkSpaces Core Managed Instances への接続。詳細については、Amazon WorkSpaces Core Managed Instances への接続を参照してください。
  2. 準備されたイメージ。詳細については、Amazon WorkSpaces Core Managed Instances 用の準備されたイメージを作成するを参照してください。

イメージ準備中のネットワーク設定

イメージ準備中、元の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起動テンプレートバージョンを使用できます。
カタログは以下を使用して作成できます。

Studioを使用してカタログを作成する

イメージノードからマシンカタログを作成する

イメージノードのカタログの作成オプションを使用して、イメージバージョンでカタログを作成します。
または、マシンカタログノードでカタログを作成する際にバージョンを選択し、カタログ作成ワークフローで準備されたイメージオプションにリンクすることもできます。「マシンカタログノードからマシンカタログを作成する」を参照してください。
イメージノードからMCSマシンカタログを作成するには、次の手順を実行します。
  1. イメージバージョンを選択し、カタログの作成をクリックします。はじめにページで次へをクリックします。
  2. マシン管理ページとイメージページでは、選択したイメージバージョンに基づいて設定が事前に選択されています。イメージページで、選択した準備済みイメージのメモを入力します。
  3. 次のページで設定を完了します。
  4. 概要ページで、マシンカタログの詳細を確認します。マシンカタログの名前と説明を入力します。完了をクリックします。
  5. マシンカタログノードに移動して、作成されたマシンカタログを確認します。

マシンカタログノードからマシンカタログを作成する

マシンカタログノードからMCSマシンカタログを作成するには、次の手順を実行します。
  1. 左側のナビゲーションペインでマシンカタログをクリックします。
  2. マシンカタログの作成をクリックします。マシンカタログのセットアップページが表示されます。
  3. マシンタイプページで、カタログのマシンタイプ（例: マルチセッションOS）を選択します。
  4. マシン管理ページで、次の設定を選択します。
    1. **電源管理されているマシン（例: 仮想マシンまたはブレードPC）**を選択します。
    2. Citrixプロビジョニングテクノロジーを選択します。次に、Citrix Machine Creation Services™を選択します。
    3. リソースフィールドで、ホスト接続の作成時に構成したリソース（アベイラビリティゾーンまたはローカルゾーン）を選択し、次へをクリックします。
  5. デスクトップエクスペリエンスページで、ユーザーがログインしたときに使用するランダムまたは静的デスクトップのいずれかを選択します。静的デスクトップが選択されている場合は、ユーザーがローカルディスクで行った変更を保存するかどうか（永続的または非永続的）をさらに指定します。
  6. イメージページで、イメージの選択をクリックして、マシンカタログ用に準備されたイメージを選択します。作成した準備済みバージョンを選択します。イメージのバージョン名をクリックします。選択したイメージバージョンの詳細を表示するには、下線が引かれているバージョン番号をクリックします。完了をクリックします。
    準備されたイメージに関連付けられたマシンプロファイルが表示され、そのハードウェアプロパティ（例: インスタンスタイプ、テナンシータイプ、ネットワークマッピング、セキュリティグループ、ボリュームプロパティ）がカタログ内のマシンを作成するために使用されます。マシンプロファイルのソースを別のVMまたは起動テンプレートバージョンに変更するには、編集ボタンをクリックします。
  7. 仮想マシンページで:
    1. カタログのVM数を入力します。
    2. デフォルトのマシン仕様が表示されます。これはマシンプロファイルに基づいています。変更するには、編集アイコンを選択し、マシン仕様を選択します。
  8. NICページで、VMのNIC（またはENI）を選択します。
  9. マシンIDページで、カタログ内のマシンのマシンIDタイプを構成します。
    1. ドメイン参加済みマシン (オンプレミスActive DirectoryまたはMicrosoft Entraハイブリッド参加) を構成するには、ドメインを選択し、このマシンカタログで作成されるVM用の新しいADアカウントを作成します。プロビジョニングされたVMは、選択されたドメインに参加します。ドメイン非参加マシンをプロビジョニングするには、ドメイン非参加オプションを選択します。
    2. VM用に作成される新しいアカウントのアカウント命名スキームを指定します。
  10. ドメイン資格情報ページで、資格情報の入力をクリックし、選択したドメインの資格情報を提供します。プロンプトが表示されたら、管理者レベルのユーザー名とパスワードを入力します。以前に当社の製品ドキュメントに従ってドメイン資格情報を保存している場合は、サービスアカウントを使用することもできます。
  11. 概要ページが表示されるまで、残りのページをクリックして進みます。マシンカタログの名前を入力し、完了を選択してマシンカタログを作成します。

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”]
  • New-ProvSchemeコマンドを使用して、準備済みイメージバージョン仕様からMCS永続マシンカタログを作成します。例:
    New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
カタログを作成するための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

マシンプロファイルを更新する

マシンプロファイルで最初にプロビジョニングされたカタログのマシンプロファイルを更新するには、以下を実行します。MCSマシンカタログの編集中に、マシンプロファイルソースのテナンシータイプとハイバネーション機能を変更することもできます。
  1. Set-ProvSchemeコマンドを実行します。例：
    Set-ProvScheme `
    -ProvisioningSchemeUid "<ID" `
    -MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"

特定の課金モードでマシンカタログを作成する

現在、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
注：
BillingModeプロパティが省略されている場合、カタログはデフォルトでHourlyになります。

既存のカタログの課金モードを変更する

既存のカタログをMonthlyからHourlyに、またはその逆に変換できます。この変更は、カタログ内の新規および既存のVMの両方に適用できます。

更新に関する重要な考慮事項

  • サービスウィンドウ：既存のVMは、課金変更を適用するためにサービスウィンドウまたは電源サイクルを経る必要があります。
  • 検証：MCSは、変更を適用する前に、既存のインスタンスタイプとプラットフォームが新しい課金モードと互換性があることを検証します。

PowerShellを使用した更新

  • カタログに追加される新しいVMのみの課金モードを更新するには、プロビジョニングスキームの課金モードカスタムプロパティを更新します。
    $custprop = "BillingMode,Hourly"

    Set-ProvScheme -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop
  • カタログ内の新規および既存のVMの課金モードを更新するには、更新されたカスタムプロパティを持つ新しいプロビジョニングスキームバージョンを作成し、その新しいバージョンをすべてのVMに適用します。
    $custprop = "BillingMode,Hourly"

    New-ProvSchemeVersion -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop

    New-ProvSchemeHardwareUpdate -ProvisioningSchemeVersion 2 `
    -StartsNow -AllVMs `
    -MaxDurationInMinutes 100 `
    -ProvisioningSchemeName "MyCatalog"

課金情報の監視

カタログおよび個々の仮想マシンの課金モードを確認できます。
アカウントの課金資格を確認するには、次のPowerShellコマンドを実行します。
  • CustomPropertiesの一部としてBillingModeを返します
    Get-ProvScheme –ProvisioningSchemeName “"MyCatalog" "  | Select  ProvisioningSchemeName,  CustomProperties
  • VMInfoの一部としてBillingModeを返します
    Get-ProvVMDetails –ProvisioningSchemeName “"MyCatalog" "  | Select-Object  -ExpandProperty VMInfo

トラブルシューティングと検証

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コマンドのパラメータとして指定されていない場合、適切なエラーが発生します。
起動テンプレートバージョンをマシンプロファイル入力として使用してカタログを作成するには：
  1. PowerShellウィンドウを開きます。
  2. Citrix固有のPowerShellモジュールをロードするためにasnp citrix*を実行します。
  3. 起動テンプレートの起動テンプレートバージョンの一覧を取得します。例：
    XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
  4. 作成されていない場合は、IDプールを作成します。例：
    New-AcctIdentityPool `
    -IdentityPoolName "abc11" `
    -NamingScheme "abc1-##" `
    -NamingSchemeType Numeric `
    -Domain "citrix-xxxxxx.local" `
    -ZoneUid "xxxxxxxx" `
  5. 起動テンプレートバージョンをマシンプロファイル入力として使用してプロビジョニングスキームを作成します。例：
    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"
  6. プロビジョニングスキームをブローカーカタログとして登録します。例：
    New-BrokerCatalog -Name "MPLT1" `
    -AllocationType Random `
    -Description "Machine profile catalog" `
    -ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
    -ProvisioningType Mcs `
    -SessionSupport MultiSession `
    -PersistUserChanges Discard
  7. カタログの作成を完了します。

マシンプロファイルソースを更新する

マシンプロファイルカタログの入力を、VMから起動テンプレートバージョンへ、また起動テンプレートバージョンからVMへ更新することもできます。例：
  • VMから起動テンプレートバージョンにマシンプロファイルカタログの入力を更新するには:
    Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
    -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
  • 起動テンプレートバージョンからVMにマシンプロファイルカタログの入力を更新するには:
    Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
    -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"

MCSIO対応カタログ

MCS Storage Optimization (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の値は0より大きくする必要があります。これは、少なくとも1 GBのキャッシュディスクストレージが必要なためです。キャッシュディスクサイズはOSディスクサイズより大きくしてはいけません。
  • WriteBackCacheMemorySizeの値はゼロ以外で、マシンカタログのメモリサイズよりも小さくする必要があります。
MCSIOに影響するカスタムプロパティは次のとおりです。
  • WBCDiskStorageType: Amazon WorkSpaces Core Managed Instancesの一時ディスクに使用されるボリュームタイプを定義します。このパラメーターは、volume-type[:iops][:throughput]の形式で文字列引数を取ります。ボリュームタイプは次のとおりです。
    • gp2: このボリュームタイプには、iopsおよびスループットパラメーターを使用しないでください
    • gp3: このボリュームタイプには、iopsおよびスループットパラメーターを使用してください
    • 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ウィンドウで次の手順を実行します。
  1. PowerShellウィンドウを開きます。
  2. Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。
  3. ブローカーカタログとIDプールを作成します。
  4. プロビジョニングスキームを作成します。例：
    $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
  5. カタログにVMを追加します。

MCSIOで起動パフォーマンスを向上させる

MCSIOを有効にし、PersistWBCとPersistOSDiskのカスタムプロパティをtrueに設定すると、VMの起動パフォーマンスを向上させることができます。この設定により、VMは新しいキャッシュディスクを初期化したり、テンプレートからルートディスクを再作成したりする必要がないため、より高速に起動できます。

OSディスクとIDディスクを暗号化する

AWS KMSキー（カスタマーマネージドキーおよびAWSマネージドキー）を使用してVMのカタログを作成できます。これらのキーは、OSディスクとIDディスク（ID）の暗号化に使用できます。
  • AWSマネージドキーは毎年自動的にローテーションされます。
  • カスタマーマネージドキーは自動ローテーションがオプションであり、手動で管理できます。
KMSキーの詳細については、以下のAWSドキュメントを参照してください。
OSディスクとIDディスクの暗号化には、次のいずれかを構成します。
  • 暗号化された準備済みイメージを使用します（例：KMSキーで暗号化されたEBSルートボリュームを含むインスタンスまたはスナップショットから作成されたAMI）。
  • 暗号化されたEBSルートボリュームを含むマシンプロファイルソース（VMまたは起動テンプレート）を使用します。

制限事項

次の制限事項を考慮してください。
  • MCSは現在、準備済みイメージAMI上のディスクを1つのみサポートしています。
  • 既存の暗号化されていないEBSボリュームやスナップショットを直接暗号化したり、既存の暗号化されたボリュームのKMSキーを変更したりすることはできません。これを行うには、次の手順を実行する必要があります。
    1. そのボリュームの新しいスナップショットを作成します。
    2. そのスナップショットから新しいボリュームを作成します。
    3. 新しいボリュームを暗号化します。
以下のAWSドキュメントを参照してください。

ディスク暗号化を使用してカタログを作成する

ディスク暗号化を使用して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セキュアブートが有効なカタログが必要な場合は、新しいカタログを作成してください。

主要な手順

  1. AWS環境をセットアップします。
  2. AWSへの接続を作成します。
  3. NitroTPMおよび/またはUEFIセキュアブートが有効なマスターイメージ（AMI）を作成する(#create-an-ami-that-supports-nitrotpm-and-uefi-secure-boot)。
  4. マスターイメージから準備済みイメージを作成します。詳細については、「Amazon WorkSpaces Coreマネージドインスタンス用の準備済みイメージを作成する」(/ja-jp/citrix-daas/install-configure/create-prepared-image-amazon-wsc.html)を参照してください。
  5. Citrix Studioのカタログ作成メニューでNitroTPMおよびUEFIセキュアブートが有効な準備済みイメージを選択するか、PowerShellコマンドを使用してプロビジョニングスキームを作成することで、マシンカタログを作成します。
作成されたカタログに追加されたVMは、NitroTPMおよびUEFIセキュアブートが有効になっています。

NitroTPMおよびUEFIセキュアブートをサポートするAMIを作成する

  1. NitroTPMおよび/またはUEFIセキュアブートが有効になっているVMからAMIを作成できます。
    1. AWS Marketplaceイメージを使用してインスタンスを作成します。例：TPM-Windows_Server-2022-English-Full-Base on the aws-marketplaceを検索します。
    2. シングルセッションまたはマルチセッションVDAをダウンロードします。
    3. そのVMからAMIを作成します。
  2. register-imageコマンドを使用します。
    --boot-mode (string)
    --tpm-support (string)
    詳細については、register-imageを参照してください。
以下のAWSドキュメントを参照してください。
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
  • テンプレートが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

既存のカタログのサービス提供を更新する

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: 直後のアイテムを返します (または ForwardDirection が false の場合は直前のアイテムを)。ただし、ContinuationToken で指定されたアイテムは含みません。
ページネーションの例:
  • 最も低い名前を持つマシンのテンプレートの単一レコードを返すには。AdditionalData フィールドには TotalItemsCount と TotalFilteredItemsCount があります。
    Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
  • 最も低い名前を持つマシンのテンプレートのレコードを10件返すには:
    Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
  • 最も高い名前で終わるレコードの配列を返すには:
    Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
  • 指定された ContinuationToken に関連付けられたマシンテンプレートから始まるレコードの配列を返すには:
    Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
フィルタリング:
フィルタリングには、以下の追加のオプションパラメーターがサポートされています。これらのパラメーターは、ページネーションオプションと組み合わせることができます。
  • -ContainsName "my_name": 指定された文字列がAMI名の一部と一致する場合、そのAMIは Get の結果に含まれます。例:
    Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
  • -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': これらのタグのいずれかを少なくとも1つ持つAMIは、Get の結果に含まれます。例:
    Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
    注:
    2つのタグ値がサポートされています。Not Tagged タグ値は、タグのリストに指定されたタグがない項目に一致します。All values タグ値は、タグの値に関係なく、そのタグを持つ項目に一致します。それ以外の場合、一致は、項目がタグを持ち、その値がフィルターで指定された値と等しい場合にのみ発生します。
  • -Id "ami-0a2d913927e0352f3": AMIが指定されたIDに一致する場合、Get の結果に含まれます。例:
    Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx
AdditionalDataパラメーターでのフィルタリング:
AdditionalData フィルターパラメーターは、テンプレートまたはVMを、その機能、サービス提供、またはAdditionalDataにある任意のプロパティに基づいて一覧表示します。例:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
互換性のないVMを示すために、-Warn パラメーターを追加することもできます。VMは、Warning という名前のAdditionalData フィールドとともに含まれます。例:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData

次のステップ

  • 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を参照してください。