Amazon WorkSpaces Core マネージドインスタンス用の準備済みイメージを作成する

最終公開日 : Nov 13, 2026
MCS マシンカタログを作成するために、準備済みイメージを作成します。準備済みイメージは、次の方法で作成できます。
Related information
準備済みイメージのマシンカタログを作成する

主な手順

  1. イメージ定義と初期イメージバージョンを作成します。
  2. 初期イメージバージョンからイメージバージョンを作成します。

Web Studio を使用する

イメージ定義と初期イメージバージョンを作成する

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

イメージバージョンを作成する

イメージバージョンを使用すると、特定のイメージに対するさまざまなイテレーションや更新を管理できます。この機能により、さまざまな目的のためにイメージの複数のバージョンを維持できます。
初期イメージバージョンからイメージバージョンを作成するには、次の手順を実行します。
注:
すべてのイメージバージョンのホスティングユニットは同じである必要があります。
  1. 「Images」ノードに移動し、イメージバージョンまたはイメージ定義を選択して、「Create Image Version」をクリックします。
  2. 「Image definition」ページで、ホスティングユニットを変更し、そのイメージバージョンのマスターイメージとマシンプロファイルを再選択できます。
  3. イメージバージョンの構成を初期構成イメージバージョンと異なるものにする場合は、「Create Image Version」ダイアログの「Machine Specification」ページと「NICs」ページで設定を構成します。
  4. イメージバージョンの説明を追加します。「Finish」をクリックします。
注:
何らかの理由でイメージバージョンの作成に失敗した場合、下部にあるトラブルシューティングタブに再試行オプションが表示されます。

PowerShell を使用する

準備済みイメージバージョン仕様を作成するための詳細な PowerShell コマンドは次のとおりです。
  1. Test-ProvImageDefinitionNameAvailable command を使用して、利用可能なイメージ定義名を確認します。例:
    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
  2. New-ProvImageDefinition コマンドを使用してイメージ定義を作成します。例:
    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
  3. Add-ProvImageDefinitionConnection コマンドを使用して、指定されたホスティング接続でイメージ定義の新しい構成を作成します。
    Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
  4. New-ProvImageVersion コマンドを使用してイメージバージョンを作成します。例:
    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
  5. Add-ProvImageVersionSpec コマンドを使用して、マスターイメージバージョン仕様をイメージバージョンに追加します。例:
    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"
    注:
    ホスティングユニットのイメージバージョンには、マスターイメージバージョン仕様を1つだけ追加できます。
  6. 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
注:
  • イメージ定義内のすべてのイメージバージョン仕様は、同じホスティングユニットに属している必要があります。
  • イメージバージョンには、マスターイメージバージョン仕様を1つ、準備済みイメージバージョン仕様を1つだけ含めることができます。
  • すべてのイメージバージョン仕様には、マシンプロファイルが必要です。

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

Amazon WorkSpaces Core マネージドインスタンスの場合、同じ 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アカウント内での共有: 現在の実装では、異なるAWSアカウント間での共有はできません。

重要な考慮事項

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

前提条件

この機能を構成または使用する前に、以下の条件を満たしていることを確認してください。
  • お使いの環境は、Amazon WorkSpaces Core Managed Instances環境である必要があります。
  • 同じAWSアカウントで、複数のホスティングユニット（それぞれ異なるアベイラビリティゾーンに紐付け可能）とホスト接続（それぞれ異なるリージョンに紐付け可能）を構成する必要があります。

Web Studio UI を使用して構成する

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

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

  1. Web Studio の Images ノードに移動し、他のアベイラビリティゾーンと共有したい準備済みイメージのバージョンを選択します。
  2. 上部のナビゲーションバーでイメージ共有の管理を選択し、選択したイメージバージョンのイメージ共有を管理します。
  3. Manage Image Share ページで、イメージバージョンを共有したいリソースを1つ以上選択します。リソースは、元のイメージバージョンとは異なるアベイラビリティゾーンに存在できます。
  4. 保存をクリックして、他のアベイラビリティゾーンのリソースでイメージバージョンを共有します。イメージバージョンは、選択した異なるリソース間で共有されるように更新されます。完了したら、イメージバージョンが共有されているアベイラビリティゾーンでカタログを作成するために、そのイメージバージョンを使用します。

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

  1. Web Studio の Images ノードで、共有を解除したい準備済みイメージのバージョンを選択します。
  2. 上部のナビゲーションバーでイメージ共有の管理を選択し、選択したイメージバージョンのイメージ共有を管理します。
  3. イメージバージョンの共有を停止したい1つ以上のリソース（アベイラビリティゾーン）のチェックボックスをオフにします。
    注:
    共有イメージバージョンに関連付けられ、そこから作成されたカタログが、リソースに存在しないようにする必要があります。削除する共有イメージバージョンから作成されたカタログは、まず削除する必要があります。
  4. 「保存」をクリックして、クリアされたアベイラビリティゾーン全体でのリソースの共有を削除します。イメージバージョンが更新され、それらのアベイラビリティゾーンでは共有されなくなります。

PowerShell を使用して構成する

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

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

  1. 共有する準備されたイメージの ImageVersionSpecUid を持っていることを確認します。これは、PowerShell で Get-ProvImageVersionSpec または同様の Get- コマンドを使用して取得できます。
  2. 準備されたイメージを利用可能にするアベイラビリティゾーン (同じリージョンでも異なるリージョンでもかまいません) の HostingUnitName を特定します。これは、その特定のアベイラビリティゾーン用に構成したホスティングユニットの名前です。
  3. 「Add-ProvImageVersionSpecHostingUnit コマンドを実行します:」次の PowerShell コマンドを使用します。<ImageVersionSpecUid> をイメージの Uid に、<targetHostingUnitName> を、イメージバージョン仕様を共有するターゲットアベイラビリティゾーンのホスティングユニット名に置き換えます。
    Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
  4. 実行が成功すると、Web Studio UI でイメージのステータスが表示され、指定されたホスティングユニットと共有されたことが示されます。

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

  1. 共有を削除したい準備されたイメージの ImageVersionSpecUid を持っていることを確認します。
  2. 共有イメージを削除したいアベイラビリティゾーンの HostingUnitName を特定します。
  3. 「Remove-ProvImageVersionSpecHostingUnit コマンドを実行します:」次の PowerShell コマンドを使用します。<ImageVersionSpecUid> をイメージの Uid に、<targetHostingUnitName> を、イメージバージョン仕様の共有を削除するターゲットアベイラビリティゾーンのホスティングユニット名に置き換えます。
    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

次のステップ

詳細情報

  • イメージ管理
  • Amazon WorkSpaces Core の GitHub PowerShell の例については、citrix-mcs-sdk-samples-Amazon WorkSpaces Coreを参照してください。