Amazon WorkSpaces Core マネージドインスタンスのカタログ作成
マシンカタログの作成は、マシンカタログを作成するウィザードについて説明しています。以下の情報は、Amazon WorkSpaces Core マネージドインスタンスに固有の詳細を扱います。
注：
現在、永続VMと非永続VMの両方（
CleanOnBootプロパティがTrueまたはFalse）のカタログ作成がサポートされています。
前提条件
Amazon WorkSpaces Core マネージドインスタンスのカタログを作成する前に、以下を完了する必要があります。
- Amazon WorkSpaces Core マネージドインスタンスへの接続。 Amazon WorkSpaces Core マネージドインスタンスへの接続を参照してください。
- 準備されたイメージ。 Amazon WorkSpaces Core マネージドインスタンス用の準備されたイメージの作成を参照してください。
イメージ準備中のネットワーク設定
イメージの準備中に、元のVMに基づいて準備用仮想マシン（VM）が作成されます。この準備用VMはネットワークから切断されます。準備用VMからネットワークを切断するために、すべてのインバウンドおよびアウトバウンドトラフィックを拒否するネットワークセキュリティグループが作成されます。このネットワークセキュリティグループは永続的であり、再利用されます。ネットワークセキュリティグループの名前はCitrix.XenDesktop.IsolationGroup-GUIDで、GUIDはランダムに生成されます。
マシンプロファイルベースのマシンカタログ
マシンプロファイルを使用して、EC2インスタンス（VM）または起動テンプレートバージョンからハードウェアプロパティをキャプチャし、プロビジョニングされたマシンに適用できます。キャプチャされるプロパティには、例えば、テナンシータイプ、インスタンスタイプ、セキュリティグループ、ネットワークマッピング、EBSボリュームプロパティ、EBS最適化、CPUオプション、ハイバネーション機能、およびその他のサポートされているAWS構成が含まれます。
マシンプロファイルの入力として、AWS EC2インスタンス（VM）またはAWS起動テンプレートバージョンを使用できます。
-
注：
-
- EBSボリュームプロパティは、マシンプロファイルからのみ派生します。
- インスタンスメタデータサービス（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 マネージドインスタンスのカタログを作成するには、準備されたイメージとマシンプロファイルが必要です。マシンプロファイルの入力として、AWS VMインスタンスまたはAWS起動テンプレートバージョンを使用できます。
カタログは以下を使用して作成できます。
Studioを使用したカタログの作成
イメージノードからのマシンカタログの作成
Imagesノードのカタログの作成オプションを使用して、イメージバージョンを使用してカタログを作成します。
または、Machine Catalogsノードでカタログを作成する際にバージョンを選択し、カタログ作成ワークフローで準備されたイメージオプションにリンクすることもできます。Machine Catalogsノードからのマシンカタログの作成を参照してください。
ImagesノードからMCSマシンカタログを作成するには、次の手順を実行します。
-
- イメージバージョンを選択し、カタログの作成をクリックします。Introductionページで次へをクリックします。
-
- Machine ManagementページとImageページでは、選択したイメージバージョンに基づいて設定が事前に選択されています。Imageページで、選択した準備済みイメージのメモを入力します。
-
- 次のページで設定を完了します。
-
- Summaryページで、マシンカタログの詳細を確認します。マシンカタログの名前と説明を入力します。完了をクリックします。
-
- Machine Catalogsノードに移動して、作成されたマシンカタログを確認します。
Machine Catalogsノードからのマシンカタログの作成
Machine CatalogsノードからMCSマシンカタログを作成するには、次の手順を実行します。
- 左側のナビゲーションペインでMachine Catalogsをクリックします。
-
- マシンカタログの作成をクリックします。マシンカタログのセットアップページが表示されます。
- Machine Typeページで、カタログのマシンタイプ（例：Multi-session OS）を選択します。
-
Machine Managementページで、次の設定を選択します。
- 電源管理されているマシン（仮想マシンやブレードPCなど）を選択します。
- Citrixプロビジョニングテクノロジーを選択します。次に、Citrix Machine Creation Services™を選択します。
- リソースフィールドで、ホスト接続の作成時に構成したリソース（アベイラビリティゾーンまたはローカルゾーン）を選択し、次へをクリックします。
- Desktop experienceページで、ユーザーがログイン時に使用するランダムデスクトップまたは静的デスクトップのいずれかを選択します。静的デスクトップが選択されている場合は、ユーザーがローカルディスクで行った変更を保存するかどうか（永続的または非永続的）をさらに指定します。
-
Imageページで、イメージの選択をクリックして、マシンカタログ用の準備済みイメージを選択します。作成した準備済みバージョンを選択します。イメージバージョン名をクリックします。選択したイメージバージョンの詳細を表示するには、下線が引かれているバージョン番号をクリックします。完了をクリックします。
準備済みイメージに関連付けられたマシンプロファイルが表示され、そのハードウェアプロパティ（例：インスタンスタイプ、テナンシータイプ、ネットワークマッピング、セキュリティグループ、ボリュームプロパティ）がカタログ内のマシンを作成するために使用されます。マシンプロファイルのソースを別のVMまたは起動テンプレートバージョンに変更するには、編集ボタンをクリックします。
-
Virtual Machinesページで：
- カタログのVM数を入力します。
- デフォルトのマシン仕様が表示されます。これはマシンプロファイルに基づいています。変更するには、編集アイコンを選択し、マシン仕様を選択します。
- NICsページで、VMのNIC（またはENI）を選択します。
-
Machine Identitiesページで、カタログ内のマシンのマシンIDタイプを構成します。
- ドメイン参加済みマシン（オンプレミスActive DirectoryまたはMicrosoft Entraハイブリッド参加）を構成するには、ドメインを選択し、このマシンカタログで作成されるVM用の新しいADアカウントを作成します。プロビジョニングされたVMは、選択したドメインに参加します。ドメイン非参加マシンをプロビジョニングするには、ドメイン非参加オプションを選択します。
- VM用に作成される新しいアカウントのアカウント命名スキームを指定します。
- 「ドメイン資格情報」ページで、「資格情報の入力」をクリックして、選択したドメインの資格情報を提供します。プロンプトが表示されたら、管理者レベルのユーザー名とパスワードを入力します。以前にドメイン資格情報を保存している場合は、当社の製品ドキュメントに従ってサービスアカウントを使用することもできます。
- 残りのページをクリックして「概要」ページまで進みます。マシンカタログの名前を入力し、「完了」を選択してマシンカタログを作成します。
AWSローカルゾーンでのマシンカタログ作成に関する制限事項
- 特定のローカルゾーンは特定のハードウェア構成のみをサポートします (例: パースのローカルゾーンはGP3ボリュームをサポートせず、GP2のみをサポート)
- すべてのローカルゾーンでgp2のみが普遍的にサポートされており、すべてがgp3をサポートしているわけではないため、IDディスクの作成はデフォルトでgp2ボリュームタイプを使用
- 目的のローカルゾーンでサポートされているハードウェア仕様を持つマシンプロファイルを選択する必要がある
- 準備されたイメージAMIスナップショットとIDディスクスナップショットは、ローカルゾーンではなくリージョンに配置されるのがデフォルト (AWSのローカルゾーンにおけるEBSスナップショットサポートの可視性に関する制限のため)
- フル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”
-
```
PowerShell を使用した起動テンプレートバージョンでのカタログ作成
起動テンプレートバージョンをマシンプロファイルの入力として使用して、MCS マシンカタログを作成できます。また、マシンプロファイルカタログの入力を VM から起動テンプレートバージョンへ、または起動テンプレートバージョンから VM へと更新することもできます。
AWS EC2 コンソールでは、起動テンプレートのインスタンス構成情報をバージョン番号とともに指定できます。マシンカタログの作成または更新時に、起動テンプレートバージョンをマシンプロファイルの入力として指定すると、そのバージョンの起動テンプレートのプロパティがプロビジョニングされた VDA VM にコピーされます。
-
以下のプロパティは、マシンプロファイルの入力として、または
New-ProvSchemeコマンドまたはSet-ProvSchemeコマンドのパラメーターとして明示的に指定できます。これらのプロパティがNew-ProvSchemeまたはSet-ProvSchemeコマンドで指定されている場合、マシンプロファイルの値よりも優先されます。 - サービスオファリング
-
ネットワーク
-
注:
-
サービスオファリングがマシンプロファイルの起動テンプレートで提供されていない場合、または
New-ProvSchemeコマンドのパラメーターとして提供されていない場合、適切なエラーが発生します。 - 起動テンプレートバージョンをマシンプロファイルの入力として使用してカタログを作成するには:
- PowerShell ウィンドウを開きます。
-
asnp citrix*を実行して、Citrix 固有の PowerShell モジュールをロードします。 -
起動テンプレートの起動テンプレートバージョンの一覧を取得します。例:
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”
```
-
マシンプロファイルカタログの入力を起動テンプレートバージョンから VM へ更新するには:
Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" ` -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm" <!--NeedCopy-->
OS および ID ディスクの暗号化
OS ディスクと ID (Identity Disk) を暗号化するために使用できる AWS KMS キー (カスタマー管理キーおよび AWS 管理キー) を使用して、VM のカタログを作成できます。
- AWS 管理キーは毎年自動的にローテーションされます。
- カスタマー管理キーは自動ローテーションがオプションであり、手動で管理できます。
KMS キーの詳細については、以下の AWS ドキュメントを参照してください:
- [AWS KMS の概念](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys)
- [自動キーローテーションの仕組み](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html#rotate-keys-how-it-works)
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）を作成します
- マスターイメージから準備済みイメージを作成します。Amazon WorkSpaces Coreマネージドインスタンス用の準備済みイメージの作成を参照してください
- Citrix Studioのカタログ作成メニューでNitroTPMおよびUEFIセキュアブートが有効な準備済みイメージを選択するか、PowerShellコマンドを使用してプロビジョニングスキームを作成することで、マシンカタログを作成します
作成されたカタログに追加されたVMは、NitroTPMおよびUEFIセキュアブートが有効になります。
NitroTPMおよびUEFIセキュアブートをサポートするAMIの作成
- NitroTPMおよび/またはUEFIセキュアブートが有効なVMからAMIを作成できます。
- AWS Marketplaceイメージを使用してインスタンスを作成します。例として、
aws-marketplaceでTPM-Windows_Server-2022-English-Full-Baseを検索します - シングルセッションまたはマルチセッションVDAをダウンロードします
- そのVMからAMIを作成します
- AWS Marketplaceイメージを使用してインスタンスを作成します。例として、
-
register-imageコマンドを使用します。
--boot-mode (string) --tpm-support (string) <!--NeedCopy-->詳細については、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 <!--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 フィルターパラメーターは、その機能、サービス提供、またはAdditionalData内の任意のプロパティに基づいてテンプレートまたはVMをリストします。例：
(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」を参照してください。