

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

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

Bagian ini berisi informasi tentang cara mengonfigurasi pengaturan untuk EC2Launch v2.

**Topics**
+ [Ubah pengaturan menggunakan kotak dialog pengaturan EC2Launch v2](#ec2launch-v2-ui)
+ [Konfigurasikan EC2Launch v2 menggunakan CLI](#ec2launch-v2-cli)
+ [Konfigurasi EC2Launch v2](#ec2launch-v2-task-configuration)
+ [Kode keluar dan boot ulang EC2Launch v2](#ec2launch-v2-exit-codes-reboots)
+ [EC2Launch v2 dan Sysprep](#ec2launch-v2-sysprep)

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

Prosedur berikut menjelaskan cara menggunakan kotak dialog pengaturan EC2Launch v2 untuk mengaktifkan atau menonaktifkan pengaturan.
**catatan**  
Jika Anda mengonfigurasi tugas kustom secara tidak benar di file agent-config.yml. dan Anda mencoba membuka kotak dialog pengaturan Amazon EC2Launch, 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 **Semua Program**, lalu navigasikan ke **pengaturan EC2Launch**. 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 EC2Launch**, 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, maka akan dihasilkan menggunakan alamat IPv4 privat dengan format 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`

         EC2Launch menghasilkan dan mengenkripsikan kata sandi 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`

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

      1. `Do not set`

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

   1. **Mulai Layanan SSM**

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

      Anda dapat menggunakan Run Command untuk memutakhirkan instans yang ada untuk mengunakan pada layanan EC2Launch v2 dan SSM Agent versi terbaru. 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. Saat Anda ingin menjalankan Sysprep dengan EC2Launch v2, pilih **Matikan dengan 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 EC2Launch v2 menggunakan CLI
<a name="ec2launch-v2-cli"></a>

Anda dapat menggunakan Command Line Interface (CLI) untuk mengonfigurasi pengaturan EC2Launch Anda dan mengelola layanan. Bagian berikut ini berisi deskripsi dan informasi penggunaan untuk perintah CLI yang dapat Anda gunakan untuk mengelola EC2Launch 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 EC2Launch, men-zip file, dan menempatkannya di direktori yang ditentukan.

**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, perintah **reset** menghapus semua data status agen untuk EC2launch v2 dari direktori `EC2Launch` lokal (lihat [Struktur direktori EC2Launch 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 EC2Launch 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 EC2launch 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>

Jalankan EC2Launch v2.

**Contoh**

```
ec2launch run
```

**Penggunaan**

`ec2launch run [flags]`

**Bendera**

`-h`, `--help`

bantuan untuk `run`

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

Dapatkan status agen EC2Launch 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 EC2Launch 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 EC2launch 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 \| -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 \| -h]**  
Menampilkan bantuan untuk perintah **wallpaper**.

## Konfigurasi EC2Launch 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 EC2launch 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 EC2launch 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 EC2launch 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 XML untuk data pengguna yang kompatibel dengan versi agen peluncuran sebelumnya. EC2Launch v2 menjalankan skrip sebagai tugas `executeScript` di tahap `UserData`. Agar sesuai dengan perilaku EC2launch v1 dan EC2config, skrip data pengguna berjalan sebagai proses secara default. attached/inline 

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, EC2launch 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 EC2launch 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) | EC2Launch 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) | EC2Launch v2 versi 2.0.0 | 

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

## Kode keluar dan boot ulang EC2Launch v2
<a name="ec2launch-v2-exit-codes-reboots"></a>

Anda dapat menggunakan EC2Launch 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 me-reboot sebuah instans, maka Anda harus menentukan `exit 3010` dalam skrip Anda, bahkan saat reboot menjadi langkah terakhir dalam skrip Anda. `exit 3010` menginstruksikan EC2Launch v2 untuk me-reboot instans dan memanggil skrip lagi sampai mengembalikan kode keluar yang tidak, `3010`atau sehingga jumlah reboot maksimum telah dicapai. EC2Launch v2 memungkinkan maksimal 5 boot ulang 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.

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

Layanan EC2Launch v2 menjalankan Sysprep, alat Microsoft yang memungkinkan Anda untuk membuat AMI Windows kustom yang dapat digunakan kembali. Saat EC2Launch v2 memanggil Sysprep, file digunakan di `%ProgramData%\Amazon\EC2Launch` untuk menentukan operasi mana yang akan dilakukan. Anda dapat mengedit file ini secara tidak langsung menggunakan kotak dialog **pengaturan EC2Launch**, atau langsung menggunakan editor YAML atau editor teks. Namun, ada beberapa pengaturan lanjutan yang tidak tersedia di kotak dialog **pengaturan EC2Launch**, 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).