翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# App Block
App Block は、ユーザーが使用することになるアプリケーションの起動に必要なアプリケーションファイルとバイナリが含まれる、アカウント内の Amazon S3 バケットに格納された仮想ハードディスク (VHD) を表します。App Block には、VHD ファイルの処理方法をオペレーティングシステムに伝えるセットアップスクリプトも含まれています。
App Block では、次の 2 種類のパッケージをサポートしています。
+ カスタム - アプリケーションパッケージ (VHD) を手動で作成するには、このオプションを選択します。詳細については、「[カスタム App Blocks](custom-app-blocks.md)」を参照してください。
+ WorkSpaces Applications - App Block Builder を使用してアプリケーションパッケージを作成するには、この推奨オプションを選択します。詳細については、「[WorkSpaces アプリケーションアプリブロック](appstream-app-blocks.md)」を参照してください。
**Topics**
+ [カスタム App Blocks](custom-app-blocks.md)
+ [WorkSpaces アプリケーションアプリブロック](appstream-app-blocks.md)
+ [サポートされていないアプリケーション](app-blocks-unsupported.md)
# カスタム App Blocks
Elastic フリートストリーミングインスタンスは、アカウントの Amazon S3 バケットに保存されている仮想ハードディスク (VHD) ファイルにインストールされたアプリケーションを利用します。カスタムパッケージを使用した App Block では、独自の VHD ファイルを自由に作成でき、その App Block をアカウント内の Amazon S3 バケットにアップロードできます。
**Topics**
+ [VHD を作成する](create-vhd.md)
+ [Amazon WorkSpaces アプリケーションで VHD のセットアップスクリプトを作成する](create-setup-script.md)
+ [カスタム App Block を作成する](create-app-block.md)
+ [App Block、VHD、およびセットアップスクリプトを更新する](update-app-block.md)
# VHD を作成する
VHD は、オペレーティングシステムにマウントされると、ハードディスクのように扱われる単一のファイルです。VHD は、ドライブ文字としてマウントする、フォルダパスにマウントする、またはそれらの両方にマウントできます。VHD がマウントされると、他のハードディスクと同様に扱うことが可能になり、これには VHD へのユーザーに必要となるアプリケーションのインストールやファイルのコピーが含まれます。
App Block を作成するには、VHD を作成し、それにアプリケーションをインストールしてから、デタッチする必要があります。デタッチすると、別の PC、EC2 インスタンス、または WorkSpaces Applications Image Builder で VHD をテストして、アプリケーションが期待どおりに動作することを検証できます。それが完了したら、アカウント内の Amazon S3 バケットにアップロードして、App Block を作成します。
**注記**
このページでは、VHD を使用してアプリケーションを配信する方法について説明します。ただし、WorkSpaces アプリケーションストリーミングインスタンスは Amazon S3 からオブジェクトをダウンロードします。Amazon S3 に保存するオブジェクトは、zip ファイル、アプリケーションインストーラー、またはアプリケーションの実行可能ファイル自体でもかまいません。セットアップスクリプトを使用して、ユーザーがアプリケーションを起動する前に、ストリーミングインスタンスで正しく設定することができます。
WorkSpaces アプリケーションストリーミングインスタンスは、セットアップスクリプトが実行される前に VHD のダウンロードが完了するまで最大 120 秒待機します。VHD がこの期間内にダウンロードを完了しない場合、ダウンロードは停止し、セットアップスクリプトは実行されません。
VHD の最大サイズは 1.5 ギガバイトにすることをお勧めします。圧縮することで、VHDのサイズを小さくできる可能性があります。このファイルをマウントし、アプリケーションを起動する前に、ファイルを Amazon S3 から完全にダウンロードしておく必要があるため、セットアップスクリプトを使用して、このファイルを解凍しておく必要があります。VHD のサイズが大きいほど、アプリケーションの起動とストリーミングセッションの開始にかかる時間が長くなります。
**Microsoft Windows 用の VHD を作成する**
1. Windows PC または Windows Amazon Elastic Compute Cloud (Amazon EC2) インスタンスから、管理者権限を使用してコマンドプロンプトを開きます。
1. 以下のコマンドを入力して、Microsoft **diskpart** ユーティリティを起動します。
**diskpart**
1. 以下のコマンドを入力して、フォーマット化と初期化が行われていない VHD ファイルを作成します。ここでの ** は、VHD ファイルのサイズ (MB 単位) です。
**create vdisk file=C:\$1path\$1to\$1new\$1file.vhdx maximum=** type=expandable **
1. 以下のコマンドを入力して、新しく作成された VHD を選択します。
**select vdisk file=C:\$1path\$1to\$1new\$1file.vhdx**
1. 以下のコマンドを入力して、新しく作成された VHD をアタッチします。
**attach vdisk**
1. 以下のコマンドを入力して、新しく作成された VHD を初期化します。
**convert mbr**
1. 以下のコマンドを入力して、VHD 全体にまたがるプライマリパーティションを作成します。
**create partition primary**
1. 以下のコマンドを入力して、新しく作成されたパーティションをフォーマットします。
**format fs=ntfs quick**
1. 新しく作成された VHD は、未使用のドライブ文字、ルートボリューム上のフォルダパス、またはそれらの両方にマウントできます。
ドライブ文字をマウントするには、**assign letter=**** を入力します。
フォルダをマウントするには、**assign mount=*C:\$1path\$1to\$1empty\$1folder\$1to\$1mount\$1*** を入力します。
**注記**
フォルダパスにマウントするには、フォルダがすでに存在し、空である必要があります。
1. これで、ステップ 9 で選択したドライブ文字またはフォルダマウントパスを使用して、アプリケーションを VHD にインストールできるようになりました。
VHD へのアプリケーションのインストールが完了したら、Amazon S3 バケットに安全にアップロードする前に、VHD をデタッチする必要があります。
**Microsoft Windows 用の VHD をデタッチする**
1. 以下のコマンドを入力して、Microsoft diskpart ユーティリティを起動します。
**diskpart**
1. 以下のコマンドを入力して、VHD を選択します。
**select vdisk file=*C:\$1path\$1to\$1new\$1file.vhdx***
1. 以下のコマンドを入力して、VHD をデタッチします。
**detach vdisk**
1. VHD がデタッチされ、別の Windows PC、Amazon EC2 インスタンス、または WorkSpaces Applications Image Builder でテストできるようになりました。
**Linux 用の VHD を作成する**
1. ターミナルを開きます。
+ Amazon Linux 2 の場合: EC2 インスタンス、WorkSpaces Applications Image Builder、または Amazon Linux 2 を搭載した WorkSpaces を使用する
+ Ubuntu Pro 24.04 LTS の場合: EC2 インスタンスまたは Ubuntu Pro を搭載した WorkSpaces を使用します。
1. フォーマット化および初期化が行われていない VHD ファイルを作成します。
**dd if=/dev/zero of=** bs=** count=1**
1. 以下のコマンドを入力して、作成された VHD にファイルシステムを追加します。
**sudo mkfs -t ext4 ****
**注記**
ファイルがブロックスペシャルデバイスではないというメッセージが表示される場合があります。そのまま続行することを選択できます。
1. 以下のコマンドを入力して、マウントポイント用に使用する空のフォルダを作成します。
**sudo mkdir */path/to/mount/point***
1. 以下のコマンドを実行して、新しく作成された VHD をファイルシステムパスにマウントします。
**sudo mount -t auto -o loop ** */path/to/mount/point***
1. これで、ステップ 4 で選択したフォルダマウントパスを使用して、アプリケーションを VHD にインストールできるようになりました。
**注記**
VHD で作成されたファイルとフォルダに対するデフォルトの許可は、管理者以外のユーザーによるアプリケーションの起動やファイルの読み取りを防ぐことができます。許可を検証し、必要に応じて変更します。
VHD へのアプリケーションのインストールが完了したら、Amazon S3 バケットに安全にアップロードする前に、VHD をデタッチする必要があります。
**Linux 用の VHD をデタッチする**
1. ターミナルセッションを開き、以下のコマンドを入力します。
**sudo umount */path/to/mount/point***
1. VHD はデタッチされ、別の Amazon Linux 2/Ubuntu Pro 24.04 LTS Amazon EC2 インスタンス、Amazon Linux 2 WorkSpaces Applications Image Builder、または Amazon Linux 2/Ubuntu WorkSpaces Personal でテストできるようになりました。
# Amazon WorkSpaces アプリケーションで VHD のセットアップスクリプトを作成する
WorkSpaces Applications は、アプリケーションの起動前に指定したセットアップスクリプトを使用して VHD をマウントします。セットアップスクリプトは、アプリケーションを動作させるために必要なその他のタスクを完了するために使用することもできます。例えば、レジストリキーの設定、DLL の登録、前提条件の管理、またはセットアップスクリプトからのユーザープロファイルの変更を行うことができます。WorkSpaces Applications には、VHD のマウントに使用できるスクリプト例が用意されています。これらのスクリプトは、お使いの VHD とアプリケーションのニーズに合わせて変更する必要があります。
**注記**
WorkSpaces Applications パッケージングのアプリケーションブロックには、セットアップスクリプトは必要ありません。ただし、オプションでセットアップ後のスクリプトを使用することで、アプリケーションのインストールをカスタマイズできます。
サンプルスクリプトをダウンロードするには、次のリンクを使用します。
+ [Ubuntu Pro 24.04 LTS および Amazon Linux 2 bash スクリプト](samples/Linux-mount-vhd-script2.zip)
+ [Microsoft Windows PowerShell スクリプト](samples/Windows-mount-vhd-script3.zip)
**注記**
WorkSpaces アプリケーションと Microsoft Windows オペレーティングシステムは、ドライブ文字 A から E を予約します。これらのドライブ文字に VHDsやネットワーク共有をマウントしないでください。
WorkSpaces Applications は、セットアップスクリプトと VHD をフリートストリーミングインスタンスのディレクトリにダウンロードし、セットアップスクリプトを実行します。セットアップスクリプトは、完全な管理者権限を用いてオペレーティングシステム上で実行されます。セットアップスクリプトは、Microsoft Windows の`SYSTEM`コンテキストで実行され、Amazon Linux 2 または Ubuntu Pro 24.04 LTS の`root`ユーザーとして実行されます。
VHD とセットアップスクリプトのファイルシステムの場所は以下のとおりです。
+ Ubuntu Pro 24.04 LTS:
`/opt/appstream/AppBlocks/appblock-name/`
**`appblock-name` **
VHD とセットアップスクリプトに対応する App Block の名前です。
+ Amazon Linux 2:
`/opt/appstream/AppBlocks/appblock-name/`
**`appblock-name` **
VHD とセットアップスクリプトに対応する App Block の名前です。
+ Microsoft Windows:
`C:\AppStream\AppBlocks\appblock-name\`
**`appblock-name` **
VHD とセットアップスクリプトに対応する App Block の名前です。
WorkSpaces Applications は、オブジェクト上のファイル名をそのまま維持します。例えば、App Block の名前が `MyApps` で、`apps.vhd` という名前の VHD と `mount-apps.ps1` という名前のセットアップスクリプトがある場合、Windows ストリーミングインスタンス上のフルパスは以下のようになります。
+ VHD
`C:\AppStream\AppBlocks\MyApps\apps.vhd`
+ セットアップスクリプト
`C:\AppStream\AppBlocks\MyApps\mount-apps.ps1`
WorkSpaces Applications は、フリートストリーミングインスタンスで実行されたときにセットアップスクリプトから標準エラーと標準出力をキャプチャし、アカウント内の Amazon S3 バケットに出力をアップロードします。これらのログを使用して、セットアップスクリプトで発生する可能性のある問題を特定し、解決することができます。バケットは、以下にあるような特定の形式で命名されます。
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
**`region-code` **
これは、Elastic フリートが作成される AWS リージョンコードです。
**`account-id-without-hyphens` **
AWS アカウント識別子。ランダムな ID は、そのリージョン内のその他バケットとの競合が発生しないことを確実にします。バケット名の最初の部分である appstream-logs は、アカウントおよびリージョンに応じて変化するものではありません。
たとえば、アカウント番号 123456789012 で米国西部 (オレゴン) リージョン (us-west-2) に Elastic フリートを作成すると、WorkSpaces Applications は、表示された名前でそのリージョンのアカウント内に Amazon S3 バケットを作成します。適切なアクセス許可を持つ管理者のみが、このバケットを削除できます。
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
アカウントの S3 バケットでログファイルが保存されているフォルダへのパスは、以下の構造になります。
```
bucket-name/fleet-name/instance-id/appblock-name/
```
**`bucket-name` **
セッションスクリプトログが保存されている Amazon S3 バケットの名前です。名前の形式については、このセクションで先ほど説明しました。
**`Instance-id` **
セットアップスクリプトが実行されたストリーミングインスタンスの一意の識別子です。
**`appblock-name` **
セットアップスクリプトに対応する App Block の名前です。
以下のフォルダ構造の例は、`test-fleet` で始まるストリーミングセッションに該当します。セッションの AWS アカウント ID は 123456789012 で、アプリケーションブロック名は米国西部 (オレゴン) リージョン (us-west-2) の testappblock です。
`appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/`
このフォルダ構造の例には、標準出力用のログファイルが 1 つ、および標準エラー用のログファイルが 1 つ含まれています。
**Topics**
+ [Amazon WorkSpaces アプリケーションでのアプリケーションブロック設定スクリプトの実行](script-execution.md)
# Amazon WorkSpaces アプリケーションでのアプリケーションブロック設定スクリプトの実行
以下の図は、セットアップスクリプトがプロセスのどこで実行されるかを示しています。実行順序は、Elastic フリートに関連付けられたスタックでアプリケーション設定の永続化が有効になっているかどうかに応じて異なります。
**注記**
WorkSpaces Applications は VPC の詳細を使用して、Amazon S3 バケットから VHD とセットアップスクリプトをダウンロードします。VPC は Amazon S3 バケットに対するアクセス権を提供する必要があります。詳細については、「[WorkSpaces アプリケーションの機能に Amazon S3 VPC エンドポイントを使用する WorkSpaces](managing-network-vpce-iam-policy.md)」を参照してください。
アプリケーション設定の永続化が有効:
![\[アプリケーション設定の永続化が有効化されています。\]](http://docs.aws.amazon.com/ja_jp/appstream2/latest/developerguide/images/app-settings-enabled.png)
アプリケーション設定の永続化が無効:
![\[アプリケーション設定の永続化が無効化されています。\]](http://docs.aws.amazon.com/ja_jp/appstream2/latest/developerguide/images/app-settings-disabled.png)
# カスタム App Block を作成する
VHD とセットアップスクリプトを作成して の S3 バケットにアップロードしたら、WorkSpaces アプリケーションコンソールを使用してアプリケーションブロックリソースを作成できます AWS アカウント。Amazon S3 バケットでの VHD とセットアップスクリプトの保存に関する詳細については、[S3 バケットにアプリケーションアイコン、セットアップスクリプト、セッションスクリプト、および VHD を保存する](store-s3-bucket.md) を参照してください。
**注記**
App Block リソースを作成するには、Amazon S3 バケット内の VHD オブジェクトとセットアップスクリプトオブジェクトで `S3:GetObject` アクションを実行するための IAM 許可が必要です。
**App Block リソースを作成する**
1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションメニューから、**[Applications]** (アプリケーション)、**[App Block]**、**[Create app block]** (App Block を作成する) の順にクリックします。
1. App Block パッケージの場合は、**[カスタム]** を選択します。
1. **[App block details]** (App Blockの詳細情報) に、App Block 用の一意の名前識別子を入力します。オプションで、以下を指定することもできます。
+ **[Display name]** (表示名) – App Block のフレンドリー名です。
+ **[Description]** (説明) – App Block の説明です。
1. **[Script settings]** (スクリプト設定) にある **[Virtual hard disk object in S3]** (S3 内の仮想ハードディスクオブジェクト) では、VHD オブジェクトを表す S3 URI を入力するか、**[Browse S3]** (S3 を参照する) をクリックして S3 バケットに移動し、VHD オブジェクトを見つけます。
1. **[Script settings]** (スクリプト設定) にある **[Setup script object in S3]** (S3 内のセットアップスクリプトオブジェクト) では、セットアップスクリプトオブジェクトを表す S3 URI を入力するか、**[Browse S3]** (S3 を参照する) をクリックして S3 バケットに移動し、セットアップスクリプトオブジェクトを見つけます。
1. **[Script settings]** (スクリプト設定) にある **[Setup script executable]** (セットアップスクリプト実行可能ファイル) には、セットアップスクリプトに必要な実行可能ファイルを入力します。
**注記**
セットアップスクリプトが直接実行できる場合は、セットアップスクリプトのファイル名を入力します。セットアップスクリプトが、実行において別の実行可能ファイル (Microsoft PowerShell など) に依存する場合は、その実行可能ファイルへのパスを入力します。
Microsoft Windows 上の Microsoft PowerShell へのパス
`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`
1. オプションで、**[Script settings]** (スクリプト設定) にある **[Setup script executable arguments]** (セットアップスクリプト実行可能ファイルの引数) に、セットアップスクリプトを実行するためにセットアップスクリプト実行可能ファイルに提供する必要がある引数を入力します。
**注記**
Microsoft PowerShell スクリプトを使用している場合は、「-File」パラメータには、セットアップスクリプトの名前を実行可能な引数として指定する必要があります。また、実行ポリシーがスクリプトの実行を許可することを確認してください。詳細については、[about\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) と [PowerShell とは](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2)を参照してください。
1. **[Script settings]** (スクリプト設定) にある **[Execution duration in seconds]** (実行時間 (秒単位)) には、セットアップスクリプトのタイムアウト時間を入力します。
**注記**
秒単位の実行期間は、WorkSpaces アプリケーションがセットアップスクリプトの実行を待機してから続行する時間です。セットアップスクリプトがこの時間内に完了しない場合は、ユーザーにエラーが表示され、アプリケーションの起動が試行されます。実行時間経過後、セットアップスクリプトを終了します。
1. (オプション) **[Tags]** (タグ) で、App Block リソース用のタグを作成します。
1. 入力した情報を確認して、**[Create]** (作成) をクリックします。
1. App Block が正常に作成された場合は、コンソールの上部に成功メッセージが表示されます。エラーが発生した場合は、説明的なエラーメッセージが表示されるので、App Block を再度作成する必要があります。
# App Block、VHD、およびセットアップスクリプトを更新する
App Block リソースはイミュータブルで、作成後に変更することはできません。VHD またはセットアップスクリプトに対して下位互換性のある更新を行う必要がある場合は、ファイルの新しいバージョンを Amazon S3 バケットにアップロードして、現在のバージョンを上書きすることをお勧めします。新しい Elastic フリートのストリーミングセッションは、オブジェクトの最新バージョンをダウンロードして、それらを使用します。
VHD またはセットアップスクリプトに対して下位互換性のない更新を行う必要がある場合は、それらを新しいオブジェクトとして Amazon S3 バケットにアップロードして、新しい App Block とアプリケーションリソースを作成することをお勧めします。そうすることで、ユーザーへのデプロイを変更時間枠またはその他停止の一環として管理することができます。
# WorkSpaces アプリケーションアプリブロック
Elastic フリートストリーミングインスタンスは、アカウントの Amazon S3 バケットに保存されている仮想ハードディスク (VHD) ファイルにインストールされたアプリケーションを利用します。カスタムパッケージの App Block については、独自の VHD ファイルを作成して、それをアカウント内の Amazon S3 バケットにアップロードするという柔軟性を備えています。または、WorkSpaces Applications パッケージングを使用するアプリケーションブロックの場合、アプリケーションのパッケージングを処理し、VHD ファイルを作成して Amazon S3 バケットにアップロードする App Block Builder を活用できます。
WorkSpaces Applications パッケージ化されたアプリケーションブロックを使用すると、VHD ファイルを構築する際の手動ステップが不要になるだけでなく、セットアップスクリプトの要件も削除されます。これにより、Elastic フリートとのアプリケーションの互換性が広がり、App Block の作成に必要な手動による管理手順も削減されます。WorkSpaces Applications は、セットアップスクリプトを必要とせずに、WorkSpaces Applications パッケージングを使用してアプリケーションブロックのセットアップを自動的に処理します。ただし、オプションでセットアップ後のスクリプトを使用することで、必要に応じてインストール内容をカスタマイズできます。
**Topics**
+ [概要:](appstream-app-blocks-overview.md)
+ [サポートされていないアプリケーション](appstream-app-blocks-unsupported.md)
+ [WorkSpaces アプリケーションアプリケーションブロックを作成する](appstream-app-blocks-create.md)
+ [App Block をアクティブにする](appstream-app-blocks-activate.md)
+ [既存のアプリケーションパッケージを使用して App Block を作成する](appstream-app-blocks-create-VHD.md)
+ [App Block をテストする](appstream-app-blocks-test.md)
+ [Amazon WorkSpaces アプリケーションでアプリブロックを関連付ける](appstream-app-blocks-associate.md)
+ [Amazon WorkSpaces アプリケーションのアプリケーションブロックの関連付けを解除する](appstream-app-blocks-disassociate.md)
# 概要:
WorkSpaces Applications パッケージを使用して App Block を作成するには、App Block Builder を使用してストリーミングセッションを開始する必要があります。セッションが開始されたら、アプリケーションインストーラをダウンロードして、記録オプションを有効にできます。それ以降、WorkSpaces Applications は Application Redirection テクノロジーを使用して、App Block Builder で行われたファイルシステムとレジストリの変更を記録します。
アプリケーションリダイレクトは、Windows フィルタードライバーフレームワークを使用して、ファイルシステムとレジストリの変更をインターセプトし、リダイレクトします。このリダイレクトは、インストール中のアプリケーションに対してシームレスに行われます。アプリケーションでは、C: ドライブの元のファイルの場所とのやり取りを継続します。例えば、「TestApplication」のインストーラをアプリケーションリダイレクトが設定されたマシンで実行すると、デフォルトで C:\$1Program Files\$1TestApplication にインストールされます。ただし、バックグラウンドでは、すべてのファイルとフォルダがマウントされた仮想ハードディスク (VHD) にリダイレクトされ、元のファイルの場所から実際のファイルの場所へのリンクが作成されます。マシン上では、TestApplication はまだ C:\$1Program Files\$1TestApplication にインストールされているように見えます。
インストールの変更がすべて記録されると、VHD ファイルがアカウントの Amazon S3 バケットにアップロードされます。
ユーザーが Elastic フリートを使用してセッションをリクエストすると、WorkSpaces Applications は VHD ファイルをダウンロードし、アプリケーションをセットアップして、インストール後のセットアップスクリプト (オプション) を実行し、アプリケーションストリーミングを開始します。
**注記**
アプリケーションリダイレクトテクノロジーでは、%APPDATA% ディレクトリと %LOCALAPPDATA% ディレクトリの下に作成された新しいディレクトリを除き、%USERPROFILE% の下のファイルシステムの変更は記録されません。
アプリケーションリダイレクトテクノロジーでは、現在のユーザーである HKEY\$1CURRENT\$1USER (HKCU) のレジストリの変更は記録されません。
# サポートされていないアプリケーション
次のシナリオでは、アプリケーションのインストールまたは実行時にエラーが発生する可能性があります。
+ **インストール中にロケーションベースのチェックが行われるアプリケーション**: アプリケーションのインストールプロセスで、インストールされているファイルの実際の場所が検証されると、エラーが発生する可能性があります。WorkSpaces Applications はファイルを App Block VHD にリダイレクトするため、実際のファイルへのリンクのみが元の場所に保持されます。
アプリケーションがこれらのカテゴリのいずれかに該当するかどうか不明な場合は、WorkSpaces アプリケーションパッケージを使用してアプリケーションブロックを作成できます。このプロセスでは、アプリケーションを App Block Builder インスタンスにインストールします。アプリケーションを App Block Builder インスタンスにインストールできなかった場合は、次のアクションを実行できます。
+ ログの確認 App Block Builder インスタンスのエラーログファイルは C:\$1AppStream\$1AppBlocks\$1errorLog にあります。このログには、レジストリキーやファイル操作処理を含む、すべてのインストールエラーが記録されます。errorLog に次のログのいずれかが表示された場合は、アプリケーションのパッケージ化が WorkSpaces Applications App Block Builder で現在サポートされていないことを示します。
+ 「シンボリックリンクを作成できません」
+ 「サービスではファイル名の変更をサポートしていません」
errorLog ファイルがない場合、またはこのファイルが空の場合は、アプリケーションのインストールログを確認してエラーの原因を特定してください。
+ 問題の報告 App Block Builder のアプリケーションビルダーアシスタントにある **[問題の報告]** ボタンを選択します。このオプションを選択すると、App Block Builder インスタンスからすべての WorkSpaces アプリケーションログが収集され、WorkSpaces アプリケーションチームに送信されます。
+ カスタムパッケージを使用した App Block 作成: App Block Builder を使用してアプリケーションをパッケージ化できない場合は、カスタムパッケージの方法を使用して App Block の作成を試行できます。詳細については、「[カスタム App Blocks](custom-app-blocks.md)」を参照してください。
+ さらにサポートが必要な場合は、AWS サポートにお問い合わせください。詳細については、[AWS サポート センター](https://console.aws.amazon.com/support/home#/)を参照してください。
アプリケーションに WorkSpaces アプリケーションパッケージを使用する場合は、これらの潜在的な制限を考慮し、それに応じて計画することが重要です。
# WorkSpaces アプリケーションアプリケーションブロックを作成する
WorkSpaces Applications パッケージタイプを使用してアプリケーションブロックを作成するには、次の手順に従います。
## ステップ 1: App Block を設定する
**App Block を設定するには**
1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションメニューから、**[アプリケーションマネージャー]**、**[App Block]**、**[App Block の作成]** の順にクリックします。
1. アプリケーションブロックのパッケージ化では、**WorkSpaces Applications** を選択します。
1. **[App block details]** (App Blockの詳細情報) に、App Block 用の一意の名前識別子を入力します。オプションで、以下を指定することもできます。
+ **[名前]** – App Block 用に一意の名前を入力します。
+ **[表示名]** (オプション) – App Block のフレンドリー名です。
+ **[説明]** (オプション) – App Block の説明です。
1. (オプション) WorkSpaces Applications パッケージを含む App Block には、セットアップスクリプトは必要ありません。オプションで、インストール後のステップを、次の **[詳細オブション]** で指定できます。
+ **[S3 のセットアップ後のスクリプトオブジェクト]** では、セットアップ後のスクリプトオブジェクトを表す Amazon S3 URI を入力するか、**[S3 を参照する]** を選択して S3 バケットに移動し、セットアップスクリプトオブジェクトを検索します。
+ **[セットアップ後のスクリプト実行可能ファイル]** では、セットアップ後のスクリプトに必要な実行可能ファイルを入力します。
**注記**
セットアップスクリプトが直接実行できる場合は、セットアップスクリプトのファイル名を入力します。セットアップスクリプトが、実行において別の実行可能ファイル (Microsoft PowerShell など) に依存する場合は、その実行可能ファイルへのパスを入力します。
Microsoft Windows 上の Microsoft PowerShell へのパス
`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`
オプションで、**[Script settings]** (スクリプト設定) にある **[Setup script executable arguments]** (セットアップスクリプト実行可能ファイルの引数) に、セットアップスクリプトを実行するためにセットアップスクリプト実行可能ファイルに提供する必要がある引数を入力します。
**注記**
Microsoft PowerShell スクリプトを使用している場合は、「-File」パラメータには、セットアップスクリプトの名前を実行可能な引数として指定する必要があります。また、実行ポリシーがスクリプトの実行を許可することを確認してください。詳細については、[about\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) と [PowerShell とは](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2)を参照してください。
**[Script settings]** (スクリプト設定) にある **[Execution duration in seconds]** (実行時間 (秒単位)) には、セットアップスクリプトのタイムアウト時間を入力します。
**注記**
秒単位の実行期間は、WorkSpaces アプリケーションがセットアップスクリプトの実行を待機してから続行する時間です。セットアップスクリプトがこの時間内に完了しない場合は、ユーザーにエラーが表示され、アプリケーションの起動が試行されます。実行時間経過後、セットアップスクリプトを終了します。
1. **[設定をインポート]** で、**[App Block アプリケーションファイルの新規作成]** を選択します。**[設定をインポート]** の **[S3 の場所]** に、バケットを表す Amazon S3 URI を入力するか、**[S3 を参照する]** を選択して Amazon S3 バケットに移動し、適切なバケットを選択します。Amazon S3 バケットのリストはグローバルで、すべてのリージョンですべてのバケットがリスト表示されます。App Block を作成するリージョンのバケットを必ず選択してください。バケットのアクセス権限の設定に関する詳細については、「[S3 バケットにアプリケーションアイコン、セットアップスクリプト、セッションスクリプト、および VHD を保存する](store-s3-bucket.md)」を参照してください。
1. App Block Builder を選択します。他の App Block に関連付けられていない App Block Builder のみを使用できます。リストが空の場合は、新しい App Block Builder を作成するか、既存の App Block Builder の関連付けを解除して使用してください。App Block Builder は、アプリケーションパッケージの作成に使用できる再利用可能なリソースです。
**注記**
ここで App Block Builder を選択しない場合でも、**[非アクティブ]** 状態で App Block を作成し、後で App Block をアクティブにできます。詳細については、「[App Block をアクティブにする](appstream-app-blocks-activate.md)」を参照してください。
1. (オプション) **[タグ]** で、App Block リソース用のタグを作成します。
1. [**次へ**] を選択します。
1. 入力した情報を確認し、次のオプションのいずれかを選択します。
+ ステップ 7 で App Block Builder を選択しなかった場合は、**[App Block の作成]** を選択します。
+ ステップ 7 で App Block Builder を選択した場合は、**[App Block Builder の起動]** を選択します。次に、ステップ 2 に進み、App Block Builder ストリーミングセッションを使用して、アプリケーションパッケージを作成します。
この時点で、App Block リソースが作成されますが **[非アクティブ]** であり、Elastic フリートには使用できません。
## ステップ 2: アプリケーションパッケージを作成する
App Block Builder ストリーミングインスタンスを使用してアプリケーションをパッケージ化し、App Block をアクティブにします。App Block Builder を使用して作成された App Block には WorkSpaces Applications パッケージが含まれ、アプリケーションパッケージは の Amazon S3 バケットにアップロードされます AWS アカウント。
**アプリケーションパッケージを作成するには**
1. ストリーミングセッションがオンになると、アプリケーションビルダーアシスタントが自動的に起動します。起動しない場合は、デスクトップアイコンを使用して手動で起動します。
1. 最初の画面には、アプリケーションのパッケージ化プロセスの説明が表示されます。
1. 次のいずれかのオプションを使用して、アプリケーションインストーラを App Block Builder ストリーミングセッションに移行します。
+ ウェブからアプリケーションインストーラをダウンロードします。
+ ストリーミングセッションファイルインターフェイスを使用してください。
+ マシンロールを使用して、別の AWS サービスからアプリケーションインストーラをダウンロードします。
1. 必要なアプリケーションインストーラをすべて用意したら、インスタンスで実行されている他のアプリケーションをすべて停止し、**[記録の開始]** を選択します。App Block Builder によってシステム変更の記録が開始されると、画面に **[記録中]** と表示されます。
1. アプリケーションを 1 つずつインストールし始めます。
1. アプリケーションのインストールが完了したら、**[記録の停止]** を選択すると、システムは変更の記録を停止します。アプリケーションの追加や、既にインストールされているアプリケーションの削除など、アプリケーションパッケージにさらに変更を加える場合は、**[記録の開始]** を選択し、システムが **[記録中]** モードになっていることを確認します。
**注記**
アプリケーションのインストールに失敗した場合は、**問題の報告**を選択してインスタンスから WorkSpaces アプリケーション関連のログを収集し、問題を WorkSpaces アプリケーションチームに報告します。完了したら、App Block Builder のストリーミングセッションを終了します。新しい App Block Builder インスタンスを使用して、App Block の作成プロセスの再開を試行できます。問題が解決しない場合は、カスタムパッケージを使用して App Block を作成してみてください。
1. すべてのアプリケーションのインストールが完了したら、**[記録の停止]** を選択します。[スタート] メニューを使用するか、File Explorer を使用してアプリケーションを参照することで、アプリケーションをテストできます。
1. **[次へ]** を選択して、App Block の詳細を確認します。
**注記**
Elastic フリートのアプリケーションパッケージ (VHD) ファイルの推奨サイズは 1.5 GB 未満です。VHD のファイルサイズが 1.5 GB を超える場合は、1 つの App Block にパッケージされるアプリケーションの数を減らします。
アプリケーションをアンインストールしても、アプリケーションパッケージ (VHD) のファイルサイズは縮小しません。新しい App Block ストリーミングセッションを使用してアプリケーションのパッケージ化プロセスを再開し、インストールするアプリケーションの数を減らしてみてください。
1. **[App Block の作成を終了して接続解除する]** を選択し、アプリケーションパッケージを作成して Amazon S3 バケットにアップロードします。正常にアップロードされると、ストリーミングセッションは自動的に切断され、App Block は **[アクティブ]** 状態になります。
**注記**
アプリケーションのインストールに失敗した場合は、**問題の報告**を選択してインスタンスから WorkSpaces アプリケーション関連のログを収集し、問題を WorkSpaces アプリケーションチームに報告します。完了したら、App Block Builder のストリーミングセッションを終了します。新しい App Block Builder インスタンスを使用して、App Block の作成プロセスの再開を試行できます。問題が解決しない場合は、カスタムパッケージを使用して App Block を作成してみてください。
# App Block をアクティブにする
WorkSpaces アプリケーションのパッケージを含むアプリケーションブロックが作成されても、アプリケーションパッケージ (VHD) がアタッチされていない場合、アプリケーションブロックは非アクティブ状態になり、アプリケーションを Elastic フリートに関連付けるために使用することはできません。App Block をアクティブにするには、アプリケーションパッケージ (VHD) を App Block に関連付ける必要があります。
**アプリケーションパッケージを作成するには**
1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションメニューから、**[アプリケーションマネージャー]**、**[App Block]** の順にクリックします。
1. アクティブにする **[非アクティブ]**の App Block を選択し、**[アクション]** メニューから **[アクティブ]** を選択します。
1. App Block Builder を選択し、**[App Block Builder の起動]** を選択します。
+ リストが空の場合は、App Block Builder がないか、すべての App Block Builder が他の App Block に関連付けられています。新しい App Block Builder を作成するか、既存の App Block Builder の関連付けを解除してテストしてください。
+ App Block Builder が既に App Block に関連付けられている場合は、その App Block をそのまま使用して App Block をアクティブにできます。
+ 選択した App Block Builder が App Block Builder に関連付けられていない場合は、選択した App Block Builder に関連付けられ、ストリーミングセッションが開始されます。App Block Builder は、セッション終了後もこの App Block に関連付けられたままになります。
1. App Block Builder のストリーミングセッションが開始されたら、「[ステップ 2: アプリケーションパッケージを作成する](appstream-app-blocks-create.md#appstream-app-blocks-create-step2)」のステップに従ってアプリケーションパッケージ (VHD) を作成し、App Block をアクティブにします。
# 既存のアプリケーションパッケージを使用して App Block を作成する
WorkSpaces Applications パッケージで既存のアプリケーションパッケージ (VHD) を使用して、WorkSpaces Applications アプリケーションアプリケーションブロックを作成できます。作成するには、ソースの Amazon S3 バケットから別のターゲットの Amazon S3 バケットにアプリケーションパッケージ (VHD) ファイルをコピーします。ターゲットバケットが別のリージョンにある場合があります。
**既存のアプリケーションパッケージを使用して App Block を作成するには**
1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションメニューから、**[アプリケーションマネージャー]**、**[App Block]**、**[App Block の作成]** の順にクリックします。
1. アプリブロックのパッケージ化では、**WorkSpaces Applications** を選択します。
1. **[App block details]** (App Blockの詳細情報) に、App Block 用の一意の名前識別子を入力します。オプションで、以下を指定することもできます。
+ **[名前]** – App Block 用に一意の名前を入力します。
+ **[表示名]** (オプション) – App Block のフレンドリー名です。
+ **[説明]** (オプション) – App Block の説明です。
1. (オプション) WorkSpaces Applications パッケージを含む App Block には、セットアップスクリプトは必要ありません。オプションで、インストール後のステップを、次の **[詳細オブション]** で指定できます。
+ **[S3 のセットアップ後のスクリプトオブジェクト]** では、セットアップ後のスクリプトオブジェクトを表す Amazon S3 URI を入力するか、**[S3 を参照する]** を選択して S3 バケットに移動し、セットアップスクリプトオブジェクトを検索します。
+ **[セットアップ後のスクリプト実行可能ファイル]** では、セットアップ後のスクリプトに必要な実行可能ファイルを入力します。
**注記**
セットアップ後のスクリプトが直接実行できる場合は、セットアップ後のスクリプトのファイル名を入力します。セットアップ後のスクリプトが、実行時に別の実行可能ファイル (Microsoft PowerShell など) に依存する場合は、その実行可能ファイルへのパスを入力します。
Microsoft Windows 上の Microsoft PowerShell へのパス
`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`
オプションで、**[セットアップ後のスクリプトの実行可能ファイルの引数]** に、セットアップスクリプトを実行するためにセットアップスクリプト実行可能ファイルに必要な引数を入力します。
**注記**
Microsoft PowerShell スクリプトを使用している場合は、「-File」パラメータには、セットアップ後のスクリプトの名前を実行可能な引数として指定する必要があります。また、実行ポリシーがスクリプトの実行を許可することを確認してください。詳細については、[about\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) と [PowerShell とは](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2)を参照してください。
**[Script settings]** (スクリプト設定) にある **[Execution duration in seconds]** (実行時間 (秒単位)) には、セットアップスクリプトのタイムアウト時間を入力します。
**注記**
秒単位の実行期間は、WorkSpaces アプリケーションがセットアップ後スクリプトの実行を待機してから続行するまでの時間です。セットアップ後のスクリプトがこの時間内に完了しない場合は、ユーザーにエラーが表示され、アプリケーションの起動が試行されます。実行時間経過後、セットアップスクリプトを終了します。
1. **[設定をインポート]** で、**[既存の App Block アプリケーションファイルを使用]** を選択します。**[S3 の場所]** には、アプリケーションパッケージ (VHD) を表す Amazon S3 バケット内のオブジェクトの Amazon S3 URI を入力できます。または、**[S3 を参照する]** を選択して Amazon S3 バケットに移動し、Amazon S3 バケット内のオブジェクトを選択することもできます。Amazon S3 バケットのリストはグローバルで、すべてのリージョンですべてのバケットがリスト表示されます。App Block を作成するリージョンのバケットを必ず選択してください。
1. [**次へ**] を選択します。
1. 入力した情報を確認して、**[App Block の作成]** をクリックします。
この時点で、App Block リソースが作成され、**[アクティブ]** 状態になります。
# App Block をテストする
App Block Builder を使用して App Block をテストし、アプリケーションの機能を検証できます。このオプションでは、Elastic フリートを起動する必要はありません。また、インスタンスタイプやサイズが異なる複数の App Block Builder を作成し、さまざまなコンピューティングオプションでアプリケーションのパフォーマンスをテストできます。
**注記**
テストアプリケーションブロックオプションは、WorkSpaces アプリケーションのパッケージ化されたアプリケーションブロックでのみサポートされています。
**App Block をテストするには**
1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションメニューから、**[アプリケーションマネージャー]**、**[App Block]** の順にクリックします。
1. テストする App Block を選択し、**[アクション]** メニューから **[テスト]** を選択します。
1. App Block Builder を選択し、**[App Block の起動とテスト]** を選択します。
+ リストが空の場合は、App Block Builder がないか、すべての App Block Builder が他の App Block に関連付けられています。新しい App Block Builder を作成するか、既存の App Block Builder の関連付けを解除してテストしてください。
+ App Block Builder が既に App Block に関連付けられている場合は、その App Block をそのまま使用して App Block をアクティブにできます。
+ 選択した App Block Builder が App Block Builder に関連付けられていない場合は、選択した App Block Builder に関連付けられ、ストリーミングセッションが開始されます。App Block Builder は、セッション終了後もこの App Block に関連付けられたままになります。
1. App Block Builder は、デスクトップストリーミングモードにおいて、別のブラウザウィンドウで起動します。このサービスによって Amazon S3 バケットから App Block をダウンロードし、App Block Builder インスタンスにインストールします。
1. これで、アプリケーションをストリーミングし、テストできます。アプリケーションを開くには、File Explorer を使用してアプリケーションを参照するか、[スタート] メニューを使用します。
1. テストが終了したら、ストリーミングセッションを終了します。
# Amazon WorkSpaces アプリケーションでアプリブロックを関連付ける
WorkSpaces Applications パッケージで App Block を作成、テスト、またはアクティブ化するには、App Block Builder に関連付ける必要があります。1 つの App Block Builder は 1 つの App Block にのみ関連付けることができ、その逆も同様です。
**注記**
App Block の関連付けと関連付け解除は、WorkSpaces Applications パッケージの App Block でのみサポートされます。
**Amazon WorkSpaces Applications で App Block Builder に App Block を関連付ける**
1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションメニューから、**[アプリケーションマネージャー]**、**[App Block]** の順にクリックします。
1. App Block を選択し、**[アクション]** メニューから **[関連付け]** を選択します。
1. App Block Builder を選択し、**[App Block Builder の関連付け]** を選択します。
リストが空の場合は、App Block Builder がないか、すべての App Block Builder が他の App Block に関連付けられています。新しい App Block Builder を作成するか、既存の App Block Builder の関連付けを解除してから関連付けしてください。
# Amazon WorkSpaces アプリケーションのアプリケーションブロックの関連付けを解除する
すべての App Block Builder が他の App Block に関連付けられていて、別の App Block をテスト、作成、アクティブ化する場合は、新しい App Block Builder を作成するか、既存の App Block Builder を App Block から切り離すことで、新しい App Block で使用できます。
**注記**
App Block の関連付けと関連付け解除は、WorkSpaces Applications パッケージの App Block でのみサポートされます。
関連付けの解除は、App Block Builder が **[停止済み]** 状態の場合のみ許可されます。
**App Block と App Block Builder の関連付けを解除する**
1. [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2) で WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションメニューから、**[アプリケーションマネージャー]**、**[App Block]** の順にクリックします。
1. App Block を選択し、**[アクション]** メニューから **[関連付けの解除]** を選択します。
1. 既に関連付けられた App Block Builder を選択し、**[App Block Builder の関連付けの解除]** を選択します。
# サポートされていないアプリケーション
次のシナリオでは、アプリケーションのインストールまたは実行時にエラーが発生する可能性があります。
+ **インストール後に再起動が必要なアプリケーション**: アプリケーションがインストール後に再起動が必要な追加の変更や設定を行う必要がある場合、エラーになる可能性があります。現在、App Block Builder は再起動をサポートしていないため、アプリケーションがインストール後に必要なステップを完了できない可能性があります。
+ **ユーザー固有の詳細に依存するアプリケーション**: App Block Builder に現在ログインしているユーザーのみにインストールすることを目的としたアプリケーション、またはインストール中のセキュリティ識別子 (SID) など、App Block Builder にログインしているユーザーの詳細に依存するアプリケーションは、Elastic フリートで正しく機能しない場合があります。これは、Elastic フリート環境内でのログインユーザーの変更によるものです。また、アプリケーションのリダイレクトでは、%USERPROFILE% の下のすべてのディレクトリが記録されるわけではありません。ただし、環境に基づいてアプリケーション構成を動的に変更するように、セットアップ後のスクリプトを設定することもできます。
+ **マシン固有の詳細に依存するアプリケーション**: ネットワークアダプタの GUID など、インストール時に App Block Builder のマシン固有の詳細に依存するアプリケーションでは、Elastic フリートで問題が発生する可能性があります。これは、ネットワークアダプタの GUID を含むマシンの詳細が、Elastic フリート環境内で変更される可能性があるためです。これに対処するため、これらのマシン固有の詳細の設定を処理するようにセットアップ後のスクリプトを構成できます。
アプリケーションがこれらのカテゴリのいずれかに該当するかどうか不明な場合は、WorkSpaces アプリケーションパッケージを使用してアプリケーションブロックを作成できます。このプロセスでは、アプリケーションを App Block Builder インスタンスにインストールします。アプリケーションを App Block Builder インスタンスにインストールできなかった場合は、次のアクションを実行できます。
+ ログの確認 App Block Builder インスタンスのエラーログファイルは C:\$1AppStream\$1AppBlocks\$1errorLog にあります。このログには、レジストリキーやファイル操作処理を含む、すべてのインストールエラーが記録されます。errorLog に次のログのいずれかが表示された場合は、アプリケーションのパッケージ化が WorkSpaces Applications App Block Builder で現在サポートされていないことを示します。
+ 「シンボリックリンクを作成できません」
+ 「サービスではファイル名の変更をサポートしていません」
errorLog ファイルがない場合、またはこのファイルが空の場合は、アプリケーションのインストールログを確認してエラーの原因を特定してください。
+ 問題の報告 App Block Builder のアプリケーションビルダーアシスタントにある **[問題の報告]** ボタンを選択します。このオプションを選択すると、App Block Builder インスタンスからすべての WorkSpaces アプリケーションログが収集され、WorkSpaces アプリケーションチームに送信されます。
+ カスタムパッケージを使用した App Block 作成: App Block Builder を使用してアプリケーションをパッケージ化できない場合は、カスタムパッケージの方法を使用して App Block の作成を試行できます。詳細については、「[カスタム App Blocks](custom-app-blocks.md)」を参照してください。
+ さらにサポートが必要な場合は、AWS サポートにお問い合わせください。詳細については、[AWS サポート センター](https://console.aws.amazon.com/support/home#/)を参照してください。
アプリケーションに WorkSpaces アプリケーションパッケージを使用する場合は、これらの潜在的な制限を考慮し、それに応じて計画することが重要です。