本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用批处理 PowerShell 脚本配置 Windows Lightsail 实例
<a name="create-powershell-script-that-runs-when-you-create-windows-based-instance-in-lightsail"></a>

创建基于 Windows 的实例时，可以使用 Windows PowerShell 脚本或任何其他批处理脚本对其进行配置。这是在您的实例启动后立即运行的一次性脚本。本主题介绍了这些脚本的语法，并提供一个示例以说明如何使用这些脚本。我们还介绍了如何测试您的脚本以确定其是否成功运行。

## 创建启动并运行 PowerShell 脚本的实例
<a name="windows-powershell-create-instance"></a>

以下过程会在新实例上安装一个名为 *chocolatey* 的工具，它在实例启动后立即运行。

1. 在左侧导航窗格中，选择**创建实例**。

1. 选择要在其中创建实例的 AWS 区域 和可用区。

1. 在 **Select a platform**（选择平台）下，选择 **Microsoft Windows**。

1. 选择**仅限操作系统**，然后选择 **Windows Server 2022**、**Windows Server 2019**、**Windows Server 2016**。

1. 选择 **Add launch script**（添加启动脚本）。

1. 键入以下内容：

   ```
   <powershell>
   iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
   </powershell>
   ```
**注意**  
必须始终将 PowerShell 脚本封装在`<powershell></powershell>`标签中。您可以使用`<script></script>`标签输入非PowerShell命令或批处理脚本，也可以不使用任何标签。

1. 输入实例的名称。

   资源名称：
   + 在你的 Lightsail 账户 AWS 区域 中，每个账户中必须是唯一的。
   + 必须包含 2 到 255 个字符。
   + 必须以字母数字字符或数字作为开头和结尾。
   + 可以包括字母数字字符、数字、句点、连字符和下划线。

1. （可选）选择**添加新标签**来为您的实例添加一个标签。根据需要重复此步骤以添加更多标签。有关标签使用的更多信息，请参阅[标签](amazon-lightsail-tags.md)。

   1. 对于**键**，请输入标签键。  
![\[仅包含在 Lightsail 创建实例工作流程中指定的标签密钥的标签。\]](http://docs.aws.amazon.com/zh_cn/lightsail/latest/userguide/images/amazon-lightsail-instance-key-name-only-tags.png)

   1. （可选）对于**值**，请输入标签值。  
![\[一个标签，其标签键和标签值在 Lightsail 创建实例工作流程中指定。\]](http://docs.aws.amazon.com/zh_cn/lightsail/latest/userguide/images/amazon-lightsail-instance-key-name-and-value-tags.png)

1. 选择 **Create instance**（创建实例）。

## 验证您的脚本是否成功运行
<a name="windows-powershell-verify-script-ran-successfully"></a>

您可以登录到您的实例以验证该脚本是否成功运行。基于 Windows 的实例最多可能需要 15 分钟的时间，才能准备好接受 RDP 连接。在准备就绪后，请使用基于浏览器的 RDP 客户端登录或配置您自己的 RDP 客户端。有关更多信息，请参阅[连接到基于 Windows 的实例](connect-to-your-windows-based-instance-using-amazon-lightsail.md)。

1. 连接到 Lightsail 实例后，打开命令提示符（或打开 Windows 资源管理器）。

1. 键入以下命令以转到 `Log` 目录：

   ```
   cd C:\ProgramData\Amazon\EC2-Windows\Launch\Log
   ```

1. 在文本编辑器中打开 `UserdataExecution.log`，或者键入以下命令：`type UserdataExecution.log`。

   将会在日志文件中看到以下内容。

   ```
   2017/10/11 20:32:12Z: <powershell> tag was provided.. running powershell content
   2017/10/11 20:32:13Z: Message: The output from user scripts: iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
   
   2017/10/11 20:32:13Z: Userdata execution done
   ```