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

セッションスクリプトを使用してユーザーのストリーミングエクスペリエンスを管理する

WorkSpaces プールはインスタンスセッションスクリプトを提供します。ユーザーのストリーミングセッションで特定のイベントが発生したときに、これらのスクリプトを使用して独自のカスタムスクリプトを実行できます。たとえば、カスタムスクリプトを使用して、ユーザーのストリーミングセッションを開始する前に WorkSpaces プール環境を準備できます。ユーザーがストリーミングセッションを完了した後に、カスタムスクリプトを使用してストリーミングインスタンスをクリーンアップすることもできます。

セッションスクリプトは WorkSpace イメージ内で指定されます。これらのスクリプトはユーザーコンテキストまたはシステムコンテキスト内で実行されます。セッションスクリプトが情報、エラー、またはデバッグメッセージの書き込みに標準出力を使用する場合は、オプションで、それらを Amazon Web Services アカウント内の Amazon S3 バケットに保存することができます。

ストリーミングセッションの開始前にスクリプトを実行する

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

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

C:\\Scripts\\Myscript.bat

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

ストリーミングセッションの開始前にスクリプトを実行すると、以下のプロセスが発生します。

ストリーミングセッションの終了後にスクリプトを実行する

ユーザーのストリーミングセッションの終了後にスクリプトを実行するように設定することもできます。たとえば、ユーザーが WorkSpaces クライアントツールバーからセッションの終了を選択した場合や、セッションの最大許容期間に達した場合にスクリプトを実行できます。これらのセッションスクリプトを使用して、ストリーミングインスタンスが削除される前に WorkSpaces 環境をクリーンアップすることもできます。たとえば、スクリプトを使用してファイルロックを解除したり、ログファイルをアップロードしたりできます。ストリーミングセッションの終了後にスクリプトを実行すると、以下のプロセスが発生します。

セッションスクリプトを作成および指定する

WorkSpaces プール WorkSpaces で のセッションスクリプトを作成して指定するには、次の手順を実行します。

セッションスクリプト設定ファイル

Windows インスタンス上のセッションスクリプト設定ファイルを見つけるには、C:\AWSEUC\SessionScripts\config.json に移動します。ファイル形式は次のとおりです。

{
  "SessionStart": {
    "executables": [
      {
        "context": "system",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      },
      {
        "context": "user",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      }
    ],
    "waitingTime": 30
  },
  "SessionTermination": {
    "executables": [
      {
        "context": "system",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      },
      {
        "context": "user",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      }
    ],
    "waitingTime": 30
  }
}

セッションスクリプト設定ファイルでは、以下のパラメータを使用できます。

Windows PowerShell ファイルの使用

Windows PowerShell ファイルを使用するには、 filenameパラメータで PowerShell ファイルへのフルパスを指定します。

"filename": 
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",

次に、arguments パラメータにセッションスクリプトを指定します。

"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",

最後に、 PowerShell 実行ポリシーで PowerShell ファイルの実行が許可されていることを確認します。

セッションスクリプト出力のログ記録

設定ファイルでこのオプションを有効にすると、 WorkSpaces Pool は標準出力に書き込まれたセッションスクリプトからの出力を自動的にキャプチャします。この出力はアカウントの Amazon S3 バケットにアップロードされます。トラブルシューティングやデバッグの目的でログファイルを確認できます。

セッションスクリプトで永続的ストレージを使用する

永 WorkSpaces 続ストレージを有効にすると、セッション開始スクリプトの実行時にストレージのマウントが開始されます。スクリプトがマウントされている永続的ストレージに依存している場合は、コネクタが使用可能になるまで待つことができます。 は WorkSpacesWindows の Windows レジストリのストレージコネクタのマウントステータスを次のキーで WorkSpaces 維持します。

HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\AppStream\Storage\<provided user
                name>\<Storage connector>

レジストリキーの値は以下のとおりです。

各ストレージコネクタレジストリキーには MountStatusDWORD値が含まれています。次の表に、 の可能な値を示しますMountStatus。

セッションスクリプトログに対して Amazon S3 バケットストレージを有効にする

セッションスクリプト設定で Amazon S3 ログ記録を有効にすると、 WorkSpaces Pool はセッションスクリプトからの標準出力をキャプチャします。出力は、Amazon Web Services アカウント内の S3 バケットに定期的にアップロードされます。 AWS リージョンごとに、 WorkSpaces プールはアカウントとリージョンに固有のバケットをアカウントに作成します。

これらの S3 バケットを管理するための設定タスクを実行する必要はありません。これらは WorkSpaces サービスによって完全に管理されます。各バケットに保存されているログファイルは、Amazon S3 のSSLエンドポイントを使用して転送中に暗号化され、Amazon S3-managed暗号化キーを使用して保管時に暗号化されます。バケットは、以下にあるような特定の形式で命名されます。

wspool-logs-<region-code>-<account-id-without-hyphens>-random-identifier

例えば、アカウント番号 の米国西部 (オレゴン) リージョン (us-west-2) のイメージでセッションスクリプトを指定すると123456789012、 WorkSpaces Pool はそのリージョンのアカウント内に表示されている名前で Amazon S3 バケットを作成します。適切なアクセス許可を持つ管理者のみが、このバケットを削除できます。

wspool-logs-us-west-2-1234567890123-abcdefg

セッションスクリプトを無効にしても、S3 バケットに保存されているログファイルは削除されません。ログファイルを完全に削除するには、Amazon S3 コンソールまたは を使用して、適切なアクセス許可を持つ別の管理者が削除する必要がありますAPI。 WorkSpaces Pools は、バケットの誤った削除を防止するバケットポリシーを追加します。

セッションスクリプトを有効にすると、開始されるストリーミングセッションごとに固有のフォルダが作成されます。

アカウントの S3 バケットでログファイルが保存されているフォルダへのパスは、以下の構造になります。

<bucket-name>/<stack-name>/<fleet-name>/<access-mode>/<user-id-SHA-256-hash>/<session-id>/SessionScriptsLogs/<session-event>

以下のフォルダ構造の例は、test-stack と test-fleet から始まるストリーミングセッションに当てはまります。セッションではtestuser@mydomain.com、ユーザー ID APIの 、 の AWS アカウント ID123456789012、およびtest-stack米国西部 (オレゴン) リージョン () の設定グループを使用しますus-west-2。

wspool-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/

このフォルダ構造の例には、ユーザーコンテキストセッション開始スクリプト用の 1 つのログファイルと、必要に応じてシステムコンテキストセッション開始スクリプト用の 1 つのログファイルが含まれています。