製品ドキュメント

Citrix DaaS™

PDFを表示

Amazon WorkSpaces Core マネージドインスタンスで準備済みイメージを使用してカタログを作成

May 4, 2026

寄稿者:

C C

準備済みイメージを作成し、その準備済みイメージを使用して、次の方法でMCSマシンカタログを作成します。
Studio
PowerShell

主要な手順

イメージ定義と初期イメージバージョンを作成します。
初期イメージバージョンからイメージバージョンを作成します。
イメージバージョンを準備済みイメージとして使用してカタログを作成します。

Studio を使用したイメージ定義と初期イメージバージョンの作成

イメージ定義と初期イメージバージョンを作成するには、次の手順を実行します。

Studio から、[イメージ] ノードに移動し、[イメージ定義の作成] をクリックします。[はじめに] ページで [次へ] をクリックします。
[イメージ定義] ページで、イメージ定義の [OSタイプ] と [セッションタイプ] を指定します。
[イメージ] ページで、[リソース] (設定された接続に適用可能なリソースのみが一覧表示されます)、イメージバージョン作成のテンプレートとして使用するマスターイメージ、およびハードウェアプロパティをキャプチャするためのマシンプロファイルを選択します。VMインスタンスまたは起動テンプレートバージョンからハードウェアプロパティをキャプチャするためのマシンプロファイルを選択します。
注：
- イメージを選択する前に、マスターイメージにVDA 2311以降がインストールされており、MCSIOドライバーがVDAにインストールされていることを確認してください。
- Instance Metadata Service (IMDS) V2のみがサポートされており、IMDS V1はサポートされていません。詳細については、「How Instance Metadata Service Version 2 works」を参照してください。
[マシン仕様] ページで、マシンサイズを選択します。マシンプロファイル ( [イメージ] ページで選択) のマシンサイズがデフォルトで選択されています。
[NIC] ページで、準備済みイメージのNICを選択または追加します。各NICについて、関連するVPCサブネットを選択します。
[バージョン説明] ページで、作成された初期イメージバージョンの説明を入力します。
[概要] ページで、イメージ定義と作成された初期イメージバージョンの詳細を確認します。イメージ定義の名前と説明を入力します。[完了] をクリックします。

Studio を使用したイメージバージョンの作成

イメージバージョンを使用すると、特定のイメージに対するさまざまなイテレーションや更新を管理できます。この機能により、さまざまな目的のために複数のイメージバージョンを維持できます。

初期イメージバージョンからイメージバージョンを作成するには、次の手順を実行します。

注：

すべてのイメージバージョンのホスティングユニットは同じである必要があります。

[イメージ] ノードに移動し、イメージバージョンまたはイメージ定義を選択して、[イメージバージョンの作成] をクリックします。
[イメージ定義] ページで、そのイメージバージョンのホスティングユニットを変更し、マスターイメージとマシンプロファイルを再選択できます。
イメージバージョンの構成を最初に構成されたイメージバージョンと異なるものにする場合は、[イメージバージョンの作成] ダイアログの [マシン仕様] および [NIC] ページで設定を構成します。
イメージバージョンの説明を追加します。[完了] をクリックします。

注：

何らかの理由でイメージバージョンの作成に失敗した場合、下部にある [トラブルシューティング] タブに [再試行] オプションが表示されます。

PowerShell を使用した準備済みイメージバージョンスペックの作成

準備済みイメージバージョンスペックを作成するための詳細なPowerShellコマンドは次のとおりです。

Test-ProvImageDefinitionNameAvailable コマンドを使用して、利用可能なイメージ定義名を確認します。例：
```
Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>


```

New-ProvImageDefinition コマンドを使用してイメージ定義を作成します。例：

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession

<!--NeedCopy-->

Add-ProvImageDefinitionConnection コマンドを使用して、指定されたホスティング接続でイメージ定義の新しい構成を作成します。
```
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn


```
New-ProvImageVersion コマンドを使用してイメージバージョンを作成します。例：
```
New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"


```

<ImageVersionSpecUid> <ImageVersionSpecUid>

Add-ProvImageVersionSpec コマンドを使用して、マスターイメージバージョンスペックをイメージバージョンに追加します。例：
```
Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"


```
注：

ホスティングユニットの1つのイメージバージョンには、1つのマスターイメージバージョンスペックのみを追加できます。

1. New-ProvImageVersionSpec コマンドを使用して、マスターイメージバージョンスペックから準備済みイメージバージョンスペックを作成します。SourceImageVersionSpecUid パラメーターは Add-ProvImageVersionSpec コマンドから派生します。例：
```
 New-ProvImageVersionSpec
 -  -SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
 -  -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously

 
```

イメージ定義、イメージバージョン、および準備済みイメージバージョンスペックを作成するためのPowerShellコマンドの完全なセットの例：

-  New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 
 
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName wsc -CustomProperties $CustomProperties
 
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
 
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
-MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template"
 
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
`Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc`
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid

<!--NeedCopy-->

注：

イメージ定義内のすべてのイメージバージョンスペックは、同じホスティングユニットに属している必要があります。

イメージバージョンには、マスターイメージバージョンスペックを1つ、準備済みイメージバージョンスペックを1つのみ含めることができます。

すべてのイメージバージョンスペックにはマシンプロファイルが必要です。

アベイラビリティゾーンとリージョン間で準備済みイメージを共有

Amazon WorkSpaces Core Managed Instancesの場合、単一の準備済みイメージを、同じAWSリージョン内または異なるリージョン内の異なるホスティングユニットに紐付けられた複数のアベイラビリティゾーン間で共有できるようになりました。これにより、1つの準備済みイメージを使用して、さまざまなアベイラビリティゾーンとリージョンでMCSマシンカタログを作成および更新できます。異なるリージョンの異なるAZ間で共有する場合、準備済みイメージのバージョンは元のリージョンから宛先リージョンにコピーされます。

単一の準備済みイメージを維持し、それを使用して、異なるホスティングユニットに紐付けられた複数のアベイラビリティゾーンとリージョン間でマシンカタログを作成および更新できます。これにより、イメージ管理のオーバーヘッドが大幅に削減され、デプロイ全体の一貫性が確保され、プロビジョニングプロセスが効率化されます。また、異なるアベイラビリティゾーンまたはリージョンからの準備済みイメージを使用して、既存のマシンカタログをシームレスに更新することもできます。

ユースケース

集中型イメージ管理: 1つのアベイラビリティゾーン（例: us-east-1a）で準備済みイメージを作成します。このイメージを、同じus-east-1 AWSリージョン内のus-east-1bのような他のアベイラビリティゾーンや、異なるus-west-1リージョン内のus-west-1aに共有できます。これにより、単一のイメージで複数のホスティングユニットに対応でき、メンテナンスが簡素化されます。
効率的なカタログ作成と更新: AZ 1（例: us-east-1a）で作成された準備済みイメージを使用して、AZ 1に新しいカタログを作成できます。このイメージをAZ 2（例: us-east-1b）に共有した後、AZ 2で共有されたイメージを使用して、AZ 2にカタログを作成および更新できます。
クロスホスティングユニットおよびホスティング接続のデプロイ: 環境に同じまたは異なるAWSリージョンに複数のホスティングユニットがある場合、これらのホスティングユニット間で準備済みイメージを効率的に共有できます。

制限事項

同じAWSアカウント内での共有: 現在の実装では、異なるAWSアカウント間での共有はできません。

重要な考慮事項

削除順序: 元の準備済みイメージのバージョン仕様を削除するには、まずその共有イメージのバージョン仕様をすべて削除する必要があります。または、元の仕様と共有仕様を同時に削除する必要があります。
イメージバージョンの依存関係: イメージバージョンを削除する場合、まずその特定のイメージバージョンに依存する共有構成をすべて削除する必要があります。元の（共有されていない）イメージから作成されたカタログはそのまま残すことができます。
カタログのバックポータビリティ: この機能の導入前にデプロイした既存のマシンカタログを更新できます。カタログを最初にデプロイしたアベイラビリティゾーンまたはリージョンとは異なる場所で作成された準備済みイメージを使用します。
完全な削除: 準備済みイメージを削除すると、共有または元々作成されたどのアベイラビリティゾーンでも使用できなくなります。さらに、準備済みイメージバージョンに紐付けられたすべてのカタログが最初に削除されるまで、準備済みイメージバージョンを削除することはできません。

前提条件

この機能を構成または使用する前に、以下の条件を満たしていることを確認してください。

環境がAmazon WorkSpaces Core Managed Instances環境であること。
同じAWSアカウントの下に、複数のホスティングユニット（それぞれ異なるアベイラビリティゾーンに紐付け可能）とホスト接続（それぞれ異なるリージョンに紐付け可能）が構成されていること。

Studio UIを使用した構成

Studio UIを使用して、異なるホスティングユニットに紐付けられたアベイラビリティゾーン間で準備済みイメージを共有できます。

準備済みイメージを共有する

Studioのイメージノードに移動し、他のアベイラビリティゾーンと共有したい準備済みイメージバージョンを選択します。
上部のナビゲーションバーでイメージ共有の管理を選択し、選択したイメージバージョンのイメージ共有を管理します。

1. イメージ共有の管理ページで、イメージバージョンを共有したいリソースを1つ以上選択します。リソースは、元のイメージバージョンとは異なるアベイラビリティゾーンにある場合があります。

保存をクリックして、他のアベイラビリティゾーンのリソース間でイメージバージョンを共有します。イメージバージョンは、選択した異なるリソース間で共有されるように更新されます。完了したら、イメージバージョンが共有されているアベイラビリティゾーンでカタログを作成するためにイメージバージョンを使用します。

準備済みイメージの共有を削除する

1. Studioのイメージノードで、共有を解除したい準備済みイメージバージョンを選択します。
1. 上部のナビゲーションバーでイメージ共有の管理を選択し、選択したイメージバージョンのイメージ共有を管理します。
1. イメージバージョンの共有を停止したい1つ以上のリソース（アベイラビリティゾーン）のチェックボックスをオフにします。
注:

リソースには、共有されたイメージバージョンに関連付けられ、それから作成されたカタログが残っていない必要があります。削除される共有イメージバージョンから作成されたカタログは、まず削除する必要があります。

保存をクリックして、チェックボックスがオフになったアベイラビリティゾーンのリソースの共有を削除します。イメージバージョンは、それらのアベイラビリティゾーンで共有されなくなるように更新されます。

PowerShellを使用した構成

または、PowerShellコマンドを使用して、異なるホスティングユニットに紐付けられたアベイラビリティゾーン間で準備済みイメージを共有できます。

準備済みイメージを共有する

共有したい準備済みイメージのImageVersionSpecUidがあることを確認します。これは、PowerShellのGet-ProvImageVersionSpecまたは同様のGet-コマンドを使用して取得できます。
準備済みイメージを利用可能にしたいアベイラビリティゾーン（同じリージョンまたは異なるリージョンでも可）のHostingUnitNameを特定します。これは、その特定のAZ用に構成したホスティングユニットの名前です。
Add-ProvImageVersionSpecHostingUnitコマンドを実行します。 次のPowerShellコマンドを使用します。<ImageVersionSpecUid>をイメージのUidに、<targetHostingUnitName>をイメージバージョン仕様を共有したいターゲットアベイラビリティゾーンのホスティングユニットの名前に置き換えます。
```
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>


```
正常に実行されると、Studio UIでイメージのステータスが、指定されたホスティングユニットと共有されていることを示します。

準備済みイメージの共有を削除する

共有を解除したい準備済みイメージのImageVersionSpecUidがあることを確認します。
共有イメージを削除したいアベイラビリティゾーンのHostingUnitNameを特定します。
Remove-ProvImageVersionSpecHostingUnitコマンドを実行します。 次のPowerShellコマンドを使用します。<ImageVersionSpecUid>をイメージのUidに、<targetHostingUnitName>をイメージバージョン仕様の共有を解除したいターゲットアベイラビリティゾーンのホスティングユニットの名前に置き換えます。
```
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>


```

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

イメージ準備中、元の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は、共有テナンシー（デフォルトタイプ）と専用テナンシーという、次のテナンシーオプションを提供します。共有テナンシーとは、異なる顧客の複数の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起動テンプレートバージョンを使用できます。

注記:

現在、永続VMと非永続VMの両方のカタログの作成（CleanOnBootプロパティがTrueまたはFalse）がサポートされています。

Amazon WorkSpaces Core マネージドインスタンスのカタログを作成する前に、以下を作成しておく必要があります:

Amazon WorkSpaces Core マネージドインスタンスへの接続。詳しくは、「Connection to Amazon WorkSpaces Core Managed Instances」を参照してください。
準備済みイメージ。

カタログは以下を使用して作成できます:
Studio
PowerShell

Studioを使用したカタログの作成

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

イメージノードのカタログの作成オプションを使用して、イメージバージョンを使用してカタログを作成します。

または、マシンカタログノードでカタログを作成する際にバージョンを選択し、カタログ作成ワークフローで準備済みイメージオプションにリンクすることもできます。詳しくは、「マシンカタログノードからのマシンカタログの作成」を参照してください。

イメージノードからMCSマシンカタログを作成するには、次の手順を実行します:

イメージバージョンを選択し、カタログの作成をクリックします。はじめにページで次へをクリックします。

1. マシン管理ページとイメージページでは、選択したイメージバージョンに基づいて設定が事前に選択されています。イメージページで、選択した準備済みイメージのメモを入力します。

次のページで設定を完了します。
概要ページで、マシンカタログの詳細を確認します。マシンカタログの名前と説明を入力します。完了をクリックします。
マシンカタログノードに移動して、作成されたマシンカタログを表示します。

マシンカタログノードからのマシンカタログの作成

マシンカタログノードからMCSマシンカタログを作成するには、次の手順を実行します:

左側のナビゲーションペインでマシンカタログをクリックします。
マシンカタログの作成をクリックします。マシンカタログのセットアップページが表示されます。
マシンタイプページで、カタログのマシンタイプを選択します。たとえば、マルチセッションOSなど。
マシン管理ページで、次の設定を選択します:

1. 電源管理されているマシン（仮想マシンやブレードPCなど）を選択します。
2. Citrixプロビジョニングテクノロジーを選択します。次に、Citrix Machine Creation Services™を選択します。
3. リソースフィールドで、ホスト接続の作成時に構成したリソース（アベイラビリティゾーンまたはローカルゾーン）を選択し、次へをクリックします。

デスクトップエクスペリエンスページで、ユーザーがログオンしたときに使用するランダムまたは静的デスクトップを選択します。静的デスクトップが選択されている場合は、ユーザーがローカルディスクで行った変更を保存するかどうか（永続的または非永続的）をさらに指定します。
イメージページで、イメージの選択をクリックして、マシンカタログの準備済みイメージを選択します。作成した準備済みバージョンを選択します。イメージバージョン名をクリックします。選択したイメージバージョンの詳細を表示するには、下線が引かれているバージョン番号をクリックします。完了をクリックします。

準備されたイメージに関連付けられたマシンプロファイルが表示され、そのハードウェアプロパティ（例：インスタンスタイプ、テナンシータイプ、ネットワークマッピング、セキュリティグループ、ボリュームプロパティ）がカタログ内のマシンを作成するために使用されます。マシンプロファイルのソースを別のVMまたは起動テンプレートバージョンに変更するには、編集ボタンをクリックします。
仮想マシンページで:
1. カタログのVM数を入力します。
2. マシンプロファイルに基づいたデフォルトのマシン仕様が表示されます。これを変更するには、編集アイコンを選択し、マシン仕様を選択します。
NICページで、VMのNIC（またはENI）を選択します。
マシンIDページで、カタログ内のマシンのマシンIDタイプを設定します:
1. ドメイン参加済みマシン（オンプレミスActive DirectoryまたはMicrosoft Entraハイブリッド参加済み）を設定するには、ドメインを選択し、このマシンカタログで作成されるVM用の新しいADアカウントを作成します。プロビジョニングされたVMは、選択されたドメインに参加します。ドメイン非参加マシンをプロビジョニングするには、ドメイン非参加オプションを選択します。
2. 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を介して課金モードを指定するには、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

 
```

カタログ内の新規および既存のVMの課金モードを更新するには、更新されたカスタムプロパティを持つ新しいプロビジョニングスキームバージョンを作成し、新しいバージョンをすべてのVMに適用します:

 $custprop = "BillingMode,Hourly"

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

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

 <!--NeedCopy-->

課金情報の監視

カタログおよび個々の仮想マシンの課金モードを確認できます。

アカウントの課金資格を確認するには、以下のPowerShellコマンドを実行します。

BillingMode をカスタムプロパティの一部として返します。

 -  Get-ProvScheme –ProvisioningSchemeName “"MyCatalog" "  | Select  ProvisioningSchemeName,  CustomProperties

 <!--NeedCopy-->

BillingMode をVM情報の一部として返します。

 -  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コマンドのパラメータとして提供されていない場合、適切なエラーが発生します。

起動テンプレートバージョンをマシンプロファイル入力として使用してカタログを作成するには：

1. 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”
```

プロビジョニングスキームをブローカーカタログとして登録します。例：

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 単位で指定する。これはオプションのパラメーターである

注記:

少なくとも 1 GB のキャッシュディスクストレージが必要なため、WriteBackCacheDiskSize の値はゼロより大きい必要がある。キャッシュディスクサイズは OS ディスクサイズより大きくしてはならない

WriteBackCacheMemorySize の値はゼロ以外で、マシンカタログのメモリサイズより小さい必要がある

MCSIO に影響するカスタムプロパティは次のとおりです。

WBCDiskStorageType: Amazon WorkSpaces Core マネージドインスタンスの一時ディスクに使用されるボリュームタイプを定義する。このパラメーターは volume-type[:iops][:throughput] の形式で文字列引数を取る。ボリュームタイプは次のとおりである
- gp2: このボリュームタイプには iops および throughput パラメーターを使用しない
- gp3: このボリュームタイプには iops および throughput パラメーターを使用する
- io1: このボリュームタイプには iops パラメーターのみを使用する
- io2: このボリュームタイプには iops パラメーターのみを使用する
デフォルトのボリュームタイプは gp2 である
PersistWBC: Amazon WorkSpaces Core マネージドインスタンスの電源がオフになったときに、キャッシュディスクを保持するか破棄するかを制御する。true に設定すると、キャッシュディスクは保持される。false（デフォルト）に設定すると、キャッシュディスクは AMI インスタンスの電源がオンになっている間のみ作成および保持される
PersistOSDisk: Amazon WorkSpaces Core マネージドインスタンスの電源がオフになったときに、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 ディスクの暗号化

OS ディスクと ID（Identity Disk）を暗号化するために使用できる AWS KMS キー（カスタマーマネージドキーと AWS マネージドキー）を使用して、VM のカタログを作成できます。

AWS マネージドキーは毎年自動的にローテーションされる
カスタマーマネージドキーは自動ローテーションがオプションであり、手動で管理できる

KMS キーの詳細については、以下の AWS ドキュメントを参照してください。

OS ディスクと ID ディスクの暗号化には、次のいずれかを構成します。

暗号化された準備済みイメージを使用する（例：KMS キーで暗号化された EBS ルートボリュームを含むインスタンスまたはスナップショットから作成された AMI）
暗号化された EBS ルートボリュームを含むマシンプロファイルソース（VM または起動テンプレート）を使用する

制限事項

次の制限事項を考慮してください。

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

以下の 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のカタログ作成メニューで、またはPowerShellコマンドを使用してプロビジョニングスキームを作成する際に、NitroTPMおよびUEFIセキュアブートが有効な準備済みイメージを選択してマシンカタログを作成します。

作成されたカタログに追加されたVMは、NitoTPMおよびUEFIセキュアブートが有効になります。

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

NitroTPMおよび/またはUEFIセキュアブートが有効なVMからAMIを作成できます。
1. AWSマーケットプレイスイメージを使用してインスタンスを作成します。例として、TPM-Windows_Server-2022-English-Full-Base on the aws-marketplaceを検索します。
2. シングルセッションまたはマルチセッションVDAをダウンロードします。
3. そのVMからAMIを作成します。
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

 <!--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

 
```

最も名前の小さいマシンのテンプレートの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

 
```
注:

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 GitHub PowerShellの例については、citrix-mcs-sdk-samples-Amazon WorkSpaces Core を参照してください。

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

この情報は役に立ちましたか?

Amazon WorkSpaces Core マネージドインスタンスで準備済みイメージを使用してカタログを作成

May 4, 2026

寄稿者:

C C

May 4, 2026

寄稿者:

C C

この記事の概要

主要な手順
Studio を使用したイメージ定義と初期イメージバージョンの作成
PowerShell を使用した準備済みイメージバージョンスペックの作成
アベイラビリティゾーンとリージョン間で準備済みイメージを共有
イメージ準備中のネットワーク設定
マシンプロファイルベースのマシンカタログ
AWSテナンシー
柔軟な課金
カタログの作成
Studioを使用したカタログの作成
PowerShellを使用したカタログの作成
MCSIO対応カタログ
OS ディスクと ID ディスクの暗号化
VMインスタンスのNitroTPMおよびUEFIセキュアブートを有効にする
VM上のタグをコピーする
PowerShellを使用したVMインスタンスのフィルタリング
次のステップ
詳細情報

この情報は役に立ちましたか?