翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Image Builder のトラブルシューティング
Amazon AppStream 2.0 イメージビルダーを使用する際に発生する可能性のある問題は次のとおりです。
問題
- Image Builder からインターネットに接続できない。
- アプリケーションをインストールするときに、「このオペレーティングシステムのバージョンはサポートされていません」というエラーが表示されます。
- Windows PowerShell スクリプトを使用してアプリケーションを開きたい。
- ClickOnce アプリケーションをユーザーが利用できるようにしたい。
- Image Builder に接続するときに、Ctrl+Alt+Delete を入力してログインするように求めるログイン画面が表示されます。しかし、キーストロークがローカルマシンにインターセプトされます。
- 管理者モードおよびテストモードに切り替えるときに、パスワードが要求されます。パスワードを取得する方法がわかりません。
- インストールされているアプリケーションを追加するとエラーが発生します。
- Image Builder のバックグラウンドサービスを誤って終了して、切断されました。Image Builder に接続できなくなりました。
- アプリケーションのテストモードでの起動ができなくなります。
- VPC で、アプリケーションがネットワークリソースに接続できませんでした。
- Image Builder デスクトップをカスタマイズしましたが、作成したイメージからフリートを起動してセッションに接続した後、変更内容が使用できません。
- アプリケーションを起動するときにコマンドラインパラメータがなくなります。
- ウイルス対策アプリケーションをインストールした後、フリートでイメージを使用できません。
- イメージ作成に失敗しました。
- PrewarmManifest.txt へのアクセスが拒否されたというエラーメッセージが表示され、Image Assistant create-image の操作が失敗しました。
Image Builder からインターネットに接続できない。
Image Builder は、デフォルトではインターネットと通信することはできません。この問題を解決するには、インターネットにアクセスできる VPC サブネットで Image Builder を起動します。VPC サブネットからのインターネットアクセスを有効にするには、NAT ゲートウェイを使用します。または、VPC にインターネットゲートウェイを設定し、Image Builder に Elastic IP アドレスをアタッチできます。詳細については、「Amazon AppStream 2.0 のネットワークとアクセス」を参照してください。
アプリケーションをインストールするときに、「このオペレーティングシステムのバージョンはサポートされていません」というエラーが表示されます。
AppStream 2.0 イメージに追加できるのは、Windows Server 2012 R2、Windows Server 2016、および Windows Server 2019 にインストールできるアプリケーションだけです。使用する Image Builder に応じて、これら 3 つのオペレーティングシステムのいずれかでアプリケーションがサポートされているかどうかを確認してください。
Windows PowerShell スクリプトを使用してアプリケーションを開きたい。
Windows PowerShell スクリプトを使用して、フリートインスタンスでアプリケーションを開くことができます。アプリケーションを開く前に、これを実行してアプリケーションまたは環境を設定できます。アプリケーション用の Windows PowerShell スクリプトを起動するには、 PowerShell イメージアシスタントで.exe ファイルを指定します。C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe に移動し、次の起動パラメータを指定します。
-ファイル "C:\Path\To\PowerShell\ Script.ps1"
注記
指定したスクリプトでアプリケーションを開くには、スクリプト実行ポリシーをオーバーライドする必要があります。 PowerShell そのためには、-ExecutionPolicy Bypass を起動パラメータに追加します。
ClickOnce アプリケーションをユーザーが利用できるようにしたい。
AppStream 2.0 ClickOnce ユーザーがアプリケーションを利用できるようにするには、まず管理者として Image Builder にアプリケーションをインストールし、次にテンプレートユーザーとしてアプリケーションをインストールする必要があります。 ClickOnce アプリケーションにはユーザー固有のインストールが必要なため、ユーザーがフリートインスタンスからアプリケーションを起動できるようにするには、アプリケーションをテンプレートユーザーとしてインストールする必要があります。 ClickOnce アプリケーションを管理者としてインストールし、次にテンプレートユーザーとしてインストールするには、次の手順を実行します。
https://console.aws.amazon.com/appstream2
にある AppStream 2.0 コンソールを開きます。 -
左側のナビゲーションペインで、[Images] (イメージ)、[Image Builder] の順に選択します。
リストで、使用する Image Builder を選択し、管理者 としてログインします。
appref-msファイルを呼び出すバッチファイルをユーザープロファイル内に作成します。%APPDATA% 環境変数を使用して C:\Users\username\\ AppData Roaming を置き換えてください。バッチファイル呼び出しの例を次に示します。explorer "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Company\ClickOnce.appref-ms"Image Builder デスクトップから、Image Assistant を開きます。
[Configure Apps (アプリケーションの構成)] ページで、[Switch user (ユーザーの切り替え)] を選択します。
[Local User] タブで、[Template User] を選択します。
テンプレートユーザーとしてログインした後、アプリケーションをもう一度インストールします。
Image Builder デスクトップから、Image Assistant を開きます。
「アプリケーションの設定」ページで、 ClickOnce アプリケーションを開いて正しく機能することを確認します。テストが完了したら、[Switch user (ユーザーの切り替え)] を選択します。
管理者として再度ログインし、Image Assistant で必要なステップを実行してイメージの作成を終了します。
Image Builder に接続するときに、Ctrl+Alt+Delete を入力してログインするように求めるログイン画面が表示されます。しかし、キーストロークがローカルマシンにインターセプトされます。
クライアントが、特定のキーの組み合わせを Image Builder セッションに送信せずに、ローカルでインターセプトする場合があります。Ctrl+Alt+Delete キーの組み合わせを Image Builder に確実に送信するために、[Admin Commands]、[Send Ctrl+Alt+Delete] の順に選択します。[Admin Commands] メニューは、Image Builder セッションツールバーの右上隅で利用できます。
管理者モードおよびテストモードに切り替えるときに、パスワードが要求されます。パスワードを取得する方法がわかりません。
AppStream 2.0 では通常、自動的に選択したユーザーモードにログインします。状況によっては、この切り替えが自動的に行われないことがあります。パスワードがリクエストされた場合は、[Admin Commands (管理コマンド)]、[Log me in (ログイン)] の順に選択します。ワンタイムパスワードを Image Builder に安全に送信し、[Password] フィールドに貼り付けます。
インストールされているアプリケーションを追加するとエラーが発生します。
アプリケーションのタイプがサポートされているかどうかを確認してください。アプリケーションのタイプ .exe､.lnk､および .bat を追加できます。
C:\Users フォルダの階層にアプリケーションがインストールされているかを確認してください。C:\Users にインストールされているアプリケーションはサポートされていません。アプリケーションをインストールするときは、C:\ の別のインストールフォルダを選択してください。
Image Builder のバックグラウンドサービスを誤って終了して、切断されました。Image Builder に接続できなくなりました。
Image Builder を停止して、再起動し、再度接続してください。問題が解決しない場合は、新しい Image Builder を起動 (作成) する必要があります。Image Builder インスタンスで実行されているバックグラウンドサービスを停止しないでください。停止すると、Image Builder セッションが中断されたり、イメージ作成に支障が生じたりする場合があります。
アプリケーションのテストモードでの起動ができなくなります。
アプリケーションで、昇格されたユーザー権限、または通常は管理者のみが使用できる特別なアクセス権限が必要かどうかを確認してください。Image Builder テストモードには、エンドユーザーが AppStream 2.0 テストフリートに対して持っているのと同じ制限付き権限が Image Builder インスタンスに適用されます。昇格されたアクセス許可を必要とするアプリケーションは、Image Builder テストモードでは起動しません。
VPC で、アプリケーションがネットワークリソースに接続できませんでした。
Image Builder が、正しい VPC サブネットで起動されたかどうかを確認してください。また、必要に応じて VPC のルートテーブルが接続を許可するように設定されていることも確認してください。
Image Builder デスクトップをカスタマイズしましたが、作成したイメージからフリートを起動してセッションに接続した後、変更内容が使用できません。
時間の設定など、ローカルユーザーセッションの一部として保存される変更は、イメージを作成するときに保持されません。ローカルユーザーセッションの変更を保持するには、Image Builder インスタンスのローカルグループポリシーに追加します。
アプリケーションを起動するときにコマンドラインパラメータがなくなります。
Image Builder を使用してアプリケーションをイメージに追加するときに、コマンドラインパラメータを指定できます。アプリケーションの起動パラメータをユーザーごとに変更しない場合は、Image Builder インスタンスでアプリケーションをイメージに追加する際に起動パラメータを入力できます。
起動ごとに起動パラメータが異なる場合は、CreateStreamingURL API を使用して、プログラムによって指定できます。API フィールドで、sessionContext パラメータと applicationID パラメータを設定します。sessionContext はアプリケーションの起動時にコマンドラインオプションとして含まれています。
起動パラメータをオンザフライで計算する必要がある場合は、スクリプトを使用してアプリケーションを起動することができます。計算されたパラメータを使用してアプリケーションを起動する前に、スクリプト内で sessionContext パラメータを解析できます。
ウイルス対策アプリケーションをインストールした後、フリートでイメージを使用できません。
イメージを作成する前に Image Builder を使用して、ウイルス対策プログラムを含むあらゆるツールを AppStream 2.0 スタックにインストールできます。ただし、これらのプログラムでは、 AppStream 2.0 サービスが使用しているネットワークポートをブロックしたり、プロセスを停止したりしないでください。イメージを作成して、これをフリートで使用する前に、アプリケーションを Image Builder テストモードでテストすることをお勧めします。
イメージ作成に失敗しました。
イメージの作成を開始する前に、 AppStream 2.0 サービスに変更を加えていないことを確認してください。イメージを再度作成してみてください。失敗した場合は、 AWS Supportにお問い合わせください。詳細については、AWS Support センター
PrewarmManifest.txt へのアクセスが拒否されたというエラーメッセージが表示され、Image Assistant create-image の操作が失敗しました。
アプリケーションの最適化マニフェストは、昇格された権限で作成されています。イメージを作成するには、次のいずれかを実行してから、もう一度試してください。
Image Assistant コマンドラインインターフェイス (CLI) 実行可能ファイル (Image-Assistant.exe) を管理者特権で実行する。
アプリケーションの最適化マニフェストファイルを削除する。
