製品ドキュメント
Citrix DaaS™
PDFを表示

AWS EC2で準備済みイメージを使用してカタログを作成

May 4, 2026
寄稿者: 
C C

  • 準備済みイメージを作成し、その準備済みイメージを使用して、以下でMCSマシンカタログを作成します。

  • Studio
  • PowerShellコマンド

準備済みイメージを使用してMCSマシンカタログを作成する主な手順は次のとおりです。

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

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

Studioを使用

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

  1. Studioで、イメージノードに移動し、イメージ定義の作成をクリックします。はじめにページで次へをクリックします。
  2. イメージ定義ページで、イメージ定義のOSタイプとセッションタイプを指定します。

  3. イメージページで、リソース（設定された接続に適用可能なリソースのみが一覧表示されます）、イメージバージョン作成のテンプレートとして使用するマスターイメージ、およびハードウェアプロパティをキャプチャするマシンプロファイルを選択します。VMインスタンスまたは起動テンプレートバージョンからハードウェアプロパティをキャプチャするマシンプロファイルを選択します。

    注：

    • イメージを選択する前に、マスターイメージにVDA 2311以降がインストールされており、MCSIOドライバーがVDAにインストールされていることを確認してください。
    • インスタンスメタデータサービス（IMDS）V1およびV2は両方ともサポートされています。
  4. マシン仕様ページで、マシンサイズを選択します。マシンプロファイル（イメージページで選択）のマシンサイズがデフォルトで選択されています。
  5. NICページで、準備イメージのNICを選択または追加します。各NICについて、関連するVPCサブネットを選択します。
  6. バージョン説明ページで、作成された初期イメージバージョンの説明を入力します。
  7. 概要ページで、イメージ定義と作成された初期イメージバージョンの詳細を確認します。イメージ定義の名前と説明を入力します。完了をクリックします。

イメージバージョンの作成

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

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

注：

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

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

注：

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

PowerShellを使用

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

  1. Test-ProvImageDefinitionNameAvailableコマンドを使用して、利用可能なイメージ定義名を確認します。例：

    
Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>

<!--NeedCopy-->

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

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

<!--NeedCopy-->

  3. Add-ProvImageDefinitionConnectionコマンドを使用して、指定されたホスティング接続にイメージ定義の新しい構成を作成します。

    
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn

<!--NeedCopy-->

  4. New-ProvImageVersionコマンドを使用して、イメージバージョンを作成します。例：

    
New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

<!--NeedCopy-->

  5. Add-ProvImageVersionSpecコマンドを使用して、マスターイメージバージョン仕様をイメージバージョンに追加します。例：

    
Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName aws -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”"

<!--NeedCopy-->

    注：

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

  6. New-ProvImageVersionSpecコマンドを使用して、マスターイメージバージョン仕様から準備済みイメージバージョン仕様を作成します。SourceImageVersionSpecUidパラメーターはAdd-ProvImageVersionSpecコマンドから派生します。例：

    ```

  • New-ProvImageVersionSpec

  • -SourceImageVersionSpecUid 00000000-0000-0000-0000-00000000000

  • -MachineProfile ‘XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion’ -RunAsynchronously

    ```

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


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

<!--NeedCopy-->

注：

  • イメージ定義内のすべてのイメージバージョン仕様は、同じホスティングユニットに属している必要があります。
  • 1つのイメージバージョンには、1つのマスターイメージバージョン仕様と1つの準備済みイメージバージョン仕様のみを含めることができます。
  • すべてのイメージバージョン仕様にはマシンプロファイルが必要です。

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

AWS EC2環境では、単一の準備済みイメージを、同じ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アカウント間での共有はできません。

重要な考慮事項

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

前提条件

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

  • 環境がAWS EC2環境であること。
  • 同じAWSアカウントで、複数のホスティングユニット（それぞれ異なるアベイラビリティゾーンに紐付け可能）とホスト接続（それぞれ異なるリージョンに紐付け可能）を構成する必要があります。

PowerShellを使用した構成

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

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

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

  3. Add-ProvImageVersionSpecHostingUnit コマンドを実行します: 次のPowerShellコマンドを使用します。<ImageVersionSpecUid> をイメージのUidに、<targetHostingUnitName> をイメージバージョン仕様を共有するターゲットアベイラビリティゾーンのホスティングユニットの名前に置き換えます。

    
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

<!--NeedCopy-->
  4. 正常に実行されると、Studio UIでイメージのステータスが表示され、指定されたホスティングユニットと共有されたことが示されます。

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

    1. 共有を削除する準備済みイメージの ImageVersionSpecUid を持っていることを確認します。
  1. 共有イメージを削除するアベイラビリティゾーンの HostingUnitName を特定します。

  2. Remove-ProvImageVersionSpecHostingUnit コマンドを実行します: 次のPowerShellコマンドを使用します。<ImageVersionSpecUid> をイメージのUidに、<targetHostingUnitName> をイメージバージョン仕様の共有を削除するターゲットアベイラビリティゾーンのホスティングユニットの名前に置き換えます。

    
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

<!--NeedCopy-->

マシンカタログの作成

Studioの使用

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

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

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

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

  1. イメージバージョンを選択し、Create catalog をクリックします。Introduction ページで Next をクリックします。
  2. Machine Management および Image ページでは、選択したイメージバージョンに基づいて設定が事前に選択されています。Image ページで、選択した準備済みイメージのメモを入力します。
  3. 次のページで設定を完了します。
  4. Summary ページで、マシンカタログの詳細を確認します。マシンカタログの名前と説明を入力します。Finish をクリックします。
  5. Machine Catalogs ノードに移動して、作成されたマシンカタログを確認します。

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

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

  1. 左側のナビゲーションペインで Machine Catalogs をクリックします。
  2. Create Machine Catalog をクリックします。Machine Catalog Setup ページが表示されます。
  3. Machine Type ページで、カタログのマシンタイプ（例: Multi-session OS）を選択します。

  4. Machine Management ページで、次の設定を選択します。

    1. Machines that are power managed (for example, virtual machines or blade PCs) を選択します。
    2. Citrix provisioning technology を選択します。次に、Citrix Machine Creation Services™ を選択します。
    3. Resources フィールドで、ホスト接続の作成時に構成したリソース（アベイラビリティゾーン）を選択し、Next をクリックします。
  5. Desktop experience ページで、ユーザーがログオンしたときに使用するランダムデスクトップまたは静的デスクトップのいずれかを選択します。静的デスクトップが選択されている場合は、ユーザーがローカルディスクで行った変更を保存するかどうか（永続的または非永続的）をさらに指定します。

  6. Image ページで、Select an image をクリックして、マシンカタログの準備済みイメージを選択します。作成した準備済みバージョンを選択します。イメージバージョン名をクリックします。選択したイメージバージョンの詳細を表示するには、下線が引かれているバージョン番号をクリックします。Done をクリックします。

    準備済みイメージに関連付けられたマシンプロファイルが表示され、そのハードウェアプロパティ（例: インスタンスタイプ、テナンシータイプ、ネットワークマッピング、セキュリティグループ、ボリュームプロパティ）がカタログ内のマシンを作成するために使用されます。マシンプロファイルのソースを別のVMまたは起動テンプレートバージョンに変更するには、編集ボタンをクリックします。

  7. Virtual Machines ページで:

    1. カタログのVM数を入力します。
    2. デフォルトのマシン仕様が表示されます。これはマシンプロファイルに基づいています。変更するには、編集アイコンを選択し、マシン仕様を選択します。
  8. NICs ページで、VMのNIC（またはENI）を選択します。
  9. Machine Identities ページで、ドメインを選択し、このマシンカタログで作成されるVMの新しいADアカウントを作成することにより、カタログ内のマシンのオンプレミスActive DirectoryまたはMicrosoft Entraハイブリッド参加を構成します。プロビジョニングされたVMは、選択したドメインに参加します。作成される新しいADアカウントのアカウント命名スキームを指定します。Next をクリックします。
  10. Domain credentials ページで、Enter credentials をクリックして、選択したドメインの資格情報を入力します。プロンプトが表示されたら、管理者レベルのユーザー名とパスワードを入力します。以前に保存したドメイン資格情報がある場合は、製品ドキュメントに従ってサービスアカウントを使用することもできます。
  11. Summary ページが表示されるまで残りのページをクリックします。マシンカタログの名前を入力し、Finish を選択してマシンカタログを作成します。

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 "awscatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "awscatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

$Task = New-ProvScheme -ProvisioningSchemeName awscatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName aws -IdentityPoolName awscatalog -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 awscatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid

<!--NeedCopy-->

次のステップ

詳細情報

AWS EC2で準備済みイメージを使用してカタログを作成
May 4, 2026
寄稿者: 
C C
May 4, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.