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

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

主な手順

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

Web Studioを使用する

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

イメージ定義と初期イメージバージョンを作成するには、次の手順を実行します。
  1. Web Studioから、**［イメージ］ノードに移動し、［イメージ定義の作成］をクリックします。［はじめに］ページで［次へ］**をクリックします。
  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. Summary ページで、イメージ定義と作成された初期イメージバージョンの詳細を確認します。イメージ定義の名前と説明を入力します。Finish をクリックします。

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

イメージバージョンを使用すると、特定のイメージに対するさまざまなイテレーションや更新を管理できます。この機能により、さまざまな目的のためにイメージの複数のバージョンを維持できます。
初期イメージバージョンからイメージバージョンを作成するには、次の手順を実行します。
注:
すべてのイメージバージョンのホスティングユニットは同じである必要があります。
  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つのイメージバージョンには、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. 上部のナビゲーションバーでManage Image Shareを選択し、選択したイメージバージョンのイメージ共有を管理します。
  3. Manage Image Shareページで、イメージバージョンを共有したいリソースを1つ以上選択します。これらのリソースは、元のイメージバージョンとは異なるアベイラビリティゾーンに存在できます。
  4. Saveをクリックして、他のアベイラビリティゾーンのリソースでイメージバージョンを共有します。イメージバージョンは、選択した異なるリソース間で共有されるように更新されます。完了したら、イメージバージョンが共有されているアベイラビリティゾーンでカタログを作成するために、そのイメージバージョンを使用します。

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

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

PowerShell を使用した構成

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

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

  1. 共有する準備済みイメージの ImageVersionSpecUid があることを確認します。これは、PowerShell で Get-ProvImageVersionSpec または同様の Get- コマンドを使用して取得できます。
  2. 準備済みイメージを利用可能にするアベイラビリティゾーン（同じリージョンでも異なるリージョンでも可）の HostingUnitName を決定します。これは、その特定の AZ 用に構成したホスティングユニットの名前です。
  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」を参照してください。