

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon WorkSpaces アプリケーションイメージの管理
<a name="administer-images"></a>

使用可能なイメージは、WorkSpaces アプリケーションコンソールの**イメージレジストリ**に一覧表示され、可視性によって次のように分類されます。
+ **パブリック** — によって所有され、利用可能になるベースイメージ AWS。ベースイメージには、最新の Windows オペレーティングシステムと WorkSpaces Applications エージェントソフトウェアが含まれます。これらのベースイメージを使用して、ユーザー独自のアプリケーションを含む新しいイメージを作成できます。によってリリースされるベースイメージの詳細については AWS、「」を参照してください[WorkSpaces アプリケーションベースイメージとマネージドイメージ更新リリースノート](base-image-version-history.md)。
+ **プライベート** — 作成して所有し、他の AWS アカウントと共有していないイメージ。
+ **他のユーザーと共有** — 作成して所有し、同じ AWS リージョン内の 1 つ以上の AWS アカウントと共有したイメージ。イメージを別の AWS アカウントと共有する場合、イメージを Image Builder (新しいイメージを作成）、フリート、またはその両方に使用できるかどうかを指定できます。
+ **自分と共有 — **同じ AWS リージョン内の別の AWS アカウントによって作成および所有され、自分の AWS アカウントと共有されているイメージ。自分のアカウントでイメージを共有するときに所有者が指定したアクセス許可に応じて、このイメージは Image Builder、フリート、またはその両方で使用できます。

**Topics**
+ [

# Amazon WorkSpaces アプリケーションでプライベートイメージを削除する
](delete-private-image.md)
+ [

# 所有しているイメージを Amazon WorkSpaces アプリケーションの別の AWS リージョンにコピーする
](copy-image-different-region.md)
+ [

# Amazon WorkSpaces アプリケーションの別の AWS アカウントで所有しているイメージを共有する
](share-image-with-another-account.md)
+ [

# Amazon WorkSpaces アプリケーションで所有しているイメージの共有を停止する
](stop-sharing-image-with-all-accounts.md)
+ [

# Amazon WorkSpaces アプリケーションイメージUp-to-Date状態に保つ
](keep-image-updated.md)
+ [

# Amazon WorkSpaces アプリケーションの Windows Update およびウイルス対策ソフトウェア
](windows-update-antivirus-software.md)
+ [

# Amazon WorkSpaces アプリケーションで新しいイメージをプログラムで作成する
](create-image-programmatically.md)
+ [

# Amazon WorkSpaces アプリケーションのイメージでライセンス込みアプリケーションを管理する
](license-included-applications.md)
+ [

# イメージのインポート
](import-image.md)
+ [

# イメージのエクスポート
](export-image.md)

# Amazon WorkSpaces アプリケーションでプライベートイメージを削除する
<a name="delete-private-image"></a>

不要になったプライベートイメージは削除できます。フリートで使用されているイメージや、他の AWS アカウントと共有されているイメージを削除することはできません。フリートで使用されているイメージや共有されているイメージを削除するには、最初に、フリートからのイメージの削除とすべてのイメージ共有アクセス権限の削除を行う必要があります。削除したイメージは回復できません。

**プライベートイメージを削除するには**

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、[**イメージ**]、[**イメージレジストリ**] の順に選択します。

1. イメージのリストで、削除するプライベートイメージを選択します。

1. [**Actions (アクション)**]、[**Delete (削除)**] の順に選択し、[**Delete (削除)**] を再度選択します。

   イメージはイメージレジストリから除去されて削除されます。

# 所有しているイメージを Amazon WorkSpaces アプリケーションの別の AWS リージョンにコピーする
<a name="copy-image-different-region"></a>

**重要**  
アジアパシフィック (マレーシア）、欧州 (ミラノ）、欧州 (スペイン）、イスラエル (テルアビブ) AWS リージョンの場合: クロスリージョンイメージコピーは、2025 年 10 月 2 日以降にリリースされた WorkSpaces Applications エージェントバージョンを使用するイメージ、または 2025 年 9 月 5 日以降にリリースされたマネージド更新を使用するイメージでのみサポートされます。古いバージョンは、リージョン間でコピーすることはできません。これらの最小バージョン要件を満たすようにイメージを更新して、クロスリージョンコピー機能を有効にします。

所有しているイメージを別の AWS リージョンにコピーできます。異なる AWS リージョンで同じイメージを使用すると、WorkSpaces アプリケーションへのアプリケーションのグローバルデプロイを簡素化できます。ユーザーに最も地理的に近い AWS リージョンにアプリケーションをデプロイすることで、ユーザーにより応答性の高いエクスペリエンスを提供できます。

**所有しているイメージを別の AWS リージョンにコピーするには**

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、[**イメージ**]、[**イメージレジストリ**] の順に選択します。

1. イメージリストで、別の AWS リージョンにコピーするイメージを選択します。

1. **[アクション]**、**[コピー]** の順に選択します。

1. **イメージのコピー**ダイアログボックスの**宛先リージョン**で、イメージのコピー先の AWS リージョンを選択します。

1. イメージの一意の名前と説明 (オプション) を [**Destination region (コピー先リージョン)**] に入力します。

1. [**Copy Image (イメージのコピー)**] を選択します。

# Amazon WorkSpaces アプリケーションの別の AWS アカウントで所有しているイメージを共有する
<a name="share-image-with-another-account"></a>

WorkSpaces Applications イメージはリージョンリソースであるため、所有しているイメージを同じ AWS リージョン内の他の AWS アカウントと共有できます。イメージの共有は、さまざまなシナリオで役立つことがあります。たとえば、異なる AWS アカウントを使用して開発リソースと本番稼働用リソースを分離する場合、開発アカウントを使用してイメージを作成できます。次に、本番稼働用アカウントでイメージを共有できます。所属組織が独立系ソフトウェアベンダー (ISV) である場合は、最適化したイメージを顧客と共有できます。最適化したイメージには必要なアプリケーションがインストールおよび設定済みであるため、顧客はアプリケーションを自分でインストールして設定する必要がなく、アプリケーションをすぐに使い始めることができます。

イメージを別の AWS アカウントと共有する場合、送信先アカウントがフリート内のイメージを使用できるか、Image Builder を作成して新しいイメージを作成できるかを指定します。共有イメージの所有権は自分に帰属します。これにより、共有イメージのアクセス権限の追加、変更、または削除を必要に応じて行うことができます。

イメージを別のアカウントと共有して、このアカウントにフリートへのアクセス権限を付与すると、共有イメージを使用して当該アカウントのフリートを作成または更新できます。これらのアクセス権限を後で削除すると、アカウントではイメージを使用できなくなります。共有イメージを使用するアカウントのフリートの場合、希望する容量を 0 に設定すると、新しいフリートインスタンスは作成されません。ストリーミングセッションが終了するまで既存のセッションが続行されます。新規作成するフリートインスタンスの場合は、そのアカウントのフリートを有効なイメージで更新する必要があります。

イメージを別のアカウントと共有して、このアカウントに Image Builder へのアクセス権限を付与すると、共有イメージを使用して当該アカウントの Image Builder およびイメージを作成できます。これらのアクセス権限を後で削除しても、自分のイメージから作成した Image Builder やイメージは影響を受けません。

**重要**  
イメージを別のアカウントと共有した後で、このアカウントでこのイメージから作成した Image Builder やイメージをコントロールすることはできません。このため、アカウントに対して Image Builder へのアクセス権限を付与するのは、イメージのコピーを作成することをアカウントに許可する場合に限ります。また、イメージの共有を停止した後のコピーへのアクセス権は保持します。

**所有しているイメージを別の AWS アカウントと共有するには**

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、[**イメージ**]、[**イメージレジストリ**] の順に選択します。

1. イメージのリストで、共有するイメージを選択します。

1. [**Actions (アクション)**]、[**Edit (編集)**] の順に選択します。

1. [**Share image (イメージの共有)**] ダイアログボックスで、[**Add account (アカウントの追加)**] を選択します。

1. イメージを共有するアカウントの 12 桁の AWS アカウント ID を入力し、アカウントが次のいずれかまたは両方を実行できるかどうかを選択します。
   + イメージを使用して Image Builder を起動する (新しいイメージを作成する場合)。
   + イメージをフリートで使用する。

   イメージを共有する先のアカウントのリストからアカウントを削除するには、削除するアカウントの行で [**Use for fleet (フリートで使用)**] オプションの右側にある [X] アイコンを選択します。

1. より多くの AWS アカウントとイメージを共有するには、イメージを共有するアカウントごとにステップ 6 を繰り返します。

1. [**Share Image (イメージの共有)**] を選択します。

**所有しているイメージに対してイメージ共有アクセス権限を追加または更新するには**

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、[**イメージ**]、[**イメージレジストリ**] の順に選択します。

1. イメージのリストで、アクセス権限を変更するイメージを選択します。

1. イメージのリストの下で、選択したイメージの [**Permissions (アクセス権限)**] タブを選択し、[**Edit (編集)**] を選択します。

1. **画像アクセス許可の編集**ダイアログボックスで、1 つ以上の AWS アカウントで必要に応じて、次の画像共有オプションのいずれかまたは両方を選択またはクリアします。アカウントで両方のオプションを選択解除すると、そのアカウントではイメージが共有されなくなります。
   + イメージを使用して Image Builder を起動する (新しいイメージを作成する場合)。
   + イメージをフリートで使用する。

   イメージを共有する先のアカウントのリストからアカウントを削除するには、削除するアカウントの行で [**Use for fleet (フリートで使用)**] オプションの右側にある [X] アイコンを選択します。

1. さらに多くの AWS アカウントのイメージ共有アクセス許可を編集するには、アクセス許可を更新するアカウントごとにステップ 5 を繰り返します。

1. [**Update image sharing permissions (イメージ共有アクセス権限の更新)**] を選択します。

# Amazon WorkSpaces アプリケーションで所有しているイメージの共有を停止する
<a name="stop-sharing-image-with-all-accounts"></a>

所有しているイメージを他の AWS アカウントとの共有を停止するには、次の手順に従います。

**所有しているイメージを他の AWS アカウントとの共有を停止するには**

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、[**イメージ**]、[**イメージレジストリ**] の順に選択します。

1. イメージのリストで、アクセス権限を変更するイメージを選択します。

1. イメージのリストの下で、選択したイメージの [**Permissions (アクセス権限)**] タブを選択し、[**Edit (編集)**] を選択します。

1. **イメージのアクセス許可の編集**ダイアログボックスで、イメージが共有されているすべての AWS アカウントの行で、フリー**トに使用する**オプションの右側にある X アイコンを選択します。

1. [**Update image sharing permissions (イメージ共有アクセス権限の更新)**] を選択します。

# Amazon WorkSpaces アプリケーションイメージUp-to-Date状態に保つ
<a name="keep-image-updated"></a>

WorkSpaces アプリケーションイメージをup-to-date状態に保つには、次のいずれかを実行します。
+ [Managed WorkSpaces アプリケーションイメージの更新を使用してイメージを更新する](keep-image-updated-managed-image-updates.md) – この更新メソッドは、最新のオペレーティングシステムの更新とドライバーの更新、および最新の WorkSpaces Applications エージェントソフトウェアを提供します。
+ [マネージド WorkSpaces アプリケーションエージェントバージョンを使用して WorkSpaces アプリケーションエージェントソフトウェアを更新する](keep-image-updated-manage-image-versions.md) – この更新メソッドは、最新の WorkSpaces Applications エージェントソフトウェアを提供します。

# Managed WorkSpaces アプリケーションイメージの更新を使用してイメージを更新する
<a name="keep-image-updated-managed-image-updates"></a>

WorkSpaces Applications は、最新のオペレーティングシステムの更新、ライセンス込みのアプリケーションの更新、ドライバーの更新、WorkSpaces Applications エージェントソフトウェアを使用してイメージを自動的に更新する方法を提供します。マネージド WorkSpaces アプリケーションイメージの更新では、更新するイメージを選択します。WorkSpaces Applications は、同じ AWS アカウントとリージョンに Image Builder を作成し、更新をインストールして新しいイメージを作成します。新しいイメージを作成したら、本番稼働前のフリートでテストしてから、本番稼働用フリートを更新したり、他の AWS アカウントとイメージを共有したりできます。

**注記**  
Managed WorkSpaces Applications Image Updates は、Microsoft Windows Server、Red Hat Enterprise Linux、Rocky Linux オペレーティングシステムで使用できます。

**注記**  
新しいイメージが作成されたら、オペレーティングシステムの更新を維持する責任があります。そのためには、マネージド WorkSpaces アプリケーションイメージの更新を引き続き使用できます。  
Amazon EC2 Windows Paravirtual (PV) ドライバー、ENA ドライバー、 AWS NVMe ドライバーの更新を維持する責任があります。ドライバーを更新する方法の詳細については、「[EC2 インスタンスのデバイスドライバーを管理する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html)」を参照してください。  
ユーザーは、アプリケーションとその依存関係を維持する責任も負います。他のアプリケーションの追加、既存のアプリケーションの更新、またはイメージ設定の変更を行うには、イメージの作成に使用した Image Builder を起動して再接続する必要があります。または、その Image Builder を削除したという場合は、イメージに基づいた新しい Image Builder を起動します。次に、変更を反映して新しいイメージを作成します。

## 前提条件
<a name="keep-image-updated-managed-image-updates-prerequisites"></a>

マネージド型イメージの更新を使用する際の前提条件と考慮事項を以下に示します。
+ WorkSpaces Applications アカウントのクォータ (制限とも呼ばれます) が、新しい Image Builder と新しいイメージの作成をサポートするのに十分であることを確認します。クォータの引き上げをリクエストするには、[https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) の [Service Quotas] コンソールを使用します。デフォルトの WorkSpaces アプリケーションのクォータについては、「」を参照してください[Amazon WorkSpaces Applications Service Quotas](limits.md)。
+ 更新するイメージは自分が所有している必要があります。自分が共有先になっているイメージを更新することはできません。
+ WorkSpaces Applications が最新のオペレーティングシステムの更新、ドライバーの更新、WorkSpaces Applications エージェントソフトウェアをインストールするための Image Builder を作成し、新しいイメージを作成すると、更新中に Image Builder インスタンスに対して課金されます。
+ サポートされるイメージは、2017-07-24T00:00:00Z 以降にリリースされたベースイメージから作成する必要があります。
+ サポートされる表示言語は、英語と日本語です。詳細については、「[デフォルトの表示言語を指定する](configure-default-display-language.md)」を参照してください。
+ SSM Agent の最新バージョンを使用してください。バージョンについては、「[WorkSpaces アプリケーションベースイメージとマネージドイメージ更新リリースノート](base-image-version-history.md)」を参照してください。インストールの詳細については、「[Windows Server の EC2 インスタンスに SSM Agent を手動でインストールする](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html)」を参照してください。

## Managed WorkSpaces アプリケーションイメージの更新を使用してイメージを更新する方法
<a name="keep-image-updated-managed-image-updates-how-to-update-image"></a>

WorkSpaces Applications イメージを最新のパッチ、ドライバーの更新、WorkSpaces Applications エージェントソフトウェアで更新するには、次の手順を実行します。

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、[**イメージ**]、[**イメージレジストリ**] の順に選択します。

1. イメージのリストで、更新するイメージを選択します。イメージのステータスが **Available** になっていることを確認します。

1. **[アクション]**、**[更新]** の順に選択します。

1. **[イメージの更新]** ダイアログボックスで、次の操作を行います。
   + **新しいイメージ名**には、 AWS アカウントとリージョン内で一意のイメージ名を入力します。イメージ名を「Amazon」、「AWS」、または「AppStream」で始めることはできません。
   + **[新しいイメージ表示名]** には、オプションでこのイメージについて表示する名前を入力できます。
   + **[新しいイメージの説明]** には、オプションでこのイメージの説明を入力できます。
   + **[タグ]** では、**[タグの追加]** を選択し、タグのキーと値を入力します。さらにタグを追加するには、この手順を繰り返します。詳細については、「[Amazon WorkSpaces アプリケーションリソースのタグ付け](tagging-basic.md)」を参照してください。

1. **[イメージの更新]** を選択します。

   現在のイメージが既に最新である場合は、メッセージで通知されます。

1. ナビゲーションペインで、**[イメージ]**、**[Image Builder]** の順に選択します。

1. Image Builder 一覧で、新しい Image Builder が **[更新中]** 状態になっていることを確認します。Image Builder の名前には 10 桁のランダムなサフィックスが含まれます。

   Image Builder は、ステップ 5 で新しいイメージ用に選択したインスタンスファミリーの中で最小のサイズです。Image Builder は仮想プライベートクラウド (VPC) に接続していないため、サブネットは指定されていません。

1. **[イメージレジストリ]** を選択し、新しいイメージがリストに表示されていることを確認します。

   イメージの作成中、イメージのステータスは、コンソールのイメージレジストリに **[作成中]** と表示されます。

1. イメージが作成されると、WorkSpaces Applications は認定プロセスを実行して、イメージが期待どおりに動作することを確認します。

   この間、このプロセスにも使用される Image Builder が、**[Image Builder]** リストに **[認定待ち]** のステータスで表示されます。

1. 認定プロセスが正常に完了すると、コンソールの上部に **[成功]** メッセージが表示され、イメージレジストリにイメージステータスが **[使用可能]** と表示されます。

   さらに、WorkSpaces アプリケーションが作成した Image Builder は自動的に削除されます。
**注記**  
オペレーティングシステムの更新の量によっては、イメージの更新が完了するまでに数時間かかる場合があります。問題によりイメージを更新できない場合、イメージ名の横に感嘆符の付いた赤いアイコンが表示され、イメージレジストリのイメージステータスが **[失敗]** と表示されます。このような場合は、イメージを選択し、**[通知]** タブを選択して、エラー通知を確認してください。詳細については、通知コードのトラブルシューティングに関するドキュメントの [イメージの内部サービス](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image) セクションの情報を参照してください。  
認定プロセスが成功しなかった場合でも、WorkSpaces アプリケーションが作成した Image Builder は自動的に削除されます。

1. WorkSpaces Applications が新しいイメージを作成したら、本番稼働前のフリートでイメージをテストします。アプリケーションが想定どおりに動作することを確認したら、新しいイメージで本番稼働用フリートを更新します。

# マネージド WorkSpaces アプリケーションエージェントバージョンを使用して WorkSpaces アプリケーションエージェントソフトウェアを更新する
<a name="keep-image-updated-manage-image-versions"></a>

WorkSpaces Applications は、新しい WorkSpaces Applications エージェントソフトウェアで Image Builder を自動的に更新する方法を提供します。この方法では、新しいバージョンのエージェントがリリースされるたびに新しいイメージを作成できます。その後、本番稼働用フリートを更新する前にイメージをテストできます。WorkSpaces Applications エージェントソフトウェアを管理する方法の詳細については、「」を参照してください[WorkSpaces アプリケーションエージェントバージョンを管理する](base-images-agent.md)。

**注記**  
Windows オペレーティングシステムの更新、アプリケーション、それらの依存関係のインストールとメンテナンスは、お客様の責任で行います。

WorkSpaces アプリケーションイメージを最新の Windows オペレーティングシステムの更新で更新し続けるには、次のいずれかを実行します。
+ 新しいイメージがリリースされるたびに、最新のベースイメージにアプリケーションをインストールする。
+ Windows オペレーティングシステムの更新プログラム、お客様のアプリケーション、それらの依存関係を既存のイメージビルダーにインストールする。
+ Windows オペレーティングシステムの更新プログラム、お客様のアプリケーション、それらの依存関係を既存のイメージから新しいイメージビルダーにインストールする。

最新の Windows オペレーティングシステム、アプリケーションとその依存関係、WorkSpaces Applications エージェントソフトウェアを使用して新しいイメージを作成したら、開発フリートでイメージをテストします。アプリケーションが想定どおりに動作することを確認したら、新しいイメージで本番稼働用フリートを更新します。

# Amazon WorkSpaces アプリケーションの Windows Update およびウイルス対策ソフトウェア
<a name="windows-update-antivirus-software"></a>

WorkSpaces アプリケーションストリーミングインスタンスは非永続的です。ユーザーストリーミングセッションが終了すると、WorkSpaces アプリケーションはセッションで使用されるインスタンスを終了し、スケーリングポリシーに応じて、フリートで置き換えるために新しいインスタンスをプロビジョニングします。すべてのフリートインスタンスは、同じイメージからプロビジョニングされます。イメージは一度作成すると変更できないため、ユーザーストリーミングセッションで使用されるすべてのフリートインスタンスには、イメージの作成時に基になるイメージにインストールされていた Windows とアプリケーションの更新のみが含まれます。さらに、ストリーミングセッションに使用されるフリートインスタンスはセッションの終了時に終了するため、ストリーミングセッション中にインスタンス上の Windows またはアプリケーションに対して行われた更新は、同じユーザーや他のユーザーによる以降のセッションでは保持されません。

**注記**  
スタックのアプリケーション設定の永続化を有効にした場合、WorkSpaces Applications は、同じユーザーの将来のセッションに対してユーザーが行った Windows およびアプリケーション設定の変更を、ユーザーの Windows プロファイルに保存すると、保持します。ただし、アプリケーション設定の永続化機能は、Windows およびアプリケーション構成設定のみを保持します。ストリーミングインスタンス上の Windows またはアプリケーションに対するソフトウェア更新は保持されません。

このような理由から、WorkSpaces アプリケーションは、WorkSpaces アプリケーションインスタンスの Windows Update およびウイルス対策ソフトウェアに次のアプローチを採用しています。

## Windows 更新
<a name="windows-update-antivirus-software-wu"></a>

Windows Update は、WorkSpaces Applications ベースイメージではデフォルトで有効になっていません。イメージビルダーで Windows Update を有効にしてからイメージを作成しようとすると、Image Assistant によって警告が表示され、イメージ作成プロセス中は Windows Update が無効になります。フリートインスタンスに最新の Windows 更新プログラムが確実にインストールされるようにするには、イメージビルダーに Windows 更新プログラムをインストールし、新しいイメージを作成して、その新しいイメージでフリートを定期的に更新することをお勧めします。

## ウイルス対策ソフトウェア
<a name="windows-update-antivirus-software-av"></a>

イメージにウイルス対策ソフトウェアをインストールする場合は、ウイルス対策ソフトウェアの自動更新を有効にしないことをお勧めします。そうしないと、ウイルス対策ソフトウェアがユーザーセッション中に最新の定義ファイルまたはその他の更新でソフトウェア自体を更新しようとします。これは、パフォーマンスに影響を与える可能性があります。さらに、ウイルス対策ソフトウェアに加えられた更新は、現在のユーザーセッションを超えて保持されません。フリートインスタンスに常に最新のウイルス対策ソフトウェアの更新を適用するには、次のいずれかを実行することをお勧めします。
+ イメージビルダーを更新し、定期的に新しいイメージを作成します (たとえば [Image Assistant CLI オペレーション](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)を使用)。
+ スキャンやその他のオペレーションを常に最新の状態にある外部サーバーに委任するウイルス対策アプリケーションを使用します。

**注記**  
ウイルス対策ソフトウェアの自動更新を有効にしていない場合でも、ウイルス対策ソフトウェアがユーザーセッション中にハードドライブスキャンやその他の操作を実行し、フリートインスタンスのパフォーマンスに影響を与えることがあります。

2019 年 9 月 10 日以降に公開された WorkSpaces アプリケーション Windows Server 2025/2022/2019/2016 ベースイメージでは、Windows Defender はデフォルトで有効になっていません。2019 年 6 月 24 日に発行された WorkSpaces Applications Windows Server 2016 および Windows Server 2019 ベースイメージでは、Windows Defender はデフォルトで有効になっています。

**Windows Defender を手動で有効にするには**

ベースイメージで Windows Defender が有効になっていない場合は、手動で有効にすることができます。これには、以下のステップを実行します。

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. 左側のナビゲーションペインで、**[Images]** (イメージ)、**[Image Builder]** の順に選択します。

1. Windows Defender を有効にするイメージビルダーを選択し、そのイメージが [**実行中**] 状態であることを確認して、[**接続**] を選択します。

1. Image Builder に、ローカル **Administrator** アカウントまたはローカル管理者権限を持つドメインアカウントを使用してログインします。

1. レジストリエディタを開きます。

1. レジストリ内の [**HKLM\$1SOFTWARE\$1Policies\$1Microsoft\$1Windows Defender\$1DisableAntiSpyware**] に移動します。

1. このレジストリキーを編集するには、そのレジストリキーをダブルクリックするか、レジストリキーを右クリックして [**変更**] を選択します。

1. [**Edit DWORD (32-bit) Value (DWORD（32 ビット）値の編集)**] ダイアログボックスの [**値のデータ**] で [**1**] を [**0**] に変更します。

1. [**OK**] を選択してください。

1. レジストリエディタを閉じます。

1. Microsoft 管理コンソール (MMC) **サービス**スナップイン (`services.msc`) を開きます。

1. サービスのリストで、次のいずれかを行います。

   Microsoft Windows Server 2022/2025 を使用している場合は、次のいずれかを実行します。
   + **[Microsoft Defender ウイルス対策サービス]** を右クリックし、**[スタート]** を選択します。
   + **[Microsoft Defender ウイルス対策サービス]** をダブルクリックし、プロパティダイアログボックスで **[スタート]** を選択し、**[OK]** を選択します。

   Microsoft Windows Server 2019 または 2016 を使用している場合は、次のいずれかを実行します。
   + [**Windows Defender ウイルス対策サービス**] を右クリックし、[**スタート**] を選択します。
   + [**Windows Defender ウイルス対策サービス**] をダブルクリックし、プロパティダイアログボックスで [**スタート** ] を選択し、[**OK**] を選択します。

1. **サービス**スナップインを閉じます。

# Amazon WorkSpaces アプリケーションで新しいイメージをプログラムで作成する
<a name="create-image-programmatically"></a>

WorkSpaces Applications イメージをプログラムで作成するには、Image Builder に接続し、Image Assistant コマンドラインインターフェイス (CLI) オペレーションを使用します。詳細については、「[Image Assistant CLI オペレーションを使用して Amazon WorkSpaces アプリケーションイメージをプログラムで作成する](programmatically-create-image.md)」を参照してください。

# Amazon WorkSpaces アプリケーションのイメージでライセンス込みアプリケーションを管理する
<a name="license-included-applications"></a>

WorkSpaces アプリケーションを使用して、次の Microsoft ライセンス込みアプリケーションをストリーミングできます。これらのアプリケーションを Windows イメージにインストールし、このカスタムイメージを使用してフリートを作成して、アプリケーションをストリーミングできます。次のアプリケーションはすべて、32 ビットおよび 64 ビットアーキテクチャで使用できます。
+ Microsoft Office LTSC Professional Plus 2021/2024
+ Microsoft Visio LTSC Professional 2021/2024
+ Microsoft Project Professional 2021/2024
+ Microsoft Office LTSC Standard 2021/2024
+ Microsoft Visio LTSC Standard 2021/2024
+ Microsoft プロジェクトスタンダード 2021/2024
**重要**  
Microsoft Office、Visio、および Project は同じバージョンとする必要があります。例えば、2021 アプリケーションと 2024 アプリケーションを混在させることはできません。
Microsoft Office、Visio、および Project は同じアーキテクチャとする必要があります。例えば、32 ビットアプリケーションを 64 ビットアプリケーションと混在させることはできません。
Microsoft Office、Visio、Project 2021 Standard/Professional バージョンは、Microsoft Windows Server 2019/2022/2025 でサポートされています。Microsoft Office、Visio、Project 2024 Standard/Professional バージョンは、Microsoft Windows Server 2022 および 2025 でサポートされています。
この機能を有効にするには、2025 年 10 月 2 日以降にリリースされた WorkSpaces Applications エージェントを使用する WorkSpaces Applications Image Builder を使用する必要があります。詳細については、「[WorkSpaces アプリケーションエージェントバージョンを管理する](base-images-agent.md)」を参照してください。または、イメージは、2025 年 10 月 3 日以降にリリースされたマネージド WorkSpaces アプリケーションイメージ更新を使用する必要があります。詳細については、「[Amazon WorkSpaces アプリケーションイメージUp-to-Date状態に保つ](keep-image-updated.md)」を参照してください。
ポート 1688 のアウトバウンド TCP は、すべてのストリーミングインスタンスの管理ネットワークインターフェイスで開いている必要があります。
1 つ以上のライセンスされたアプリケーションを含むイメージを利用したフリートを介してストリーミングするすべてのユーザーには、使用量に関係なく、これらのアプリケーションに対して毎月課金されます。アプリケーション使用権限機能により、特定のユーザーのアクセスは制限されません。
Image Builder のライセンス込みアプリケーションは、管理目的でインストールされているため、アクティブ化されません。アクティブ化されるのは、ユーザーがフリートインスタンスをストリーミングするときです。

**Topics**
+ [

# イメージにインストールされているライセンス込みアプリケーションのリストを表示する
](view-list-image.md)
+ [

# Image Builder でライセンス込みアプリケーションのリストを表示する
](view-list-apps.md)
+ [

# ライセンス込みアプリケーションをインストールまたはアンインストールする
](install-uninstall-apps.md)
+ [

# Image Builder でライセンス込みアプリケーションの更新を有効にする
](updates-image-builder.md)
+ [

# Powershell を使用して Image Builder でライセンス込みアプリケーションの更新を有効にする
](enable-updates-managed-powershell.md)
+ [

# マネージドイメージの更新を使用して Image Builder でライセンス込みアプリケーションの更新を有効にする
](enable-updates-managed.md)

# イメージにインストールされているライセンス込みアプリケーションのリストを表示する
<a name="view-list-image"></a>

**イメージにインストールされているライセンス込みアプリケーションのリストを表示する**

イメージにインストールされているライセンス込みアプリケーションのリストを表示するには、以下のステップに従います。

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. 左のナビゲーションペインで **[イメージ]** を選択し、**[イメージレジストリ]** を選択します。

1. イメージを選択し、**[詳細の表示]** を選択します。

1. **[ライセンス込みアプリケーション]** で、インストール済みのすべてのアプリケーションのリストを確認します。

# Image Builder でライセンス込みアプリケーションのリストを表示する
<a name="view-list-apps"></a>

**Image Builder でライセンス込みアプリケーションのリストを表示する**

Image Builder でライセンス込みアプリケーションのリストを表示するには、以下のステップに従います。

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、**[イメージ]** を選択し、**[Image Builder]** タブを選択します。

1. Image Builder を選択し、**[詳細の表示]** を選択します。

1. **[ライセンス込みアプリケーション]** で、アプリケーションとそのステータスのリストを確認します。

# ライセンス込みアプリケーションをインストールまたはアンインストールする
<a name="install-uninstall-apps"></a>

**ライセンス込みアプリケーションをインストールまたはアンインストールする**

イメージに 1 つ以上のライセンス込みアプリケーションをインストールまたはアンインストールするには、以下のステップに従います。

1. 次のいずれかのオプションを完了します。
   + Image Builder を起動し、ライセンス込みアプリケーションを設定します。詳細については、「[Image Builder を起動し、ストリーミングアプリケーションをインストールして設定する](tutorial-image-builder-create.md)」を参照してください。
   + Image Builder でライセンス込みアプリケーションを管理します。詳細については、「[サードパーティーの SAML 2.0 アイデンティティプロバイダーを使用した属性ベースのアプリケーションの使用権限](application-entitlements-saml.md)」を参照してください。

1. 1 つ以上のライセンス込みアプリケーションで作成されたイメージがある場合、このイメージを使用してフリートを作成できます。このフリートに接続するユーザーは、これらのアプリケーションにアクセスできます。
**重要**  
1 つ以上のライセンスされたアプリケーションを含むイメージを利用したフリートを介してストリーミングするすべてのユーザーには、使用量に関係なく、これらのアプリケーションに対して毎月課金されます。アプリケーションの使用権限機能により、特定のユーザーのアクセスは制限されません。

ライセンス込みアプリケーションのインストールまたはアンインストール中にエラーが発生した場合は、Image Builder の詳細ページにエラーステータスが表示されます。このような問題をトラブルシューティングするために、Image Builder に接続し、詳細なログ記録を有効にすることをお勧めします。詳細については、「[Microsoft 365 Apps for Enterprise のログ記録を有効にする方法](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging)」を参照してください。ログの確認とトラブルシューティング後も問題が解決しない場合は、 AWS サポート にお問い合わせください。

# Image Builder でライセンス込みアプリケーションの更新を有効にする
<a name="updates-image-builder"></a>

**Image Builder でライセンス込みアプリケーションの更新を有効にする**

すべてのライセンス込みアプリケーションの更新は、デフォルトで無効になっています。これらのアプリケーションの 1 つ以上を含むイメージを使用して、Image Builder でこれらのアプリケーションの更新を有効にできます。セッションのセットアップ中のインストールを防止するため、フリートインスタンスの更新は無効のままになります。

Image Builder でライセンス込みアプリケーションの更新を有効にするには、3 つのオプションがあります。

アプリケーションメニューを使用して Image Builder でライセンス込みアプリケーションの更新を有効にするには、以下のステップに従います。

1. ライセンス込みアプリケーションを開きます。

1. **[ファイル]**、**[アカウント]**、**[更新オプション]**、**[更新を有効にする]** の順に選択します。

# Powershell を使用して Image Builder でライセンス込みアプリケーションの更新を有効にする
<a name="enable-updates-managed-powershell"></a>

Powershell を使用して Image Builder でライセンス込みアプリケーションの更新を有効にするには、以下のステップに従います。
+ 管理者として PowerShell で次のコマンドを実行します。

  `Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `

# マネージドイメージの更新を使用して Image Builder でライセンス込みアプリケーションの更新を有効にする
<a name="enable-updates-managed"></a>

マネージドイメージの更新を使用して Image Builder でライセンス込みアプリケーションの更新を有効にするには、以下のステップに従います。
+  マネージドイメージの更新を使用して、Microsoft ライセンス込みアプリケーションに関する更新を受け取ります。詳細については、以下を参照してください。

  [Managed WorkSpaces アプリケーションイメージの更新を使用してイメージを更新する](keep-image-updated-managed-image-updates.md).

# イメージのインポート
<a name="import-image"></a>

カスタマイズされた EC2 AMIs をインポートすることで、WorkSpaces アプリケーションイメージを作成できます。処理の流れ

1. EC2 [Image Builder などの任意の方法を使用して EC2 ](https://docs.aws.amazon.com/imagebuilder/)AMI をカスタマイズします。

1. カスタマイズされた AMI を WorkSpaces アプリケーションにインポートして WorkSpaces アプリケーションイメージを作成する

1. オプションで、Image Builder を使用してイメージをさらにカスタマイズする

AMI のインポートによって作成されたイメージは で`type = "custom"`、WorkSpaces アプリケーションが提供するイメージは です`type = "native"`。

でイメージに stream.\$1 インスタンスタイプを使用できます`type = "native"`。次のいずれかのインスタンスタイプを使用するには、AMI をインポートし、 でイメージを作成する必要があります`type = "custom"`。
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Accelerated。\$1

## イメージのインポートの前提条件
<a name="import-image-prerequisites"></a>

これらの前提条件はすべて、ワークフローの実行を成功させるために重要です。サポートされている AMI 設定およびその他の必須要件を以下に示します。

### 必要な AMI プロパティ
<a name="required-ami-properties"></a>

EBS  
+ 500GB 以下のサイズ
  + < 200 GB の AMI をインポートできますが、インポートされたイメージでは最低 200GB が使用されます。
+ GP2
  + gp2 または gp3 EBS ボリュームタイプの AMI をインポートできますが、インポートされたイメージは gp2 を使用します。
+ イメージあたり 1 ボリューム
+ `/dev/sda1` ルートデバイス名
+ イメージタイプ: マシン
+ アーキテクチャ: x86\$164
+ 仮想化タイプ: HVM
+ ブートモード: UEFI
+ TPM サポート: v2.0。これは必須です。TPM が有効な AMI を見つけるには、[https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1ami-windows-tpm-find](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find) を参照してください。
+ ENA サポート: true
+ プラットフォーム: Windows
+ プラットフォームの詳細: Windows

### オペレーティングシステムのプロパティ
<a name="operating-system-properties"></a>

Windows Server 2022/2025 **フルベース**  
+ Windows Server **Core** はサポートされていません
+ Windows と SQL Server はサポートされていません

[エージェント]     
+ EC2 起動 V2 バージョン >= 2.1.1
+ SSM エージェントが必要です

ドライバー  
+ EC2 ENA ドライバーバージョン >= 2.9.0
+ EC2 NVMe ドライバーバージョン >= 1.6.0

ライブラリのサポート  
+ .NET Framework 4.8 以降
  + Windows Server 2022/2025 にデフォルトでインストール
+ PowerShell 5.1 以降
  + Windows Server 2022/2025 にデフォルトでインストール
+ Windows の機能: リモートデスクトップサービスのライセンスとリモートデスクトップサービスのセッションホストをインストールしないでください
+ ポート: ポート 8000、8300、8443 はブロック解除および占有解除する必要があります
+ ブートモード: UEFI

Accelerated.g4dn、 Accelerated.g5、 Accelerated.G6、 Accelerated.G6e などのグラフィックスインスタンスでイメージを使用する場合は、AMI に適切な GRID ドライバーをインストールします。詳細については、[https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html) を参照してください。ただし、ドライバーが正しく設定されていない場合、ストリーミングは機能します。グラフィックカードは使用できない場合があります。

**重要**  
AMI の「所有者アカウント ID」はAWSアカウント ID である必要があります。パブリック EC2 AMI をインポートすることはできません。  
イメージをインポートする前に、Windows 更新を実行し、Windows 自動更新を無効にします。  
暗号化された EC2 AMIs のインポートは現在サポートされていません

### IAM ロールの要件
<a name="iam-role-requirements"></a>

**重要**  
「イメージのインポートに使用する以下のアクセス許可を持つ IAM ロールを作成します。

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}
```

この IAM ロールに次の信頼関係を追加します。

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## イメージをインポートするには
<a name="import-image-procedure"></a>

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. 左側のナビゲーションペインで、**画像**を選択し、**画像レジストリ**を選択します。

1. **イメージのインポート** を選択します。

1. **AMI ID** - WorkSpaces アプリケーションにインポートする AMI の AMI ID を入力します。このフィールドを使用して AMI を検索することもできます。

1. **イメージ名** - インポートオペレーションのために作成されるイメージの一意の名前を入力します。

1. **表示名** *(オプション)* - イメージに表示する を入力します。

1. **説明** *(オプション)* – イメージの説明を入力します。

1. **IAM ロール** - イメージのインポート用に作成した IAM ロールを選択します。詳細については、「」を参照してください[IAM ロールの要件](#iam-role-requirements)。

1. **WorkSpaces Applications エージェントの管理** – 常に最新の WorkSpaces Applications エージェントバージョンを使用する場合、ストリーミングインスタンスは、新しいエージェントバージョンがリリースされたAWSときに から利用できる最新の機能、パフォーマンスの向上、およびセキュリティ更新プログラムで自動的に更新されます。

1. **ランタイム検証** *(オプション)*: このオプションを選択すると、サービスはインポートされるイメージを使用してインスタンスをプロビジョニングし、ストリーミングテストを実行します。
   + 
**注記**  
これらのストリーミングテストはバックグラウンドで実行されるため、WorkSpaces Applications クライアントを介してこのインスタンスに接続することはできません。
   + イメージが WorkSpaces アプリケーションに適しているという信頼性を高めるには、このオプションを使用することをお勧めします。
   + そのインスタンスの時間料金が請求されます。
   + ストリーミングテストに影響を与えない可能性のある小さな変更を行った後に AMI を再インポートする場合や、ランタイム検証が最後に合格した場合に、この AMI をインポートした場合、ランタイム検証の実行を回避できます。
   + **インスタンスタイプを選択** *(オプション)*: ストリーミングテストを実行する適切なインスタンスファミリー、タイプ、サイズを選択します。フリートの作成に使用する予定のインスタンスと同じインスタンスを使用することをお勧めします。

1. **アプリケーションカタログと起動パフォーマンスマニフェスト** *(オプション)*: エンドユーザー向けのアプリケーションカタログを作成し、アプリケーションの起動パフォーマンスを向上させるための詳細を提供します。
   + **アプリケーションカタログ**: アプリケーションカタログを作成するには、イメージをインストールしたアプリケーションの詳細を指定します。ストリーミングを計画するアプリケーションごとに、名前、表示名、起動する実行可能ファイルと表示するアイコンを指定できます。
   + **起動パフォーマンス**: アプリケーション最適化マニフェストにファイルを追加すると、アプリケーションが新しいフリートインスタンスで初めて起動するまでにかかる時間が短縮されます。最適化マニフェストは、アプリケーションごとの行区切りテキストファイルです。

   詳細については、「」を参照してください[アプリケーションの詳細](applications-details.md)。

1. **タグ** *(オプション)* - **タグの追加**を選択し、タグのキーと値を入力します。さらにタグを追加するには、この手順を繰り返します。詳細については、「[Amazon WorkSpaces アプリケーションリソースのタグ付け](tagging-basic.md)」を参照してください。

1. **イメージのインポート** – 入力したすべての情報を確認し、**イメージのインポート**を選択します。サービスは互換性チェックを実行して、AMI が WorkSpaces アプリケーションと互換性があることを確認します。
   + 静的チェックが失敗すると、すぐにエラーが表示されます。
   + 静的チェックに合格すると、インポートリクエストが送信され、選択したオプションによっては、 を使用して新しい WorkSpaces アプリケーションイメージを作成するのに 30～60 分かかる場合があります。 `type = "custom"`

# アプリケーションの詳細
<a name="applications-details"></a>

アプリケーションの詳細には、事前ウォーミングマニフェストとアプリケーションカタログ設定に関する情報が含まれています。

## Application PreWarm マニフェスト
<a name="application-prewarm-manifests"></a>

WorkSpaces アプリケーションイメージを作成するときに、ユーザーが利用できるようにアプリケーションを指定できます。アプリケーションの起動時間を短縮するには、PreWarm マニフェストを準備します。これは基本的に、ユーザーがアプリケーションを起動するときにアプリケーションが起動する必要があるファイルのカタログです。インスタンスのプロビジョニング中、これらのファイルはセッション接続の前に準備され、ユーザーセッションでのアプリケーションの起動時間を短縮します。

事前ウォーミングマニフェストは、WorkSpaces アプリケーション環境にインポートする前に AMI で事前に作成する必要があります。共通のプリウォームマニフェストファイルを 1 つ作成するか、アプリケーションごとに 1 つ作成するかを選択できます。これにより、後で AMI をインポートする方法が変更されます。

### 一般的な事前ウォームマニフェスト
<a name="common-prewarm-manifest"></a>

事前ウォーミングするアプリケーションごとに、アプリケーションを起動し、ユーザーが実行する初期インタラクションを実行します。次に、アプリケーションデータが保存されているディレクトリをターゲットにして、次のコマンドを使用します。

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```

これにより、各アプリケーション用に最適化するファイルが共通`C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt`ファイルに追加されます。アプリケーションの事前ウォーミングを実行するために必要な追加のアクションはありません。WorkSpaces Applications は、上記の場所にあるプリウォームファイルを探し、存在する場合はそれを使用します。

このプロセスはオプションであり、プリウォームマニフェストのサイズが増えると、フリートのプロビジョニング時間も長くなります。したがって、最適化とフリートプロビジョニングのバランスをとるように注意してください。

### アプリケーション固有のマニフェスト
<a name="application-specific-manifests"></a>

イメージのインポート中に、アプリケーションごとに事前ウォーミングアセットを簡単に追跡できるように、アプリケーションごとに個別のアプリケーションマニフェストファイルを指定できます。これを行うには、上記と同じ手順を実行しますが、共通`C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt`ファイルを作成する代わりに、AMI 上のアプリケーションごとにファイルを作成します。

事前ウォーミングするアプリケーションごとに、アプリケーションを起動し、ユーザーが実行する初期インタラクションを実行します。次に、アプリケーションデータが保存されているディレクトリをターゲットにして、次のコマンドを使用します。

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\<ApplicationName>PreWarm.txt" -encoding UTF8 -append
```

これらのアプリケーションプリウォームファイルは、イメージのインポートプロセス中に使用します。繰り返しになりますが、これは完全にオプションです。このメソッド、Common Prewarm Manifest メソッド、または Prewarm マニフェストをまったく使用しないことを選択できます。

## Application Catalog の設定
<a name="application-catalog-configs"></a>

`AppCatalogConfig` これにより、AMI のインポート中に WorkSpaces アプリケーションイメージに登録するアプリケーションを指定できます。`AppCatalogConfig` は、次の構造のアプリケーション設定オブジェクトの JSON リストです。

```
[  
    {  
        "Name": "Rufus", //Required and must be unique among the list of applications  
        "DisplayName": "Rufus",  
        "AbsoluteAppPath": "Rufus", //Required  
        "AbsoluteIconPath": "Rufus",  
        "AbsoluteManifestPath": "Rufus",  
        "WorkingDirectory": "Rufus",  
        "LaunchParameters": "Rufus"  
    }  

    ...  

    // Up to 50 applications total  
 ]
```

アプリケーションあたりの必須フィールドは、 `Name`と のみです`AbsoluteAppPath`。各フィールドの詳細は次のとおりです。

名前 [**必須**]  
+ アプリケーションを識別するための特定の名前
+ 1～100 文字
+ 使用できる文字正規表現 `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ 特定の AppCatalogConfig で一意である必要があります

DisplayName  
+ ユーザーに表示する特定のアプリケーションの表示名
+ 0～100 文字
+ 使用できる文字正規表現 `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`

AbsoluteAppPath [**必須**]  
+ アプリケーションを起動するための実行可能ファイルへのパス
  + これは、ユーザーがアプリケーションを選択したときに起動される実行可能ファイルです。
+ 1～32,767 文字
  + この文字長の上限は、Windows で拡張ファイルパスをサポートすることです。260 文字を超えるファイルパスを使用する場合は、Windows 拡張ファイルパスをサポートするように AMI とアプリケーションが正しく設定されていることを確認します。
+ などのエスケープされたファイルパス文字列を使用する
  + `"C:\\Windows\\System32\\notepad.exe"`

AbsoluteManifestPath  
+ を使用している場合のみ該当します。 [アプリケーション固有のマニフェスト](#application-specific-manifests)
+ このアプリケーションのマニフェストファイルを事前ウォーミングするパス
+ 0～32,767 文字
  + この文字長の上限は、Windows で拡張ファイルパスをサポートすることです。260 文字を超えるファイルパスを使用する場合は、Windows 拡張ファイルパスをサポートするように AMI とアプリケーションが正しく設定されていることを確認します。
+ などのエスケープされたファイルパス文字列を使用する
  + `"C:\\Path\\To\\PrewarmManifest.txt"`

AbsoluteIconPath  
+ アプリケーションに使用する AMI のアイコンファイルへのパス。
  + このアイコンは、このイメージにストリーミングするときにユーザーに表示されます。
  + 何も指定しない場合、アイコンは実行可能ファイル自体から派生します。
  + ユーザーにとって良好なクライアントエクスペリエンスを実現するために、バックグラウンドの透明性が適切に処理されたアイコンファイルを選択するように注意する
    + PNG イメージを使用する
+ 1～32,767 文字
  + この文字長の上限は、Windows で拡張ファイルパスをサポートすることです。260 文字を超えるファイルパスを使用する場合は、Windows 拡張ファイルパスをサポートするように AMI とアプリケーションが正しく設定されていることを確認します。
+ などのエスケープされたファイルパス文字列を使用する
  + `"C:\\Path\\To\\ApplicationIcon.png"`

WorkingDirectory  
+ でアプリケーションを起動する作業ディレクトリ
+ 0～32,767 文字
  + この文字長の上限は、Windows で拡張ファイルパスをサポートすることです。260 文字を超えるファイルパスを使用する場合は、Windows 拡張ファイルパスをサポートするように AMI とアプリケーションが正しく設定されていることを確認します。
+ などのエスケープされたファイルパス文字列を使用する
  + `"C:\\Path\\To\\Working\\Directory"`

LaunchParameters  
+ で指定された実行可能ファイルの起動パラメータとして使用する文字列 `AbsoluteAppPath`
+ 0～1024 文字
+ アプリケーションとして PowerShell 実行可能ファイルを使用してアプリケーションとして PowerShell スクリプトを使用する方法を示す次の例のように、必要な起動パラメータの完全なリストを含むエスケープされた文字列を使用します。 PowerShell 
  + AbsoluteAppPath
    + `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
  + LaunchParameters
    + `"-File \"C:\\Path\\To\\App\\Script.ps1\""`

### AppCatalogConfig のサンプル
<a name="sample-appcatalogconfig"></a>

これは、AppCatalogConfig for Notepad、Google Chrome、および Mozilla Firefox のベアボーンの例です。

```
[  
    {  
        "Name": "Notepad",  
        "DisplayName": "Notepad",  
        "AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
    },  
    {  
        "Name": "Chrome",  
        "DisplayName": "Chrome",  
        "AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
        "LaunchParameters": "https://www.amazon.com/"  
    },  
    {  
        "Name": "Firefox",  
        "DisplayName": "Firefox",  
        "AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
        "LaunchParameters": "https://aws.amazon.com/"  
    }  
 ]
```

# イメージのエクスポート
<a name="export-image"></a>

イメージをエクスポートして EC2 AMIs を作成できます。後で、[イメージのインポート](import-image.md)これらの AMIs に戻って WorkSpaces アプリケーションイメージを作成できます。これにより、独自の AMI カスタマイズツールを使用してイメージをカスタマイズできます。

**注記**  
エクスポート中に、以下のコンポーネントがイメージから削除されます。  
WorkSpaces Applications エージェント
Image Builder を使用して追加された Microsoft ライセンス込みアプリケーション
Microsoft Windows Server 2022 および 2025 イメージのみをエクスポートできます。

## IAM ロールの要件
<a name="export-image-iam-requirements"></a>

**重要**  
エクスポートのインポートに使用する以下のアクセス許可を持つ IAM ロールを作成します。

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowCopyImage",  
            "Effect": "Allow",  
            "Action": "ec2:CopyImage",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowCreateTags",  
            "Effect": "Allow",  
            "Action": "ec2:CreateTags",  
            "Resource": "*"  
        }  
    ]  
}
```

この IAM ロールに次の信頼関係を追加します。

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## イメージをエクスポートするには
<a name="export-image-procedure"></a>

1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションペインで、[**イメージ**]、[**イメージレジストリ**] の順に選択します。

1. イメージリストで、エクスポートするプライベートイメージを選択します。

1. **アクション**、**エクスポート** を選択します。

1. **イメージのエクスポート**ダイアログボックスで、一意の **AMI 名**と、オプションで **AMI の説明**を入力します。

1. **IAM ロール** - イメージのエクスポート用に作成した IAM ロールを選択します。

1. 必要に応じて、**エクスポートのタグのコピーチェックボックスをオンにして、イメージから AMI にタグ**をコピーします。

1. **イメージのエクスポート**を選択します。