EC2Launch v2 设置

内联（默认）

EC2Launch v2 代理一次只能运行一个脚本（detach: false）。这是默认设置。

注意

当您的内联脚本发出 reset 或 sysprep 命令时，它会立即运行并重置代理。当前任务完成，然后代理在不运行任何其他任务的情况下关闭。

例如，如果发出命令的任务之后会有 startSsm 任务（默认情况下在用户数据运行后包括在内），则该任务不会运行，Systems Manager 服务也不会启动。

已分离

EC2Launch v2 代理与其他任务同时运行脚本（detach: true）。

注意

当分离的脚本发出 reset 或 sysprep 命令时，这些命令会等待代理完成后再运行。executeScript 之后的任务仍将运行。

内联（默认）

EC2Launch v2 代理一次只能运行一个脚本（detach: false）。这是默认设置。

注意

当您的内联脚本发出 reset 或 sysprep 命令时，它会立即运行并重置代理。当前任务完成，然后代理在不运行任何其他任务的情况下关闭。

例如，如果发出命令的任务之后会有 startSsm 任务（默认情况下在用户数据运行后包括在内），则该任务不会运行，Systems Manager 服务也不会启动。

已分离

EC2Launch v2 代理与其他任务同时运行脚本（detach: true）。

注意

当分离的脚本发出 reset 或 sysprep 命令时，这些命令会等待代理完成后再运行。executeScript 之后的任务仍将运行。

参数

--allowed-tags [tag-name-1、tag-name-n]

（可选）要显示在墙纸上的实例标签名称的 JSON 数组（采用 Base64 编码）。您可以使用此标签或 --all-tags，但不能同时使用两者。

--attributes attribute-string-1、attribute-string-n

（可选）以逗号分隔的 wallpaper 属性字符串列表，用于将设置应用于墙纸。

[--path | -p] path-string

（必需）指定 wallpaper 背景图像文件路径。

Flags

--all-tags

（可选）显示墙纸上的所有实例标签。您可以使用此标签或 --allowed-tags，但不能同时使用两者。

[--help | -h]

显示 wallpaper 命令的帮助信息。

输入

您可将运行时系统参数配置如下：

频率（字符串）

（必填）确切指定以下默认值中的一项：

• once

• always

路径（字符串）

（必填）要运行的可执行文件的路径。

参数（字符串列表）

（可选）以逗号分隔的参数列表，作为输入提供给程序。

运行为（字符串）

（必填）必须设置为 localSystem

输出

所有任务都会将日志文件条目写入 agent.log 文件。executeProgram 任务的其他输出会单独存储在一个动态命名的文件夹中，如下所示：

%LocalAppData%\Temp\EC2Launch#########\outputfilename.tmp

输出文件的确切路径包含在 agent.log 文件中，例如：

Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\ExecuteProgramInputs.tmp
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp

executeProgram 任务的输出文件

ExecuteProgramInputs.tmp

包含可执行文件的路径以及 executeProgram 任务将在运行时传递给该可执行文件的所有输入参数。

Output.tmp

包含 executeProgram 任务运行的程序的运行时系统输出。

Err.tmp

包含 executeProgram 任务运行的程序的运行时系统错误消息。

示例

以下示例演示了如何使用 executeProgram 任务从实例的本地目录运行可执行文件。

示例 1：带有一个参数的安装程序可执行文件

此示例演示了一个在静默模式下运行安装程序可执行文件的 executeProgram 任务。

task: executeProgram
inputs:
- frequency: always
  path: C:\Users\Administrator\Desktop\setup.exe
  arguments: ['-quiet']

示例 2：带有两个参数的 VLC 可执行文件

此示例演示了一个运行具有两个参数的 VLC 可执行文件的 executeProgram 任务，该任务将这两个参数作为输入参数传递。

task: executeProgram
inputs:
- frequency: always
  path: C:\vlc-3.0.11-win64.exe 
  arguments: ['/L=1033','/S']
  runAs: localSystem

内联（默认）

EC2Launch v2 代理一次只能运行一个脚本（detach: false）。这是默认设置。

注意

当您的内联脚本发出 reset 或 sysprep 命令时，它会立即运行并重置代理。当前任务完成，然后代理在不运行任何其他任务的情况下关闭。

例如，如果发出命令的任务之后会有 startSsm 任务（默认情况下在用户数据运行后包括在内），则该任务不会运行，Systems Manager 服务也不会启动。

已分离

EC2Launch v2 代理与其他任务同时运行脚本（detach: true）。

注意

当分离的脚本发出 reset 或 sysprep 命令时，这些命令会等待代理完成后再运行。executeScript 之后的任务仍将运行。

输入

您可将运行时系统参数配置如下：

频率（字符串）

（必填）确切指定以下默认值中的一项：

• once

• always

类型（字符串）

（必填）确切指定以下默认值中的一项：

• batch

• powershell

参数（字符串列表）

（可选）要传递给 Shell 的字符串参数的列表。type: batch 不支持此参数。

内容（字符串）

（必填）脚本内容。

运行为（字符串）

（必填）确切指定以下默认值中的一项：

• admin

• localSystem

分离（布尔值）

（可选）EC2Launch v2 代理默认每次运行一个脚本（detach: false）。要与其他任务同时运行脚本，请将此值设置为 true (detach: true)。

注意

如果将 detach 设置为 true，则脚本退出代码（包括 3010）不产生作用。

输出

所有任务都会将日志文件条目写入 agent.log 文件。executeScript 任务运行的脚本的其他输出会单独存储在一个动态命名的文件夹中，如下所示：

%LocalAppData%\Temp\EC2Launch#########\outputfilename.ext

输出文件的确切路径包含在 agent.log 文件中，例如：

Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\UserScript.ps1
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp

executeScript 任务的输出文件

UserScript.ext

包含 executeScript 任务运行的脚本。文件扩展名取决于您在 executeScript 任务的 type 参数中指定的脚本类型，如下所示：

• 如果类型为 batch，则文件扩展名为 .bat。

• 如果类型为 powershell，则文件扩展名为 .ps1。

Output.tmp

包含 executeScript 任务运行的脚本的运行时系统输出。

Err.tmp

包含 executeScript 任务运行的脚本的运行时系统错误消息。

示例

以下示例演示了如何使用 executeScript 任务运行内联脚本。

示例 1：Hello world 输出文本文件

此示例演示了一个运行 PowerShell 脚本，以在 C: 驱动器上创建一个“Hello world”文本文件的 executeScript 任务。

task: executeScript
inputs:
- frequency: always
  type: powershell
  runAs: admin
  content: |-
    New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
    Set-Content 'C:\PowerShellTest.txt' "Hello world"

示例 2：运行两个脚本

此示例说明了 executeScript 任务可以运行多个脚本，并且脚本类型不必一致。

第一个脚本 (type: powershell) 会将当前在实例上运行的进程的摘要写入 C: 驱动器上的一个文本文件。

第二个脚本 (batch) 会将系统信息写入 Output.tmp 文件。

task: executeScript
inputs:
- frequency: always
  type: powershell
  content: |
    Get-Process | Out-File -FilePath C:\Process.txt
  runAs: localSystem
- frequency: always
  type: batch
  content: |
    systeminfo

示例 3：重启后的幂等系统配置

此示例显示了一个运行一个幂等脚本来执行以下系统配置，并在每个步骤之间重新启动的 executeScript 任务：

• 将计算机重命名。

• 将计算机加入到域中。

• 启用 Telnet。

该脚本会确保每个操作仅运行一次，从而防止循环重启并确保脚本的幂等性。

task: executeScript
inputs:
- frequency: always
  type: powershell
  runAs: localSystem
  content: |-
    $name = $env:ComputerName
     if ($name -ne $desiredName) {
       Rename-Computer -NewName $desiredName
       exit 3010
     }
     $domain = Get-ADDomain
     if ($domain -ne $desiredDomain) 
     {
       Add-Computer -DomainName $desiredDomain
       exit 3010
     }
    $telnet = Get-WindowsFeature -Name Telnet-Client
    if (-not $telnet.Installed)
    {
      Install-WindowsFeature -Name "Telnet-Client"
      exit 3010 
    }

输入

您可将运行时系统参数配置如下：

设备（映射列表）

（如有条件）启动代理初始化的每个设备的配置。当 initialize 输入参数设置为 devices 时，则为必需。

• 设备（字符串，必需）- 在创建实例期间标识设备。例如，xvdb、xvdf 或 \dev\nvme0n1。

• 字母（字符串，可选）- 一个字符。要分配的驱动器号。

• 名称（字符串，可选）- 要分配的卷名称。

• 分区（字符串，可选）- 为要创建的分区类型指定以下值之一，或者让启动代理根据卷大小进行默认设置：

  • MBR

  • GPT

初始化（字符串）

（必填）确切指定以下默认值中的一项：

• all

• devices

示例

以下示例显示了 initializeVolume 任务的示例输入配置。

示例 1：在一个实例上初始化两个卷

此示例显示了一个在实例上初始化两个辅助卷的 initializeVolume 任务。示例中名为 DataVolume2 的设备是临时的。

task: initializeVolume
inputs:
  initialize: devices
  devices:
  - device: xvdb
    name: DataVolume1
    letter: D
    partition: mbr
  - device: /dev/nvme0n1
    name: DataVolume2
    letter: E
    partition: gpt

输入

您提供的输入参数以及可设置以配置墙纸的属性：

属性（字符串列表）

（可选）您可以向墙纸添加以下一项或多项属性：

• architecture

• availabilityZone

• hostName

• instanceId

• instanceSize

• memory

• network

• privateIpAddress

• publicIpAddress

InstanceTags

（可选）您可以仅使用以下选项之一进行此设置。

• AllTags（字符串）– 将所有实例标签添加到墙纸。

  instanceTags: AllTags

• InstanceTags（字符串列表）– 指定要添加到墙纸的实例标签名称列表。例如：

  instanceTags:
    - Tag 1
    - Tag 2

路径（字符串）

（必需）用于墙纸图像的本地 .jpg 格式图像文件的文件名路径。