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

# ストリーミングセッションの開始前にスクリプトを実行する
<a name="run-scripts-before-streaming-sessions-begin"></a>

ユーザーのアプリケーションが起動されてストリーミングセッションが開始されるまでに最大 60 秒間実行されるようにスクリプトを設定できます。これにより、ユーザーがアプリケーションのストリーミングを開始する前に WorkSpaces アプリケーション環境をカスタマイズできます。セッションスクリプトが実行されると、読み込みスピナーがユーザーに表示されます。スクリプトが正常に完了するか、最大待機時間が経過すると、ユーザーのストリーミングセッションが開始されます。スクリプトが正常に完了しなかった場合は、エラーメッセージがユーザーに表示されます。ただし、ユーザーはストリーミングセッションの使用を禁止されません。

Windows インスタンスでファイル名を指定するときは、ダブルバックスラッシュを使用する必要があります。例えば、次のようになります。

C:\$1\$1Scripts\$1\$1Myscript.bat

二重のバックスラッシュを使用しないと、.json ファイル形式が正しくないことを示すエラーが表示されます。

**注記**  
スクリプトは正常に完了したら、値 0 を返します。スクリプトが 0 以外の値を返した場合、WorkSpaces Applications はユーザーにエラーメッセージを表示します。

ストリーミングセッションが開始される前にスクリプトを実行し、WorkSpaces アプリケーション動的アプリケーションフレームワークが有効になっていない場合、次のプロセスが発生します。

![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/ja_jp/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)


1. ユーザーは、ドメインに参加していない WorkSpaces アプリケーションフリートインスタンスに接続します。この接続には、以下のいずれかのアクセス方法を使用します。
   + WorkSpaces アプリケーションユーザープール
   + SAML 2.0
   + WorkSpaces アプリケーション API

1. アプリケーションカタログが WorkSpaces アプリケーションポータルに表示され、ユーザーは起動するアプリケーションを選択します。

1. 以下のいずれかのプロセスが発生します。
   + ユーザーに対してアプリケーション設定の永続化が有効になっている場合は、ユーザーのカスタマイズ内容と Windows の設定内容を保存しているアプリケーション設定の Virtual Hard Disk (VHD) ファイルがダウンロードされてマウントされます。この場合は、Windows ユーザーのログインが必要です。

     アプリケーション設定の永続化については、[WorkSpaces アプリケーションユーザーのアプリケーション設定の永続化を有効にする](app-settings-persistence.md) を参照してください。
   + アプリケーション設定の永続化が有効になっていない場合、Windows ユーザーはすでにログインしています。

1. セッションスクリプトが起動されます。ユーザーに対して永続的ストレージが有効になっている場合は、ストレージコネクタのマウントも開始されます。永続的ストレージについては、[WorkSpaces アプリケーションユーザーの永続的ストレージの有効化と管理](persistent-storage.md) を参照してください。
**注記**  
ストリーミングセッションを開始するためにストレージコネクタのマウントを完了する必要はありません。セッションスクリプトが完了したとき、まだストレージコネクタのマウントが完了していなくても、ストリーミングセッションは開始されます。  
ストレージコネクタのマウント状況のモニタリングについては、[セッションスクリプトでストレージコネクタを使用する](use-storage-connectors-with-session-scripts.md) を参照してください。

1. セッションスクリプトは完了するかタイムアウトします。

1. ユーザーのストリーミングセッションが開始されます。

1. ユーザーが選択したアプリケーションが起動されます。

WorkSpaces Applications 動的アプリケーションフレームワークの詳細については、「」を参照してください[WorkSpaces アプリケーション動的アプリケーションフレームワークを使用して動的アプリケーションプロバイダーを構築する](build-dynamic-app-provider.md)。

ストリーミングセッションが開始される前にスクリプトを実行し、WorkSpaces アプリケーション動的アプリケーションフレームワークが有効になっている場合、次のプロセスが発生します。

![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/ja_jp/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)


1. ユーザーは組織の SAML 2.0 アプリケーションポータルにアクセスし、WorkSpaces アプリケーションスタックを選択します。

1. ドメインに参加している WorkSpaces アプリケーションフリートインスタンスに接続します。

1. ユーザーに対してアプリケーション設定の永続化が有効になっている場合は、ユーザーのカスタマイズ内容と Windows の設定内容を保存しているアプリケーション設定の VHD ファイルがダウンロードされてマウントされます。

1. Windows ユーザーのログオンが発生します。

1. アプリケーションカタログが WorkSpaces アプリケーションポータルに表示され、ユーザーは起動するアプリケーションを選択します。

1. セッションスクリプトが起動されます。ユーザーに対して永続的ストレージが有効になっている場合は、ストレージコネクタのマウントも開始されます。
**注記**  
ストリーミングセッションを開始するためにストレージコネクタのマウントを完了する必要はありません。セッションスクリプトが完了したとき、まだストレージコネクタのマウントが完了していなくても、ストリーミングセッションは開始されます。  
ストレージコネクタのマウント状況のモニタリングについては、[セッションスクリプトでストレージコネクタを使用する](use-storage-connectors-with-session-scripts.md) を参照してください。

1. セッションスクリプトは完了するかタイムアウトします。

1. ユーザーのストリーミングセッションが開始されます。

1. ユーザーが選択したアプリケーションが起動されます。