

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Konfigurasikan pengaturan EC2 Launch v2 untuk instance Windows
<a name="ec2launch-v2-settings"></a>

Bagian ini berisi informasi tentang cara mengkonfigurasi pengaturan untuk EC2 Launch v2.

**Topics**
+ [Ubah pengaturan menggunakan kotak dialog EC2 Launch v2 settings](#ec2launch-v2-ui)
+ [Konfigurasikan EC2 Launch v2 menggunakan CLI](#ec2launch-v2-cli)
+ [EC2Luncurkan konfigurasi tugas v2](#ec2launch-v2-task-configuration)
+ [EC2Luncurkan kode keluar v2 dan reboot](#ec2launch-v2-exit-codes-reboots)
+ [EC2Luncurkan v2 dan Sysprep](#ec2launch-v2-sysprep)

## Ubah pengaturan menggunakan kotak dialog EC2 Launch v2 settings
<a name="ec2launch-v2-ui"></a>

Prosedur berikut menjelaskan cara menggunakan kotak dialog pengaturan EC2 Launch v2 untuk mengaktifkan atau menonaktifkan pengaturan.
**catatan**  
Jika Anda mengonfigurasi tugas khusus secara tidak benar di file agent-config.yml. dan Anda mencoba membuka kotak dialog pengaturan EC2 Peluncuran Amazon, Anda akan menerima kesalahan. Untuk contoh skema, lihat [Contoh: `agent-config.yml`](#ec2launch-v2-example-agent-config).

1. Jalankan dan hubungkan ke instans Windows Anda.

1. Dari menu Start, pilih **All Programs**, lalu navigasikan ke **EC2Launch settings**. Sebelum Anda memilih **Shutdown dengan Sysprep** atau **Shutdown tanpa Sysprep**, pastikan bahwa Anda menyimpan setiap perubahan yang ingin Anda terapkan ketika Anda menjalankan shutdown.  
![\[Aplikasi pengaturan EC2 Launch.\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/images/ec2launchv2-settings.png)

1. Pada tab **Umum** dari kotak dialog **Pengaturan EC2 peluncuran**, Anda dapat mengaktifkan atau menonaktifkan pengaturan berikut.

   1. **Atur Nama Komputer**

      Jika pengaturan ini diaktifkan (dinonaktifkan secara default), maka nama host saat ini dibandingkan dengan nama host yang diinginkan di setiap boot. Jika nama host tidak cocok, maka nama host disetel ulang, dan sistem kemudian secara opsional melakukan boot ulang untuk mengambil nama host baru. Jika nama host kustom tidak ditentukan, itu dihasilkan menggunakan alamat pribadi IPv4 berformat heksadesimal, misalnya,. `ip-AC1F4E6` Untuk mencegah perubahan nama host yang ada, jangan aktifkan pengaturan ini.

   1. **Perpanjang Volume Boot**

      Pengaturan ini secara dinamis memperluas `Disk 0`/`Volume 0` untuk memasukkan ruang yang tidak dipartisi. Ini dapat berguna ketika instance di-boot dari volume root yang memiliki ukuran khusus.

   1. **Atur Akun Administrator**

      Saat diaktifkan, Anda dapat mengatur atribut nama pengguna dan kata sandi untuk akun administrator yang dibuat di mesin lokal Anda. Jika fitur ini tidak diaktifkan, akun administrator tidak dibuat di sistem setelah Sysprep. Berikan kata sandi dalam`adminPassword` hanya jika`adminPasswordtype` adalah`Specify`.

      Jenis kata sandi ditentukan sebagai berikut:

      1. `Random`

         EC2Peluncuran menghasilkan kata sandi dan mengenkripsi menggunakan kunci pengguna. Sistem akan menonaktifkan pengaturan ini setelah instans dijalankan sehingga kata sandi ini akan tetap ada jika instans tersebut di-boot ulang atau dihentikan dan dimulai.

      1. `Specify`

         EC2Peluncuran menggunakan kata sandi yang Anda tentukan`adminPassword`. Jika kata sandi tidak memenuhi persyaratan sistem, EC2 Launch menghasilkan kata sandi acak sebagai gantinya. Kata sandi disimpan di `agent-config.yml` sebagai teks polos dan dihapus setelah Sysprep mengatur kata sandi administrator. EC2Luncurkan mengenkripsi kata sandi menggunakan kunci pengguna.

      1. `Do not set`

         EC2Peluncuran menggunakan kata sandi yang Anda tentukan dalam file unattend.xml. Jika Anda tidak menentukan kata sandi di unattend.xml, akun administrator dinonaktifkan.

   1. **Mulai Layanan SSM**

      Ketika dipilih, layanan Systems Manager diaktifkan untuk mulai mengikuti Sysprep. EC2Launch v2 melakukan semua tugas yang dijelaskan [sebelumnya](ec2launch-v2.md#ec2launch-v2-tasks), dan Agen SSM memproses permintaan untuk kemampuan Systems Manager, seperti Run Command dan State Manager.

      Anda dapat menggunakan Run Command untuk memutakhirkan instans yang ada untuk menggunakan versi terbaru dari layanan EC2 Launch v2 dan Agen SSM. Untuk informasi selengkapnya, lihat [Memperbarui Agen SSM menggunakan Run Command](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command-tutorial-update-software.html) di *Panduan Pengguna AWS Systems Manager*.

   1. **Optimalkan ENA**

      Saat dipilih, pengaturan ENA dikonfigurasi untuk memastikan bahwa pengaturan ENA Receive Side Scaling dan Receive Queue Depth dioptimalkan. AWS Untuk informasi selengkapnya, lihat [Konfigurasikan afinitas CPU penskalaan sisi Terima](enhanced-networking-os.md#windows-rss-cpu-affinity).

   1. **Aktifkan SSH**

      Pengaturan ini memungkinkan OpenSSH untuk versi Windows yang lebih baru untuk memungkinkan administrasi sistem jarak jauh.

   1. **Aktifkan Jumbo Frame**

      Pilih untuk mengaktifkan Jumbo Frames. Jumbo Frames dapat memiliki efek yang tidak diinginkan pada komunikasi jaringan Anda, jadi pastikan Anda memahami bagaimana Jumbo Frames akan memengaruhi sistem Anda sebelum mengaktifkan. Untuk informasi selengkapnya tentang Jumbo Frames, lihat [Frame jumbo (9001 MTU)](network_mtu.md#jumbo_frame_instances).

   1. **Persiapkan untuk Pencitraan**

      Pilih apakah Anda ingin instans EC2 Anda dimatikan dengan atau tanpa Sysprep. Ketika Anda ingin menjalankan Sysprep dengan EC2 Launch v2, pilih **Shutdown** with Sysprep.

1. Pada tab **Sufiks DNS**, Anda dapat memilih apakah Anda ingin menambahkan daftar sufiks DNS untuk resolusi DNS dari server yang berjalan di EC2, tanpa memberikan nama domain yang memenuhi syarat. Sufiks DNS dapat berisi variabel `$REGION` dan `$AZ`. Hanya sufiks yang belum ada yang akan ditambahkan ke daftar.   
![\[Aplikasi pengaturan EC2 Launch.\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/images/ec2launchv2-dns.png)

1. Pada tab **Wallpaper**, Anda dapat mengonfigurasi wallpaper instans Anda dengan gambar latar belakang, dan menentukan detail instans untuk wallpaper yang akan ditampilkan. Amazon EC2 menghasilkan detail setiap kali Anda masuk.

   Anda dapat mengonfigurasi wallpaper Anda dengan kontrol berikut.
   + **Tampilkan detail instans pada wallpaper** — Kotak centang ini mengaktifkan atau menonaktifkan tampilan detail instans pada wallpaper.
   + **Jalur gambar (.jpg)** - Tentukan jalur ke gambar yang akan digunakan sebagai latar belakang wallpaper.
   + **Pilih atribut yang akan ditampilkan di wallpaper** — Pilih kotak centang untuk detail instans yang ingin Anda tampilkan di wallpaper. Hapus kotak centang untuk detail instans yang dipilih sebelumnya yang akan Anda hapus dari wallpaper.
   + **Tampilkan Tanda Instans pada wallpaper** - Pilih salah satu pengaturan berikut untuk menampilkan tanda instans pada wallpaper:
     + **Tidak ada** - Jangan tampilkan tanda instans apa pun di wallpaper.
     + **Tampilkan semua** — Tampilkan semua tanda instans pada wallpaper.
     + **Tampilkan difilter** - Tampilkan tanda instans tertentu pada wallpaper. Saat memilih pengaturan ini, Anda dapat menambahkan tanda instans yang ingin ditampilkan di wallpaper di kotak **filter tanda instans**.
**catatan**  
Anda harus mengaktifkan tanda dalam metadata untuk menampilkan tanda pada wallpaper. Untuk informasi selengkapnya tentang tanda instans dan metadata, lihat [Lihat tag untuk instans EC2 Anda menggunakan metadata instans](work-with-tags-in-IMDS.md).  
![\[Tab Wallpaper pengaturan EC2 Launch.\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/images/ec2launchv2-wallpaper-02.png)

1. Pada tab **Volume**, pilih apakah Anda ingin menginisialisasi volume yang dilampirkan ke instans. Mengaktifkan set huruf drive untuk volume tambahan dan memperluasnya untuk menggunakan ruang yang tersedia. Jika Anda memilih **Semua**, semua volume penyimpanan diinisialisasi. Jika Anda memilih **Perangkat**, hanya perangkat yang ditentukan dalam daftar yang diinisialisasi. Anda harus memasukkan perangkat untuk setiap perangkat yang akan diinisialisasi. Gunakan peranti yang terdaftar pada konsol EC2, sebagai contoh, `xvdb` atau `/dev/nvme0n1`. Daftar dropdown menampilkan volume penyimpanan yang dilampirkan pada instans. Untuk memasukkan perangkat yang tidak terpasang ke instans, masukkan perangkat itu di bidang teks.

   **Nama**, **Huruf**, dan **Partisi** adalah bidang opsional. Jika tidak ada nilai yang ditentukan untuk **Partisi**, volume penyimpanan yang lebih besar dari 2 TB diinisialisasi dengan jenis `gpt` partisi, dan yang lebih kecil dari 2 TB diinisialisasi dengan jenis `mbr` partisi. Jika perangkat dikonfigurasi, dan perangkat non-NTFS berisi tabel partisi, atau 4 KB pertama dari disk berisi data, maka disk akan dilewati dan tindakan dicatat.   
![\[Aplikasi pengaturan EC2 Launch.\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/images/ec2launchv2-volumes.png)

## Konfigurasikan EC2 Launch v2 menggunakan CLI
<a name="ec2launch-v2-cli"></a>

Anda dapat menggunakan Command Line Interface (CLI) untuk mengonfigurasi pengaturan EC2 Peluncuran Anda dan mengelola layanan. Bagian berikut berisi deskripsi dan informasi penggunaan untuk perintah CLI yang dapat Anda gunakan untuk EC2 mengelola Launch v2.

**Topics**
+ [collect-logs](#ec2launch-v2-collect-logs)
+ [get-agent-config](#ec2launch-v2-get-agent-config)
+ [list-volumes](#ec2launch-v2-list-volumes)
+ [atur ulang](#ec2launch-v2-reset)
+ [run](#ec2launch-v2-run)
+ [status](#ec2launch-v2-settings-status)
+ [sysprep](#ec2launch-v2-settings-sysprep)
+ [validasi](#ec2launch-v2-validate)
+ [versi](#ec2launch-v2-version)
+ [wallpaper](#ec2launch-v2-wallpaper)

### collect-logs
<a name="ec2launch-v2-collect-logs"></a>

Mengumpulkan file log untuk EC2 Launch, zip file, dan menempatkannya di direktori tertentu.

**Contoh**

```
ec2launch collect-logs -o C:\Mylogs.zip
```

**Penggunaan**

`ec2launch collect-logs [flags]`

**Bendera**

`-h`, `--help`

bantuan untuk `collect-logs`

`-o`, `--output string`

jalur ke file log output zip

### get-agent-config
<a name="ec2launch-v2-get-agent-config"></a>

Mencetak `agent-config.yml` dalam format yang ditentukan (JSON atau YAML). Jika tidak ada format yang ditentukan, `agent-config.yml` dicetak dalam format yang ditentukan sebelumnya. 

**Contoh**

```
ec2launch get-agent-config -f json
```

**Penggunaan**

`ec2launch get-agent-config [flags]`

**Bendera**

`-h`, `--help`

bantuan untuk `get-agent-config`

`-f`, `--format string`

format output file `agent-config`: `json`, `yaml`

### list-volumes
<a name="ec2launch-v2-list-volumes"></a>

Mencantumkan semua volume penyimpanan yang dilampirkan ke instans, termasuk volume singkat dan EBS.

**Contoh**

```
ec2launch list-volumes
```

**Penggunaan**

`ec2launch list-volumes`

**Bendera**

`-h`, `--help`

bantuan untuk `list-volumes`

### atur ulang
<a name="ec2launch-v2-reset"></a>

Tujuan utama dari tugas ini adalah untuk mengatur ulang agen untuk waktu berikutnya yang dijalankan. Untuk melakukan itu, **reset** perintah menghapus semua data status agen untuk EC2 Launch v2 dari `EC2Launch` direktori lokal (lihat[EC2Luncurkan struktur direktori v2](ec2launch-v2.md#ec2launch-v2-directory)). Reset opsional menghapus layanan dan log Sysprep.

Perilaku skrip tergantung pada mode apa agen menjalankan skrip — inline, atau terpisah.

Inline (default)  
Agen EC2 Launch v2 menjalankan skrip satu per satu (`detach: false`). Ini adalah pengaturan default.  
Ketika skrip inline Anda mengeluarkan perintah **reset** atau **sysprep**, skrip tersebut segera berjalan dan mengatur ulang agen. Tugas saat ini selesai, kemudian agen dimatikan tanpa menjalankan tugas lebih lanjut.  
Misalnya, jika tugas yang mengeluarkan perintah akan diikuti oleh `startSsm` tugas (disertakan secara default setelah data pengguna berjalan), tugas tidak berjalan dan layanan Systems Manager tidak pernah dimulai.

Terlepas  
Agen EC2 Launch v2 menjalankan skrip bersamaan dengan tugas lain ()`detach: true`.  
Saat skrip terpisah Anda mengeluarkan **reset** atau **sysprep**, perintah tersebut menunggu agen selesai sebelum dijalankan. Tugas setelah executeScript masih akan berjalan.

**Contoh**

```
ec2launch reset -c
```

**Penggunaan**

`ec2launch reset [flags]`

**Bendera**

`-c`, `--clean`

membersihkan log instans sebelum `reset`

`-h`, `--help`

bantuan untuk `reset`

### run
<a name="ec2launch-v2-run"></a>

Menjalankan EC2 Peluncuran v2.

**Contoh**

```
ec2launch run
```

**Penggunaan**

`ec2launch run [flags]`

**Bendera**

`-h`, `--help`

bantuan untuk `run`

### status
<a name="ec2launch-v2-settings-status"></a>

Mendapat status agen EC2 Launch v2. Memblokir proses secara opsional sampai agen selesai. Kode keluar proses menentukan status agen:
+ `0` – agen berjalan dan berhasil.
+ `1` – agen berjalan dan gagal.
+ `2` – agen masih berjalan.
+ `3` – agen dalam status yang tidak diketahui. Status agen tidak berjalan atau berhenti.
+ `4` – kesalahan terjadi ketika mencoba untuk mengambil status agen.
+ `5` – agen tidak berjalan dan status berjalan terakhir yang diketahui tidak diketahui. Ini bisa berarti salah satu dari berikut ini:
  + kedua `state.json` dan `previous-state.json` dihapus.
  + `previous-state.json` rusak.

  Ini adalah status agen setelah menjalankan perintah [`reset`](#ec2launch-v2-reset).

**Contoh:**

```
ec2launch status -b
```

**Penggunaan**

`ec2launch status [flags]`

**Bendera**

`-b`,`--block`

memblokir proses sampai agen selesai berjalan

`-h`,`--help`

bantuan untuk `status`

### sysprep
<a name="ec2launch-v2-settings-sysprep"></a>

Tujuan utama dari tugas ini adalah untuk mengatur ulang agen untuk waktu berikutnya yang dijalankan. Untuk melakukan itu, perintah **sysprep** mengatur ulang status agen, memperbarui file `unattend.xml`, menonaktifkan RDP, dan menjalankan Sysprep.

Perilaku skrip tergantung pada mode apa agen menjalankan skrip — inline, atau terpisah.

Inline (default)  
Agen EC2 Launch v2 menjalankan skrip satu per satu (`detach: false`). Ini adalah pengaturan default.  
Ketika skrip inline Anda mengeluarkan perintah **reset** atau **sysprep**, skrip tersebut segera berjalan dan mengatur ulang agen. Tugas saat ini selesai, kemudian agen dimatikan tanpa menjalankan tugas lebih lanjut.  
Misalnya, jika tugas yang mengeluarkan perintah akan diikuti oleh `startSsm` tugas (disertakan secara default setelah data pengguna berjalan), tugas tidak berjalan dan layanan Systems Manager tidak pernah dimulai.

Terlepas  
Agen EC2 Launch v2 menjalankan skrip bersamaan dengan tugas lain ()`detach: true`.  
Saat skrip terpisah Anda mengeluarkan **reset** atau **sysprep**, perintah tersebut menunggu agen selesai sebelum dijalankan. Tugas setelah executeScript masih akan berjalan.

**Contoh:**

```
ec2launch sysprep
```

**Penggunaan**

`ec2launch sysprep [flags]`

**Bendera**

`-c`,`--clean`

membersihkan log instans sebelum `sysprep`

`-h`,`--help`

bantuan untuk Sysprep

`-s`,`--shutdown`

mematikan instans setelah `sysprep`

### validasi
<a name="ec2launch-v2-validate"></a>

Memvalidasi `agent-config` file `C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml`.

**Contoh**

```
ec2launch validate
```

**Penggunaan**

`ec2launch validate [flags]`

**Bendera**

-h` `, `--help`

bantuan untuk `validate`

### versi
<a name="ec2launch-v2-version"></a>

Mendapatkan versi yang dapat dieksekusi.

**Contoh**

```
ec2launch version
```

**Penggunaan**

`ec2launch version [flags]`

**Bendera**

`-h`, `--help`

bantuan untuk `version`

### wallpaper
<a name="ec2launch-v2-wallpaper"></a>

Menyetel wallpaper baru ke jalur wallpaper yang disediakan (file.jpg), dan menampilkan detail instans yang dipilih.

#### Sintaksis
<a name="lv2-wallpaper-syntax"></a>

```
ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,ipv6Address,instanceSize,availabilityZone,architecture
```

#### Masukan
<a name="lv2-wallpaper-inputs"></a>Parameter

**--allowed-tag [,] *tag-name-1* *tag-name-n***  
(Opsional) Base64 mengenkode array JSON dari nama tanda instans untuk ditampilkan di wallpaper. Anda dapat menggunakan tanda ini atau `--all-tags`, tetapi tidak keduanya.

**--atribut*attribute-string-1*, *attribute-string-n***  
(Opsional) Daftar string atribut `wallpaper` yang dipisahkan dengan koma untuk menerapkan pengaturan ke wallpaper.

**[--jalur \$1 -p] *path-string***  
(Wajib) Menentukan jalur file gambar latar belakang `wallpaper`.Bendera

**--all-tags**  
(Opsional) Menampilkan semua tanda instans pada wallpaper. Anda dapat menggunakan tanda ini atau `--allowed-tags`, tetapi tidak keduanya.

**[--help \$1 -h]**  
Menampilkan bantuan untuk perintah **wallpaper**.

## EC2Luncurkan konfigurasi tugas v2
<a name="ec2launch-v2-task-configuration"></a>

Bagian ini mencakup skema, tugas, detail, dan contoh konfigurasi untuk `agent-config.yml` dan data pengguna.

**Topics**
+ [Skema: `agent-config.yml`](#ec2launch-v2-schema-agent-config)
+ [Konfigurasikan skrip data pengguna EC2 Luncurkan v2 yang berjalan selama peluncuran atau reboot](#ec2launch-v2-schema-user-data)

### Skema: `agent-config.yml`
<a name="ec2launch-v2-schema-agent-config"></a>

Struktur `agent-config.yml` file ditunjukkan di bawah ini. Perhatikan bahwa tugas tidak dapat diulang dalam tahap yang sama. Untuk properti tugas, lihat deskripsi tugas yang mengikuti.

#### Struktur dokumen: agent-config.yml
<a name="ec2launch-v2-schema-agent-config-doc-structure"></a>

**JSON**

```
{
	"version": "1.1",
	"config": [
		{
			"stage": "string",
			"tasks": [
				{
					"task": "string",
					"inputs": {
						...
					}
				},
				...
			]
		},
		...
	]
}
```

**YAML**

```
version: 1.1
config:
- stage: string
  tasks:
  - task: string
	inputs:
	  ...
  ...
...
```

#### Contoh: `agent-config.yml`
<a name="ec2launch-v2-example-agent-config"></a>

Contoh berikut menunjukkan pengaturan untuk file konfigurasi `agent-config.yml`.

```
version: 1.1
config:
- stage: boot
  tasks:
  - task: extendRootPartition
- stage: preReady
  tasks:
  - task: activateWindows
    inputs:
      activation:
        type: amazon
  - task: setDnsSuffix
    inputs:
      suffixes:
      - $REGION.ec2-utilities.amazonaws.com
  - task: setAdminAccount
    inputs:
      password:
        type: random
  - task: setWallpaper
    inputs:
      path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
      attributes:
      - hostName
      - instanceId
      - privateIpAddress
      - publicIpAddress
      - instanceSize
      - availabilityZone
      - architecture
- stage: postReady
  tasks:
  - task: startSsm
```

### Konfigurasikan skrip data pengguna EC2 Luncurkan v2 yang berjalan selama peluncuran atau reboot
<a name="ec2launch-v2-schema-user-data"></a>

Contoh JSON dan YAMG berikut menunjukkan struktur dokumen untuk data pengguna. Amazon EC2 mengurai setiap tugas yang dinamai dalam array `tasks` yang Anda tentukan dalam dokumen. Setiap tugas memiliki set properti dan persyaratan sendiri. Untuk detailnya, lihat [Definisi tugas untuk tugas startup EC2 Launch v2](ec2launch-v2-task-definitions.md).

**catatan**  
Tugas hanya boleh muncul sekali dalam array tugas data pengguna.

#### Struktur dokumen: data pengguna
<a name="ec2launch-v2-schema-user-data-doc-structure"></a>

**JSON**

```
{
	"version": "1.1",
	"tasks": [
		{
			"task": "string",
			"inputs": {
				...
			},
		},
		...
	]
}
```

**YAML**

```
version: 1.1
tasks:
- task: string
  inputs:
    ...
...
```

#### Contoh: data pengguna
<a name="ec2launch-v2-example-user-data"></a>

Untuk informasi selengkapnya tentang data pengguna, lihat [Bagaimana Amazon EC2 menangani data pengguna untuk instans Windows](user-data.md#ec2-windows-user-data).

Contoh dokumen YAMB berikut menunjukkan PowerShell skrip yang EC2 Launch v2 berjalan sebagai data pengguna untuk membuat file.

```
version: 1.1
tasks:
- task: executeScript
  inputs:
  - frequency: always
    type: powershell
    runAs: localSystem
    content: |-
      New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
```

Anda dapat menggunakan format XMLuntuk data pengguna yang kompatibel dengan versi agen peluncuran sebelumnya. EC2Launch v2 menjalankan skrip sebagai `executeScript` tugas di `UserData` panggung. Agar sesuai dengan perilaku EC2 Launch v1 dan EC2 Config, skrip data pengguna berjalan sebagai attached/inline proses secara default.

Anda dapat menambahkan tanda opsional untuk menyesuaikan cara skrip Anda berjalan. Misalnya, untuk menjalankan skrip data pengguna saat instans di-boot ulang selain satu kali saat instans diluncurkan, Anda dapat menggunakan tanda berikut:

`<persist>true</persist>`

**Contoh:**

```
<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<persist>true</persist>
```

Anda dapat menentukan satu atau lebih PowerShell argumen dengan `<powershellArguments>` tag. Jika tidak ada argumen yang diteruskan, EC2 Launch v2 menambahkan argumen berikut secara default:`-ExecutionPolicy Unrestricted`.

**Contoh:**

```
<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<powershellArguments>-ExecutionPolicy Unrestricted -NoProfile -NonInteractive</powershellArguments>
```

Untuk menjalankan skrip data pengguna XML sebagai proses yang terpisah, tambahkan tanda berikut ke data pengguna Anda.

`<detach>true</detach>`

**Contoh:**

```
<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<detach>true</detach>
```

**catatan**  
Tanda lepas tidak didukung pada agen peluncuran sebelumnya.

#### Log perubahan: data pengguna
<a name="ec2launch-v2-versions-user-data"></a>

Tabel berikut mencantumkan perubahan untuk data pengguna, dan referensi silang ke versi agen EC2 Launch v2 yang berlaku.


| Versi data pengguna | Detail | Diperkenalkan di | 
| --- | --- | --- | 
| 1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Luncurkan v2 versi 2.0.1245 | 
| 1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Luncurkan v2 versi 2.0.0 | 

\$1 Bila digunakan dengan file `agent-config.yml` default.

## EC2Luncurkan kode keluar v2 dan reboot
<a name="ec2launch-v2-exit-codes-reboots"></a>

Anda dapat menggunakan EC2 Launch v2 untuk menentukan bagaimana kode keluar ditangani oleh skrip Anda. Secara default, kode keluar dari perintah terakhir yang dijalankan dalam skrip dilaporkan sebagai kode keluar untuk seluruh skrip. Sebagai contoh, jika skrip mencakup tiga perintah dan perintah pertama gagal tetapi perintah yang berikutnya berhasil, maka status berjalan dilaporkan sebagai `success` karena perintah akhir berhasil.

Jika Anda ingin skrip untuk me-reboot sebuah instance, maka Anda harus menentukan `exit 3010` dalam skrip Anda, bahkan ketika reboot adalah langkah terakhir dalam skrip Anda. `exit 3010`menginstruksikan EC2 Launch v2 untuk me-reboot instance dan memanggil skrip lagi sampai mengembalikan kode keluar yang tidak`3010`, atau sampai jumlah reboot maksimum tercapai. EC2Luncurkan v2 memungkinkan maksimal 5 reboot per tugas. Jika Anda mencoba untuk me-reboot instans dari skrip dengan menggunakan mekanisme yang berbeda, seperti, `Restart-Computer`maka status berjalan skrip akan menjadi tidak konsisten. Sebagai contoh, skrip mungkin terjebak dalam loop mulai ulang atau tidak melakukan restart.

Jika Anda menggunakan format data pengguna XMLyang kompatibel dengan agen sebelumnya, maka data pengguna dapat berjalan lebih banyak daripada yang Anda inginkan. Untuk informasi selengkapnya, lihat [Layanan menjalankan data pengguna lebih dari satu kali](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-user-data-more-than-once) di bagian Pemecahan Masalah.

## EC2Luncurkan v2 dan Sysprep
<a name="ec2launch-v2-sysprep"></a>

Layanan EC2 Launch v2 menjalankan Sysprep, alat Microsoft yang memungkinkan Anda membuat AMI Windows yang disesuaikan yang dapat digunakan kembali. Ketika EC2 Launch v2 memanggil Sysprep, ia menggunakan file `%ProgramData%\Amazon\EC2Launch` untuk menentukan operasi mana yang harus dilakukan. Anda dapat mengedit file-file ini secara tidak langsung menggunakan kotak dialog **EC2Launch settings**, atau langsung menggunakan editor YAMM atau editor teks. Namun, ada beberapa pengaturan lanjutan yang tidak tersedia di kotak dialog **Pengaturan EC2 peluncuran**, jadi Anda harus mengedit entri tersebut secara langsung.

Jika Anda membuat AMI dari sebuah instans setelah memperbarui pengaturannya, pengaturan baru tersebut diterapkan ke setiap instans yang diluncurkan dari AMI baru. Untuk informasi tentang membuat grafik, lihat [Buat AMI yang didukung Amazon EBS-Backed](creating-an-ami-ebs.md).