Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用会话脚本来管理您的用户的流式传输体验

WorkSpaces Pools 提供实例上的会话脚本。当用户的流式传输会话中发生特定事件时，您可以使用这些脚本来运行自己的自定义脚本。例如，您可以在用户的流式传输会话开始之前使用自定义脚本来准备 WorkSpaces Pools 环境。您还可以在用户完成其流式传输会话后使用自定义脚本清理流实例。

会话脚本是在 WorkSpace 映像中指定的。这些脚本在用户上下文或系统上下文中运行。如果您的会话脚本使用标准输出来编写信息、错误或调试消息，则可以选择将这些脚本保存到 Amazon Web Services 账户内的 Amazon S3 存储桶中。

在流式传输会话开始前运行脚本

您可以将脚本配置为在用户的应用程序启动和其流式传输会话开始前运行最多 60 秒。这样做可以让您在用户开始流式传输其应用程序前自定义 WorkSpaces Pools 环境。在会话脚本运行时，会为您的用户显示加载转盘。当您的脚本成功完成或超过最长等待时间时，用户的流式传输会话将开始。如果脚本未成功完成，则会为用户显示错误消息。但是，不会阻止您的用户使用其流式传输会话。

在指定 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 Pools 会自动捕获写入标准输出的会话脚本的输出。此输出将上传到您账户中的 Amazon S3 存储桶。您可以查看日志文件以进行故障排除或调试。

结合使用永久存储与会话脚本

启用 WorkSpaces 永久存储后，存储会在会话启动脚本运行时开始装载。如果您的脚本依赖于正在装载的永久存储，则可以等待连接器可用。WorkSpaces 在 Windows WorkSpaces 上的 Windows 注册表中维护存储连接器的装载状态，键值如下：

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

注册表项值如下所示：

每个存储连接器注册表项都包含 MountStatus DWORD 值。下表列出了 MountStatus 的可能值。

为会话脚本日志启用 Amazon S3 存储桶存储

在会话脚本配置中启用 Amazon S3 日志记录后，WorkSpaces Pools 会从会话脚本中捕获标准输出。输出会定期上传到您的 Amazon Web Services 账户中的 S3 存储桶。对于每个 Amazon 区域，WorkSpaces Pools 会在您的账户中创建一个对于您的账户和该区域而言是唯一的存储桶。

您无需执行任何配置任务即可管理这些 S3 存储桶。它们由 WorkSpaces 服务完全托管。存储在每个存储桶中的日志文件在传输中使用 Amazon S3 的 SSL 端点进行加密，在静态期间使用 Amazon S3 托管的加密密钥进行加密。存储桶以特定格式命名，如下所述：

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

例如，如果您在账号 123456789012 美国西部（俄勒冈州）（us-west-2）区域中的映像中指定会话脚本，则 WorkSpaces Pools 会在您账户的该区域中创建一个具有如下所示名称的 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 启动的流式传输会话。会话使用用户 ID testuser@mydomain.com 的 API（来自 Amazon Web Services 账户 ID 123456789012）和美国西部（俄勒冈州）区域（us-west-2）中的设置组 test-stack：

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

此示例文件夹结构包含一个用于用户上下文会话启动脚本的日志文件，以及一个用于系统上下文会话启动脚本的日志文件（如果适用）。