Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan agen EC2launch v2 untuk melakukan tugas selama peluncuran instans Windows EC2
Semua instans Amazon EC2 yang didukung yang diluncurkan AWS dari Windows Server 2022 dan Windows Server AMIs 2025 menyertakan EC2 agen peluncuran Launch v2 `EC2Launch.exe` () secara default. Kami juga menyediakan Windows Server 2016 dan 2019 AMIs dengan EC2 Launch v2 diinstal sebagai agen peluncuran default. Ini AMIs disediakan selain Windows Server 2016 dan 2019 AMIs yang mencakup EC2 Launch v1. Anda dapat mencari Windows AMIs yang menyertakan EC2 Launch v2 secara default dengan memasukkan awalan berikut dalam pencarian Anda dari **AMIs**halaman di konsol Amazon EC2:. `EC2LaunchV2-Windows_Server-*`
Untuk membandingkan fitur versi agen peluncuran, lihat[Bandingkan agen EC2 peluncuran Amazon](configure-launch-agents.md#ec2launch-agent-compare).
EC2Launch v2 melakukan tugas selama startup instance dan berjalan jika instance dihentikan dan kemudian dimulai, atau dimulai ulang. EC2Launch v2 juga dapat melakukan tugas sesuai permintaan. Beberapa dari tugas ini diaktifkan secara otomatis, sementara yang lainnya harus diaktifkan secara manual. Layanan EC2 Launch v2 mendukung semua fitur EC2 Config dan EC2 Launch.
Layanan ini menggunakan file konfigurasi untuk mengontrol operasinya. Anda dapat memperbarui file konfigurasi dengan menggunakan alat grafis atau dengan mengeditnya secara langsung sebagai file .yml tunggal (`agent-config.yml`). Untuk informasi selengkapnya tentang lokasi file, lihat[EC2Luncurkan struktur direktori v2](#ec2launch-v2-directory).
EC2Launch v2 menerbitkan log peristiwa Windows untuk membantu Anda memecahkan masalah kesalahan dan mengatur pemicu. Untuk informasi selengkapnya, lihat [Log peristiwa Windows](ec2launchv2-troubleshooting.md#ec2launchv2-windows-event-logs).
**Versi OS yang didukung**
Agen EC2 Launch v2 mendukung versi sistem operasi (OS) Windows Server berikut:
+ Windows Server 2025
+ Windows Server 2022
+ Windows Server 2019 (Saluran Layanan Jangka Panjang dan Saluran Semi-Tahunan)
+ Windows Server 2016
**Tugas yang dijalankan secara default**
Agen EC2 Launch v2 menjalankan tugas-tugas berikut hanya satu kali secara default selama peluncuran instance awal. Tugas diatur sesuai dengan urutan di mana mereka berjalan dalam tahap peluncuran mereka.
`Boot`panggung
+ extendRootPartition
`PreReady`panggung
+ activateWindows
+ setDnsSuffix
+ setAdminAccount
+ setWallpaper
`PostReady`panggung
+ startSsm
## EC2Luncurkan konsep v2
Konsep-konsep berikut berguna untuk dipahami saat mempertimbangkan EC2 Peluncuran v2.
**agen-konfigurasi**
`agent-config`adalah file yang terletak di folder konfigurasi untuk EC2 Launch v2. Ini termasuk konfigurasi untuk boot, jaringanPreReady, dan PostReady tahapan. File ini digunakan untuk menentukan konfigurasi instans untuk tugas-tugas yang harus dijalankan saat AMI di-boot untuk pertama kali atau untuk waktu-waktu berikutnya.
Secara default, instalasi EC2 Launch v2 menginstal `agent-config` file yang menyertakan konfigurasi yang direkomendasikan yang digunakan di Amazon Windows standar. AMIs Anda dapat memperbarui file konfigurasi untuk mengubah pengalaman boot default untuk AMI Anda yang ditentukan oleh EC2 Launch v2. Untuk informasi selengkapnya tentang lokasi file, lihat[EC2Luncurkan struktur direktori v2](#ec2launch-v2-directory).
**Frekuensi**
Frekuensi tugas menentukan kapan tugas harus dijalankan, tergantung pada konteks boot. Sebagian besar tugas hanya memiliki satu frekuensi yang diizinkan. Anda dapat menentukan frekuensi untuk tugas `executeScript`.
Anda akan melihat frekuensi berikut di [EC2Luncurkan konfigurasi tugas v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Once - Tugas dijalankan sekali, saat AMI telah boot untuk pertama kali (selesai Sysprep).
+ Selalu — Tugas berjalan setiap kali agen peluncuran berjalan. Agen peluncuran berjalan saat:
+ sebuah instans dimulai atau dimulai ulang
+ Layanan EC2 Peluncuran berjalan
+ `EC2Launch.exe run` diinvokasi
**Panggung**
Tahap adalah pengelompokan tugas logis yang dijalankan agen EC2 Launch v2. Beberapa tugas hanya dapat dijalankan dalam tahap tertentu. Yang lain dapat berjalan dalam beberapa tahap. Saat menggunakan `agent-config.yml`, Anda harus menentukan daftar tahapan, dan daftar tugas untuk dijalankan dalam setiap tahap.
Layanan berjalan tahapan dalam urutan sebagai berikut:
Tahap 1: Boot
Tahap 2: Jaringan
Tahap 3: PreReady
Windows sudah siap
Setelah PreReady tahap selesai, layanan mengirimkan `Windows is ready` pesan ke konsol Amazon EC2.
Tahap 4: PostReady
Data pengguna berjalan selama *PostReady*tahap. Beberapa versi skrip berjalan sebelum *PostReady*tahap `agent-config.yml` file, dan beberapa berjalan setelahnya, sebagai berikut:
Sebelum `agent-config.yml`
+ Data pengguna YAML versi 1.1
+ Data pengguna XML
Setelah `agent-config.yml`
+ Data pengguna YAMB versi 1.0 (versi warisan untuk kompatibilitas mundur)
Untuk contoh tahapan dan tugas, lihat [Contoh: `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config).
Saat Anda menggunakan data pengguna, Anda harus menentukan daftar tugas agar agen peluncuran dijalankan. Panggung tersirat. Untuk contoh tugas, lihat [Contoh: data pengguna](ec2launch-v2-settings.md#ec2launch-v2-example-user-data).
EC2Launch v2 menjalankan daftar tugas dalam urutan yang Anda tentukan dalam `agent-config.yml` dan dalam data pengguna. Tahapan berjalan secara berurutan. Tahap selanjutnya dimulai setelah tahap sebelumnya selesai. Tugas juga berjalan secara berurutan.
**Tugas**
Anda dapat menginvokasi tugas untuk melakukan tindakan pada sebuah instans. Anda dapat mengonfigurasi tugas dalam file `agent-config.yml` atau melalui data pengguna. Untuk daftar tugas yang tersedia untuk EC2 Luncurkan v2, lihat [EC2Meluncurkan tugas v2](#ec2launch-v2-tasks). Untuk skema konfigurasi tugas dan detailnya, lihat [EC2Luncurkan konfigurasi tugas v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
**Data pengguna**
Data pengguna adalah data yang dapat dikonfigurasi saat Anda meluncurkan sebuah instans. Anda dapat memperbarui data pengguna untuk secara dinamis mengubah cara kustom AMIs atau quickstart AMIs dikonfigurasi. EC2Launch v2 mendukung panjang input data pengguna 60 kB. Data pengguna hanya mencakup UserData tahap, dan karena itu berjalan setelah `agent-config` file. Anda dapat memasukkan data pengguna ketika Anda meluncurkan sebuah instans menggunakan wizard peluncuran instans, atau Anda dapat memodifikasi data pengguna dari konsol EC2. Untuk informasi lebih lanjut tentang bekerja dengan data pengguna, lihat [Bagaimana Amazon EC2 menangani data pengguna untuk instans Windows](user-data.md#ec2-windows-user-data).
## EC2Luncurkan ikhtisar tugas v2
EC2Launch v2 dapat melakukan tugas-tugas berikut di setiap boot:
+ Siapkan wallpaper baru dan yang disesuaikan secara opsional yang menyajikan informasi tentang instans.
+ Setel atribut untuk akun administrator yang dibuat di mesin lokal.
+ Tambahkan sufiks DNS ke daftar sufiks pencarian. Hanya sufiks yang belum ada yang ditambahkan ke daftar.
+ Atur huruf drive untuk volume tambahan dan perluas untuk menggunakan ruang yang tersedia.
+ Tulis file dari konfigurasi ke disk.
+ Jalankan skrip yang ditentukan dalam file konfigurasi EC2 Launch v2 atau dari. `user-data` Skrip dari `user-data` dapat berupa teks biasa atau zip dan disediakan sebagai format base64.
+ Jalankan program dengan argumen yang diberikan.
+ Tetapkan nama komputer.
+ Kirim informasi instans ke konsol Amazon EC2.
+ Kirim sidik jari sertifikat RDP ke konsol Amazon EC2.
+ Secara dinamis, perluas partisi sistem operasi untuk menyertakan ruang yang tidak dipartisi.
+ Jalankan data pengguna. Untuk informasi selengkapnya tentang menentukan data pengguna, lihat [EC2Luncurkan konfigurasi tugas v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Setel rute statis non-persisten untuk menjangkau layanan metadata dan server. AWS KMS
+ Setel partisi non-boot ke `mbr` atau. `gpt`
+ Mulai layanan Systems Manager setelah Sysprep.
+ Optimalkan pengaturan ENA.
+ Aktifkan OpenSSH untuk versi Windows yang lebih baru.
+ Aktifkan Jumbo Frame.
+ Setel Sysprep untuk dijalankan dengan EC2 Launch v2.
+ Publikasikan log peristiwa Windows.
## EC2Luncurkan struktur direktori v2
EC2Peluncuran v2 harus diinstal di direktori berikut:
+ Biner layana: `%ProgramFiles%\Amazon\EC2Launch`
+ Data layanan (pengaturan, file log, dan file statu): `%ProgramData%\Amazon\EC2Launch`
**catatan**
Secara default, Windows menyembunyikan file dan folder dalam `C:\ProgramData`. Untuk melihat direktori dan file EC2 Launch v2, Anda harus memasukkan jalur di Windows Explorer atau mengubah properti folder untuk menampilkan file dan folder tersembunyi.
Direktori `%ProgramFiles%\Amazon\EC2Launch` berisi binari dan pustaka pendukung. Ini mencakup subdirektori berikut:
+ `settings`
+ `EC2LaunchSettingsUI.exe`— antarmuka pengguna untuk memodifikasi file `agent-config.yml`
+ `YamlDotNet.dll`— DLL untuk mendukung beberapa operasi di antarmuka pengguna
+ `tools`
+ `ebsnvme-id.exe`— alat untuk memeriksa metadata volume EBS pada instance
+ `AWSAcpiSpcrReader.exe`— alat untuk menentukan port COM yang benar untuk digunakan
+ `EC2LaunchEventMessage.dll`- DLL untuk mendukung pencatatan peristiwa Windows untuk EC2 Peluncuran
+ `service`
+ `EC2LaunchService.exe`— Layanan Windows yang dapat dieksekusi yang diluncurkan ketika agen peluncuran berjalan sebagai layanan
+ `EC2AgentTelemetry.dll`- DLL untuk mendukung telemetri agen EC2
+ `EC2Launch.exe`— EC2 Peluncuran utama yang dapat dieksekusi
+ `EC2LaunchAgentAttribution.txt`— atribusi untuk kode yang digunakan dalam Peluncuran EC2
Direktori `%ProgramData%\Amazon\EC2Launch` berisi subdirektori berikut. Semua data yang dihasilkan oleh layanan, termasuk log, konfigurasi, dan status, disimpan di direktori ini.
+ `config`— Konfigurasi
File konfigurasi layanan disimpan dalam direktori ini sebagai `agent-config.yml`. File ini dapat diperbarui untuk mengubah, menambah, atau menghapus tugas default yang dijalankan oleh layanan. Izin untuk membuat file di direktori ini dibatasi untuk akun administrator untuk mencegah eskalasi hak istimewa.
+ `log`— Log contoh
Log untuk service (`agent.log`), performance (`bench.log`), dan telemetry (`telemetry.log`) disimpan di direktori ini. Ketika `agent.log` mencapai ukuran 1 MB, itu secara otomatis diputar dan file cadangan dibuat dengan format stempel waktu (misalnya,). `agent-2026-03-02T18-56-39.188.log` Hanya satu file log cadangan yang dipertahankan pada satu waktu.
+ `state`— Data status layanan
Status yang digunakan layanan untuk menentukan tugas mana yang harus dijalankan disimpan di sini. Ada sebuah file `.run-once` yang menunjukkan apakah layanan telah dijalankan setelah Sysprep (jadi tugas dengan frekuensi sekali akan dilewati pada proses berikutnya). Subdirektori ini mencakup `state.json` dan `previous-state.json` untuk melacak status setiap tugas.
+ `sysprep`— Sysprep
Direktori ini berisi file yang digunakan untuk menentukan operasi mana yang akan dilakukan oleh Sysprep saat membuat AMI Windows kustom yang dapat digunakan kembali.
+ `wallpaper`— Wallpaper
Gambar wallpaper ini disimpan di direktori ini.
## Telemetri
Telemetri adalah informasi tambahan yang membantu AWS untuk lebih memahami kebutuhan Anda, mendiagnosis masalah, dan memberikan fitur untuk meningkatkan pengalaman Anda. Layanan AWS
EC2Luncurkan versi v2 `2.1.592` dan kemudian kumpulkan telemetri, seperti metrik penggunaan dan kesalahan. Data ini dikumpulkan dari instans Amazon EC2 tempat EC2 Launch v2 berjalan. Ini termasuk semua Windows yang AMIs dimiliki oleh AWS.
Jenis telemetri berikut dikumpulkan oleh EC2 Launch v2:
+ **Informasi penggunaan** — perintah agen, metode penginstalan, dan frekuensi eksekusi terjadwal.
+ **Kesalahan dan informasi diagnostik** - kode kesalahan instalasi agen, jalankan kode kesalahan, dan tumpukan panggilan kesalahan.
Contoh data yang dikumpulkan dari versi 2.0.592 hingga 2.1.1:
```
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentCommandErrorCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentErrorLocation=addroutes.go:49
```
Dimulai dengan versi 2.2.63, data telemetri Agen EC2 diformat sebagai objek JSON:
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
Telemetri tidak diaktifkan secara default. Anda dapat menonaktifkan kumpulan telemetri kapan saja.
**Menonaktifkan telemetri pada sebuah instans**
Untuk menonaktifkan telemetri untuk satu instans, Anda dapat mengatur variabel lingkungan sistem, atau menggunakan MSI untuk memodifikasi instalasi.
Untuk menonaktifkan telemetri dengan menyetel variabel lingkungan sistem, jalankan perintah berikut sebagai administrator.
```
setx /M EC2LAUNCH_TELEMETRY 0
```
Untuk menonaktifkan telemetri menggunakan MSI, jalankan perintah berikut setelah Anda [mengunduh](ec2launch-v2-install.md) MSI.
```
msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
```
**Topics**
+ [EC2Luncurkan konsep v2](#ec2launch-v2-concepts)
+ [EC2Luncurkan ikhtisar tugas v2](#ec2launch-v2-tasks)
+ [EC2Luncurkan struktur direktori v2](#ec2launch-v2-directory)
+ [Telemetri](#ec2launch-v2-telemetry)
+ [Instal versi terbaru EC2 Launch v2](ec2launch-v2-install.md)
+ [Konfigurasikan pengaturan EC2 Launch v2 untuk instance Windows](ec2launch-v2-settings.md)
+ [Definisi tugas untuk tugas startup EC2 Launch v2](ec2launch-v2-task-definitions.md)
+ [Memecahkan masalah dengan agen EC2 Launch v2](ec2launchv2-troubleshooting.md)
+ [EC2Luncurkan riwayat versi v2](ec2launchv2-versions.md)
# Instal versi terbaru EC2 Launch v2
Anda dapat menggunakan salah satu metode berikut untuk menginstal agen EC2Launch v2 pada instans EC2 Anda:
+ Unduh agen dari Amazon S3 dan instal dengan Windows. PowerShell Untuk mengunduh URLs, lihat[EC2Luncurkan unduhan v2 di Amazon S3](#lv2-download-s3).
+ Instal dengan Distributor SSM.
+ Instal dari komponen EC2 Image Builder saat Anda membuat gambar kustom.
+ Luncurkan instans Anda dari AMI yang telah diinstal sebelumnya EC2 Launch v2.
**Awas**
AmazonEC2Launch.msi menghapus versi sebelumnya dari layanan peluncuran EC2, seperti EC2 Launch (v1) dan Config. EC2
Untuk langkah penginstalan, pilih tab yang cocok dengan metode pilihan Anda.
------
#### [ PowerShell ]
Untuk menginstal versi terbaru dari agen EC2 Launch v2 dengan Windows PowerShell, ikuti langkah-langkah ini.
1. Buat direktori lokal Anda.
```
New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
```
1. Tetapkan URL untuk lokasi unduhan Anda. Jalankan perintah berikut dengan URL Amazon S3 yang akan Anda gunakan. Untuk mengunduh URLs, lihat [EC2Luncurkan unduhan v2 di Amazon S3](#lv2-download-s3)
```
$Url = "Amazon S3 URL/AmazonEC2Launch.msi"
```
1. Gunakan perintah majemuk berikut untuk mengunduh agen dan menjalankan penginstalan
```
$DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
msiexec /i "$DownloadFile"
```
**catatan**
Jika Anda menerima kesalahan saat mengunduh file, dan Anda menggunakan Windows Server 2016 atau sebelumnya, TLS 1.2 mungkin perlu diaktifkan untuk PowerShell terminal Anda. Anda dapat mengaktifkan TLS 1.2 untuk PowerShell sesi saat ini dengan perintah berikut dan kemudian coba lagi:
```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
```
1. **msiexec**Perintah menginstal EC2 Launch v2 di lokasi berikut pada instance Windows Server:. `%ProgramFiles%\Amazon\EC2Launch` Untuk memverifikasi bahwa instalasi berjalan, Anda dapat memeriksa sistem file lokal pada instance Anda.
------
#### [ AWS Systems Manager Distributor ]
Untuk mengonfigurasi pembaruan otomatis untuk EC2 Launch v2 dengan AWS Systems Manager Quick Setup, lihat[Instal dan perbarui secara otomatis dengan Pengaturan Cepat Distributor](#lv2-distributor-quick-setup).
Anda juga dapat melakukan instalasi satu kali `AWSEC2Launch-Agent` paket dari AWS Systems Manager Distributor. Untuk instruksi tentang cara menginstal paket dari Systems Manager Distributor, lihat [Menginstal atau memperbarui paket](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) di *Panduan Pengguna AWS Systems Manager *.
------
#### [ EC2 Image Builder component ]
Anda dapat menginstal komponen `ec2launch-v2-windows` saat membuat gambar kustom dengan EC2 Image Builder. Untuk petunjuk tentang cara membuat gambar kustom dengan EC2 Image Builder, lihat [Buat pipeline gambar menggunakan wizard konsol EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) di *Panduan Pengguna EC2 Image Builder*.
------
#### [ AMI ]
EC2Launch v2 sudah diinstal sebelumnya secara default AMIs untuk sistem operasi Windows Server 2022 dan di atasnya:
+ Windows\$1Server- -Bahasa Inggris-Basis Penuh *version*
+ Windows\$1Server- -Bahasa Inggris-Core-Base *version*
+ Windows\$1Server- -Bahasa Inggris-Core-EKS\$1Optimized *version*
+ Windows Server *version* AMIs dengan semua bahasa lainnya
+ Windows Server *version* AMIs dengan SQL diinstal
EC2Launch v2 sudah diinstal sebelumnya di AMI Windows Server berikut. Anda dapat menemukan AMI ini dari konsol Amazon EC2, atau dengan menggunakan prefiks pencarian berikut: `EC2LaunchV2-` di AWS CLI.
+ EC2LaunchV2-Windows\$1Server-2019-Inggris-core-base
+ EC2LaunchV2-Windows\$1Server-2019-Inggris-basis penuh
+ EC2LaunchV2-Windows\$1Server-2016-Inggris-core-base
+ EC2LaunchV2-Windows\$1Server-2016-Bahasa Inggris-basis penuh
------
## Secara otomatis menginstal dan memperbarui EC2 Launch v2 dengan AWS Systems Manager Distributor Quick Setup
Dengan Pengaturan Cepat AWS Systems Manager Distributor, Anda dapat mengatur pembaruan otomatis untuk EC2 Launch v2. Proses berikut menyiapkan Systems Manager Association pada instans Anda yang secara otomatis memperbarui agen EC2 Launch v2 pada frekuensi yang Anda tentukan. Asosiasi yang dibuat oleh Penyiapan Cepat Distributor dapat menyertakan instance dalam Wilayah Akun AWS dan, atau instans dalam Organisasi. AWS Untuk informasi selengkapnya tentang menyiapkan organisasi, lihat [Tutorial: Membuat dan mengonfigurasi organisasi](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html) di *Panduan AWS Organizations Pengguna*.
Sebelum Anda mulai, pastikan bahwa contoh Anda memenuhi semua prasyarat.
### Prasyarat
Untuk mengatur pembaruan otomatis dengan Penyiapan Cepat Distributor, instans Anda harus memenuhi prasyarat berikut.
+ Anda memiliki setidaknya satu instance berjalan yang mendukung EC2 Launch v2. Lihat sistem operasi yang didukung untuk[EC2Luncurkan v2](ec2launch-v2.md).
+ Anda telah melakukan tugas penyiapan Systems Manager pada instans Anda. Untuk informasi selengkapnya, lihat [Menyiapkan Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html) di *Panduan AWS Systems Manager Pengguna*.
+ EC2Launch v2 harus menjadi satu-satunya agen peluncuran yang diinstal pada instans Anda. Jika Anda memiliki lebih dari satu agen peluncuran yang diinstal, konfigurasi Pengaturan Cepat Distributor Anda akan gagal. Sebelum Anda mengonfigurasi EC2 Launch v2 dengan Distributor Quick Setup, hapus instalan EC2 Config EC2 atau Launch v1 launch agent, jika ada.
### Konfigurasikan Pengaturan Cepat Distributor untuk EC2 Peluncuran v2
Untuk membuat konfigurasi EC2 Launch v2 dengan Penyiapan Cepat Distributor, gunakan pengaturan berikut saat Anda menyelesaikan langkah-langkah [penerapan paket Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html):
+ **Paket perangkat lunak:** Amazon EC2 Launch v2 agent.
+ **Frekuensi pembaruan:** Pilih frekuensi dari daftar.
+ **Target:** Pilih dari opsi penerapan yang tersedia.
Untuk memeriksa status konfigurasi Anda, navigasikan ke tab Systems Manager Quick Setup **Configurations** di Konsol Manajemen AWS.
1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Di panel navigasi, pilih **Pengaturan Cepat**.
1. Di tab **Konfigurasi**, pilih baris yang terkait dengan konfigurasi yang Anda buat. **Tab **Konfigurasi** mencantumkan konfigurasi Anda, dan menyertakan ringkasan detail utama, seperti **Region**, status **Deployment, dan status Asosiasi**.**
**catatan**
Nama asosiasi untuk setiap konfigurasi EC2 Launch v2 Distributor dimulai dengan awalan berikut:`AWS-QuickSetup-Distributor-EC2Launch-Agent-`.
1. Untuk melihat detail, pilih konfigurasi dan pilih **Lihat detail**.
*Untuk informasi selengkapnya dan langkah pemecahan masalah, lihat [Memecahkan Masalah hasil Pengaturan Cepat di Panduan Pengguna](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html).AWS Systems Manager *
## EC2Luncurkan unduhan v2 di Amazon S3
Untuk menginstal versi terbaru EC2 Launch v2, unduh penginstal dari lokasi berikut:
+ [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi)
## Konfigurasikan opsi instalasi
Saat Anda menginstal atau memutakhirkan EC2 Launch v2, Anda dapat mengonfigurasi opsi instalasi dengan dialog EC2 Launch v2 install atau dengan **msiexec** perintah di shell baris perintah.
Pertama kali installer EC2 Launch v2 berjalan pada sebuah instance, ini menginisialisasi pengaturan agen peluncuran pada instance Anda sebagai berikut:
+ Ini menciptakan jalur lokal dan menulis file agen peluncuran ke sana. Hal ini terkadang disebut sebagai *instalasi bersih*.
+ Ini menciptakan variabel `EC2LAUNCH_TELEMETRY` lingkungan jika belum ada, dan menetapkannya berdasarkan konfigurasi Anda.
Untuk detail konfigurasi, pilih tab yang cocok dengan metode konfigurasi yang akan Anda gunakan.
------
#### [ Amazon EC2Launch Setup dialog ]
Saat Anda menginstal atau memutakhirkan EC2 Launch v2, Anda dapat mengonfigurasi opsi instalasi berikut melalui dialog EC2 Launch v2 install.Opsi **Instal Dasar**
**Kirim Telemetri**
Saat Anda menyertakan fitur ini dalam dialog penyiapan, penginstal mengatur variabel lingkungan `EC2LAUNCH_TELEMETRY` ke nilai `1`. Jika Anda menonaktifkan **Kirim Telemetri**, penginstal menetapkan variabel lingkungan ke nilai. `0`
Saat agen EC2 Launch v2 berjalan, ia membaca variabel `EC2LAUNCH_TELEMETRY` lingkungan untuk menentukan apakah akan mengunggah data telemetri. Jika nilainya sama dengan `1`, agen menggunggah data. Jika tidak, itu tidak mengunggah.
**Konfigurasi default**
Konfigurasi default untuk EC2 Launch v2 adalah menimpa agen peluncuran lokal jika sudah ada. Pertama kali Anda menjalankan instalasi pada sebuah instans, konfigurasi default melakukan instalasi bersih. Jika Anda menonaktifkan konfigurasi default pada instalasi awal, instalasi gagal.
Jika Anda menjalankan instalasi lagi pada instans, Anda dapat menonaktifkan konfigurasi default untuk melakukan pemutakhiran yang tidak menggantikan file `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`.
**Contoh: Tingkatkan EC2 Peluncuran v2 dengan telemetri**
Contoh berikut menunjukkan dialog setup EC2 Launch v2 yang dikonfigurasi untuk meng-upgrade instalasi saat ini dan mengaktifkan telemetri. Konfigurasi ini melakukan instalasi tanpa mengganti file konfigurasi agen, dan menetapkan variabel lingkungan `EC2LAUNCH_TELEMETRY` ke nilai `1`.
![\[EC2Luncurkan konfigurasi upgrade v2.\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png)
------
#### [ Command line ]
Saat Anda menginstal atau memutakhirkan EC2 Launch v2, Anda dapat mengonfigurasi opsi instalasi berikut dengan **msiexec** perintah di shell baris perintah.Nilai parameter `ADDLOCAL`
**Dasar** (wajib)
Instal agen peluncuran. Jika nilai ini tidak ada dalam `ADDLOCAL` parameter, instalasi berakhir.
**Bersih**
Saat Anda menyertakan nilai `Clean` dalam parameter `ADDLOCAL`, penginstal menuliskan file konfigurasi agen ke lokasi berikut: `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`. Jika file konfigurasi agen sudah ada, file tersebut akan menimpa file.
Saat Anda membiarkan nilai `Clean` keluar dari parameter `ADDLOCAL`, penginstal melakukan pemutakhiran yang tidak menggantikan file konfigurasi agen.
**Telemetri**
Ketika Anda memasukkan nilai `Telemetry` dalam parameter `ADDLOCAL`, pengisntal mengatur variabel lingkungan `EC2LAUNCH_TELEMETRY` ke nilai `1`.
Ketika Anda membiarkan nilai `Telemetry` keluar dari parameter `ADDLOCAL`, pengintal menetapkan variabel lingkungan ke nilai `0`.
Saat agen EC2 Launch v2 berjalan, ia membaca variabel `EC2LAUNCH_TELEMETRY` lingkungan untuk menentukan apakah akan mengunggah data telemetri. Jika nilainya sama dengan `1`, agen menggunggah data. Jika tidak, itu tidak mengunggah.
**Contoh: instal EC2 Launch v2 dengan telemetri**
```
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
```
------
## Verifikasi versi EC2 Launch v2
Gunakan salah satu prosedur berikut untuk memverifikasi versi EC2 Launch v2 yang diinstal pada instans Anda.
------
#### [ PowerShell ]
Verifikasi versi EC2 Launch v2 yang diinstal dengan Windows PowerShell, sebagai berikut.
1. Luncurkan sebuah instans dari AMI dan hubungkan diri Anda dengan instans tersebut.
1. Jalankan perintah berikut PowerShell untuk memverifikasi versi EC2 Launch v2 yang diinstal:
```
& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
```
------
#### [ Windows Control Panel ]
Verifikasi versi EC2 Launch v2 yang diinstal di Panel Kontrol Windows, sebagai berikut.
1. Luncurkan sebuah instans dari AMI dan hubungkan diri Anda dengan instans tersebut.
1. Buka Panel Kontrol Windows dan pilih **Program dan Fitur**.
1. Cari `Amazon EC2Launch` dalam daftar program yang diinstal. Nomor versinya muncul di kolom **Versi**.
------
Untuk melihat pembaruan terbaru untuk AWS Windows AMIs, lihat [riwayat versi Windows AMI](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html) di *Referensi AMI AWS Windows*.
Untuk versi terbaru dari EC2 Launch v2, lihat[EC2Luncurkan riwayat versi v2](ec2launchv2-versions.md#ec2launchv2-version-history).
Anda dapat menerima pemberitahuan ketika versi baru dari layanan EC2 Launch v2 dirilis. Lihat informasi yang lebih lengkap di [Berlangganan pemberitahuan agen peluncuran EC2 Windows](launch-agents-subscribe-notifications.md).
# Konfigurasikan pengaturan EC2 Launch v2 untuk instance Windows
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
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
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
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
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
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
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
Menjalankan EC2 Peluncuran v2.
**Contoh**
```
ec2launch run
```
**Penggunaan**
`ec2launch run [flags]`
**Bendera**
`-h`, `--help`
bantuan untuk `run`
### status
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
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
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
Mendapatkan versi yang dapat dieksekusi.
**Contoh**
```
ec2launch version
```
**Penggunaan**
`ec2launch version [flags]`
**Bendera**
`-h`, `--help`
bantuan untuk `version`
### wallpaper
Menyetel wallpaper baru ke jalur wallpaper yang disediakan (file.jpg), dan menampilkan detail instans yang dipilih.
#### Sintaksis
```
ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,ipv6Address,instanceSize,availabilityZone,architecture
```
#### Masukan
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
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`
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
**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`
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
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
**JSON**
```
{
"version": "1.1",
"tasks": [
{
"task": "string",
"inputs": {
...
},
},
...
]
}
```
**YAML**
```
version: 1.1
tasks:
- task: string
inputs:
...
...
```
#### Contoh: data pengguna
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:
`true`
**Contoh:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
Anda dapat menentukan satu atau lebih PowerShell argumen dengan `` tag. Jika tidak ada argumen yang diteruskan, EC2 Launch v2 menambahkan argumen berikut secara default:`-ExecutionPolicy Unrestricted`.
**Contoh:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
-ExecutionPolicy Unrestricted -NoProfile -NonInteractive
```
Untuk menjalankan skrip data pengguna XML sebagai proses yang terpisah, tambahkan tanda berikut ke data pengguna Anda.
`true`
**Contoh:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
**catatan**
Tanda lepas tidak didukung pada agen peluncuran sebelumnya.
#### Log perubahan: data pengguna
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
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
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).
# Definisi tugas untuk tugas startup EC2 Launch v2
Setiap tugas yang dijalankan EC2 Launch v2 selama peluncuran atau startup memiliki seperangkat properti dan persyaratannya sendiri. Detail tugas mencakup pengaturan untuk seberapa sering tugas berjalan — sekali, atau selalu, tahap proses boot agen apa yang dijalankannya, sintaks, dan contoh dokumen YAMAL. Untuk informasi selengkapnya, tinjau detail tugas yang ditunjukkan dalam referensi ini.
**Topics**
+ [activateWindows](#ec2launch-v2-activatewindows)
+ [enableJumboFrames](#ec2launch-v2-enablejumboframes)
+ [enableOpenSsh](#ec2launch-v2-enableopenssh)
+ [executeProgram](#ec2launch-v2-executeprogram)
+ [executeScript](#ec2launch-v2-executescript)
+ [extendRootPartition](#ec2launch-v2-extendrootpartition)
+ [initializeVolume](#ec2launch-v2-initializevolume)
+ [optimizeEna](#ec2launch-v2-optimizeena)
+ [setAdminAccount](#ec2launch-v2-setadminaccount)
+ [setDnsSuffix](#ec2launch-v2-setdnssuffix)
+ [setHostName](#ec2launch-v2-sethostname)
+ [setWallpaper](#ec2launch-v2-setwallpaper)
+ [startSsm](#ec2launch-v2-startssm)
+ [sysprep](#ec2launch-v2-task-sysprep)
+ [writeFile](#ec2-launch-v2-writefile)
## activateWindows
Mengaktifkan Windows terhadap satu set AWS KMS server. Aktivasi dilewati jika instance terdeteksi sebagai Bring-Your-Own-License (BYOL).
*Frekuensi* - sekali
*AllowedStages* — `[PreReady]`
*Masukan* —
`activation`: (peta)
`type`: (string) tipe aktivasi yang akan digunakan, diatur ke `amazon`
*Contoh*
```
task: activateWindows
inputs:
activation:
type: amazon
```
## enableJumboFrames
Mengaktifkan Jumbo Frames, yang meningkatkan unit transmisi maksimum (MTU) dari adaptor jaringan. Untuk informasi selengkapnya, lihat [Frame jumbo (9001 MTU)](network_mtu.md#jumbo_frame_instances).
*Frekuensi* - selalu
*AllowedStages* — `[PostReady, UserData]`
*Masukan* - tidak ada
*Contoh*
```
task: enableJumboFrames
```
## enableOpenSsh
Mengaktifkan Windows OpenSSH dan menambahkan kunci publik untuk instans tersebut ke folder kunci resmi.
*Frekuensi* — sekali
*AllowedStages* — `[PreReady, UserData]`
*Masukan* - tidak ada
*Contoh*
Contoh berikut menunjukkan cara mengaktifkan OpenSSH pada sebuah instans, dan untuk menambahkan kunci publik untuk instans tersebut ke folder kunci resmi. Konfigurasi ini hanya berfungsi pada instans yang menjalankan Windows Server 2019 dan versi setelahnya.
```
task: enableOpenSsh
```
## executeProgram
Menjalankan program dengan argumen opsional dan frekuensi tertentu.
**Tahapan:** Anda dapat menjalankan tugas `executeProgram` selama tahapan `PreReady`, `PostReady`, dan `UserData`
**Frekuensi:** dapat dikonfigurasi, lihat *Input*.
**Masukan**
Bagian ini berisi satu atau lebih program untuk menjalankan **executeProgram** tugas (input). Setiap input dapat mencakup pengaturan yang dapat dikonfigurasi berikut:
**frekuensi (string)**
(Wajib) Tentukan dengan tepat satu dari nilai-nilai berikut:
+ `once`
+ `always`
**jalur (string)**
(Wajib) Jalur file untuk menjalankan executable.
**argumen (daftar string)**
(Opsional) Daftar argumen yang dipisahkan koma untuk diberikan kepada program sebagai input.
**runAs (string)**
(Wajib) Harus diatur ke `localSystem`
**Output**
Semua tugas menulis entri logfile ke file `agent.log`. Output tambahan dari tugas `executeProgram` disimpan secara terpisah dalam folder bernama dinamis, sebagai berikut:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.tmp`
Jalur yang tepat ke file output disertakan dalam `agent.log` file, misalnya:
```
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
```
**File keluaran untuk `executeProgram` tugas tersebut**
`ExecuteProgramInputs.tmp`
Berisi jalur untuk executable, dan semua parameter input yang diteruskan tugas `executeProgram` padanya saat dijalankan.
`Output.tmp`
Berisi output runtime dari program yang dijalankan tugas `executeProgram`.
`Err.tmp`
Berisi pesan kesalahan runtime dari program yang dijalankan tugas `executeProgram`.
**Contoh**
Contoh berikut menunjukkan cara menjalankan file yang dapat dieksekusi dari direktori lokal pada instans dengan tugas `executeProgram`.
**Contoh 1: File setup yang dapat dieksekusi dengan satu argumen**
Contoh ini menunjukkan tugas `executeProgram` yang menjalankan setup yang dapat dieksekusi dalam mode senyap.
```
task: executeProgram
inputs:
- frequency: always
path: C:\Users\Administrator\Desktop\setup.exe
arguments: ['-quiet']
```
**Contoh 2: VLC dapat dieksekusi dengan dua argumen**
Contoh ini menunjukkan tugas `executeProgram` yang menjalankan file VLC yang dapat dieksekusi dengan dua argumen yang diteruskan sebagai parameter input.
```
task: executeProgram
inputs:
- frequency: always
path: C:\vlc-3.0.11-win64.exe
arguments: ['/L=1033','/S']
runAs: localSystem
```
## executeScript
Menjalankan skrip dengan argumen opsional dan frekuensi tertentu. 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 secara 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.
**Tahapan:** Anda dapat menjalankan tugas `executeScript` selama tahapan `PreReady`, `PostReady`, dan `UserData`
**Frekuensi:** dapat dikonfigurasi, lihat *Input*.
**Masukan**
Bagian ini berisi satu atau lebih skrip untuk **executeScript** tugas yang akan dijalankan (input). Setiap input dapat mencakup pengaturan yang dapat dikonfigurasi berikut:
**frekuensi (string)**
(Wajib) Tentukan dengan tepat satu dari nilai-nilai berikut:
+ `once`
+ `always`
**tipe (string)**
(Wajib) Tentukan dengan tepat satu dari nilai-nilai berikut:
+ `batch`
+ `powershell`
**argumen (daftar string)**
(Opsional) Daftar argumen string untuk diteruskan ke shell (bukan ke PowerShell skrip). Parameter ini tidak didukung untuk `type: batch`. Jika tidak ada argumen yang diteruskan, EC2 Launch v2 menambahkan argumen berikut secara default:`-ExecutionPolicy Unrestricted`.
**konten (string)**
(Wajib) Konten skrip.
**runAs (string)**
(Wajib) Tentukan dengan tepat satu dari nilai-nilai berikut:
+ `admin`
+ `localSystem`
**lepas (Boolean)**
(Opsional) Agen EC2 Launch v2 default untuk menjalankan skrip satu per satu (). `detach: false` Untuk menjalankan skrip secara bersamaan dengan tugas lain, atur nilainya ke `true` (`detach: true`).
Kode keluar skrip (termasuk `3010`) tidak berpengaruh jika `detach` diatur ke `true`.
**Output**
Semua tugas menulis entri logfile ke file `agent.log`. Output tambahan dari skrip yang dijalankan tugas `executeScript` disimpan secara terpisah dalam folder bernama dinamis, sebagai berikut:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.ext`
Jalur yang tepat ke file output disertakan dalam `agent.log` file, misalnya:
```
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
```
**File keluaran untuk `executeScript` tugas tersebut**
`UserScript.ext`
Berisi skrip yang dijalankan tugas `executeScript`. Ekstensi file tergantung pada jenis skrip yang Anda tentukan dalam `type` parameter untuk `executeScript` tugas, sebagai berikut:
+ Jika tipenya adalah `batch`, maka ekstensi file adalah `.bat`.
+ Jika tipenya adalah `powershell`, maka ekstensi file adalah `.ps1`.
`Output.tmp`
Berisi output runtime dari skrip yang dijalankan tugas `executeScript`.
`Err.tmp`
Berisi pesan kesalahan runtime dari skrip yang dijalankan tugas `executeScript`.
**Contoh**
Contoh berikut menunjukkan cara menjalankan skrip inline dengan tugas `executeScript`.
**Contoh 1: File teks output Hello world**
Contoh ini menunjukkan `executeScript` tugas yang menjalankan PowerShell skrip untuk membuat file teks “Hello world” di `C:` drive.
```
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"
```
**Contoh 2: Jalankan dua skrip**
Contoh ini menunjukkan bahwa tugas `executeScript` dapat menjalankan lebih dari satu skrip, dan tipe skrip tidak harus cocok.
Script pertama (`type: powershell`) menulis ringkasan proses yang saat ini berjalan pada instans ke file teks yang terletak di `C:` drive.
Script kedua (`batch`) menulis informasi sistem ke `Output.tmp` file.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |
Get-Process | Out-File -FilePath C:\Process.txt
- frequency: always
type: batch
runAs: localSystem
content: |
systeminfo
```
**Contoh 3: Konfigurasi sistem idempotensi dengan boot ulang**
Contoh ini menunjukkan tugas `executeScript` yang menjalankan skrip idempotensi untuk melakukan konfigurasi sistem berikut dengan boot ulang di antara setiap langkah:
+ Ganti nama komputer.
+ Bergabunglah dengan komputer ke domain.
+ Aktifkan Telnet.
Skrip memastikan bahwa setiap operasi berjalan satu kali saja. Ini mencegah loop reboot dan membuat skrip idempoten.
```
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
}
```
## extendRootPartition
Memperluas volume root untuk menggunakan semua ruang yang tersedia di disk.
*Frekuensi* - sekali
*AllowedStages* — `[Boot]`
*Masukan* - tidak ada
*Contoh*
```
task: extendRootPartition
```
## initializeVolume
Menginisialisasi volume kosong yang dilampirkan ke instans sehingga mereka diaktifkan dan dipartisi. Agen peluncuran melewatkan inisialisasi jika mendeteksi bahwa volume tidak kosong. Volume dianggap kosong jika 4 KiB pertama dari volume adalah kosong, atau jika volume tidak memiliki [tata letak hard disk yang dapat dikenali Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex).
Parameter `letter` input selalu diterapkan saat tugas ini berjalan, terlepas dari apakah drive sudah diinisialisasi.
Tugas `initializeVolume` melakukan tindakan berikut.
+ Atur atribut disk `offline` dan `readonly` ke false.
+ Buat sebuah partisi. Jika tidak ada jenis partisi yang ditentukan dalam parameter `partition` input, default berikut berlaku:
+ Jika ukuran disk lebih kecil dari 2 TB, atur tipe partisi ke `mbr`.
+ Jika ukuran disk 2 TB atau lebih besar, atur tipe partisi ke `gpt`.
+ Format volume sebagai NTFS.
+ Atur label volume sebagai berikut:
+ Gunakan nilai parameter input `name`, jika ditentukan.
+ Jika volumenya fana, dan tidak ada nama yang ditentukan, atur label volume ke. `Temporary Storage Z`
+ Jika volumenya singkat (SSD atau HDD - bukan Amazon EBS), buat `Important.txt` file di root volume dengan konten berikut:
```
This is an 'Instance Store' disk and is provided at no additional charge.
*This disk offers increased performance since it is local to the host
*The number of Instance Store disks available to an instance vary by instance type
*DATA ON THIS DRIVE WILL BE LOST IN CASES OF IMPAIRMENT OR STOPPING THE INSTANCE. PLEASE ENSURE THAT ANY IMPORTANT DATA IS BACKED UP FREQUENTLY
For more information, please refer to: Instans menyimpan penyimpanan blok sementara untuk instans EC2.
```
+ Atur huruf drive ke nilai yang ditentukan dalam parameter `letter` input.
**Tahapan:** Anda dapat menjalankan `initializeVolume` tugas selama `PostReady` dan `UserData` tahapan.
**Frekuensi:** selalu.
**Masukan**
Anda dapat mengonfigurasi parameter runtime sebagai berikut:
**perangkat (daftar peta)**
(Bersyarat) Konfigurasi untuk setiap perangkat yang dimulai agen peluncuran. Ini diperlukan jika parameter input `initialize` diatur ke `devices`.
+ **perangkat (string, wajib)** - Mengidentifikasi perangkat selama pembuatan instans. Sebagai contoh, `xvdb`, `xvdf`, atau `\dev\nvme0n1`.
+ **huruf (string, opsional)** - Satu karakter. Surat drive untuk ditetapkan.
+ **nama (string, opsional)** - Nama volume yang akan ditetapkan.
+ **partisi (string, opsional)** – Tentukan salah satu nilai berikut untuk tipe partisi yang akan dibuat, atau biarkan agen peluncuran menentukan default berdasarkan ukuran volume:
+ mbr
+ gpt
**inisialisasi (string)**
(Wajib) Tentukan dengan tepat satu dari nilai-nilai berikut:
+ `all`
+ `devices`
**Contoh**
Contoh berikut menampilkan konfigurasi input sampel untuk tugas `initializeVolume` tersebut.
**Contoh 1: Inisialisasi dua volume pada sebuah instans**
Contoh ini menunjukkan tugas `initializeVolume` yang menginisialisasi dua volume sekunder pada sebuah instans. Perangkat yang bernama `DataVolume2` dalam contoh tersebut bersifat sementara.
```
task: initializeVolume
inputs:
initialize: devices
devices:
- device: xvdb
name: DataVolume1
letter: D
partition: mbr
- device: /dev/nvme0n1
name: DataVolume2
letter: E
partition: gpt
```
**Contoh 2: Inisialisasi volume EBS yang dilampirkan ke sebuah instans**
Contoh ini menunjukkan tugas `initializeVolume` yang menginisialisasi semua volume EBS kosong yang dilampirkan ke instans.
```
task: initializeVolume
inputs:
initialize: all
```
## optimizeEna
Mengoptimalkan pengaturan ENA berdasarkan tipe instans saat ini; mungkin mem-boot ulang instans.
*Frekuensi* - selalu
*AllowedStages* — `[PostReady, UserData]`
*Masukan* - tidak ada
*Contoh*
```
task: optimizeEna
```
## setAdminAccount
Set atribut untuk akun administrator default yang dibuat di mesin lokal.
*Frekuensi* - sekali
*AllowedStages* — `[PreReady]`
*Masukan* —
`name`: (string) nama akun administrator
`password`: (peta)
`type`: (string) strategi untuk mengatur kata sandi, baik sebagai `static`, `random`, atau `doNothing`
`data`: (string) menyimpan data jika bidang `type` statis
*Contoh*
```
task: setAdminAccount
inputs:
name: Administrator
password:
type: random
```
## setDnsSuffix
Menambahkan sufiks DNS ke daftar sufiks pencarian. Hanya sufiks yang belum ada yang ditambahkan ke daftar. Untuk informasi selengkapnya tentang cara agen peluncuran menyetel sufiks DNS, lihat. [Konfigurasikan DNS Suffix untuk agen peluncuran EC2 Windows](launch-agents-set-dns.md)
*Frekuensi* - selalu
*AllowedStages* — `[PreReady]`
*Masukan* —
`suffixes`: (daftar string) daftar satu atau lebih sufiks DNS yang valid; variabel substitusi yang valid adalah `$REGION` dan `$AZ`
*Contoh*
```
task: setDnsSuffix
inputs:
suffixes:
- $REGION.ec2-utilities.amazonaws.com
```
## setHostName
Menetapkan nama host komputer ke string kustom atau, jika tidak `hostName` ditentukan, IPv4 alamat pribadi.
*Frekuensi* - selalu
*AllowedStages* — `[PostReady, UserData]`
*Masukan* —
`hostName`: (string) nama host opsional, yang harus diformat sebagai berikut.
+ Harus 15 karakter atau kurang
+ Harus hanya berisi karakter alfanumerik (a-z, A-Z, 0-9) dan tanda hubung (-).
+ Tidak boleh seluruhnya terdiri dari karakter numerik.
`reboot`: (boolean) menunjukkan apakah booti ulang diizinkan saat nama host diubah
*Contoh*
```
task: setHostName
inputs:
reboot: true
```
## setWallpaper
Membuat file pintasan `setwallpaper.lnk` di folder startup setiap pengguna yang ada kecuali untuk `Default User`. File pintasan ini berjalan saat pengguna masuk untuk pertama kalinya setelah boot instans. File ini menyiapkan instans dengan wallpaper kustom yang menampilkan atribut instans.
Jalur file pintasan adalah:
```
$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk
```
**catatan**
Saat Anda menghapus tugas `setWallpaper`, file pintasan ini tidak akan terhapus. Untuk informasi selengkapnya, lihat [Tugas `setWallpaper` tidak diaktifkan tetapi wallpaper diatur ulang saat reboot](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-wallpaper-resets).
**Tahapan:** Anda dapat mengonfigurasi wallpaper selama tahapan `PreReady` dan `UserData`.
**Frekuensi:** `always`
**Konfigurasi wallpaper**
Anda dapat menggunakan pengaturan berikut untuk mengonfigurasi wallpaper Anda.
**Masukan**
Parameter masukan yang Anda berikan, dan atribut yang dapat Anda atur untuk mengonfigurasi wallpaper Anda:
**jalur (string)**
(Wajib) Jalur nama file dari file gambar format .jpg lokal yang akan digunakan untuk gambar wallpaper Anda.
**atribut (daftar string)**
(Opsional) Anda dapat menambahkan satu atau lebih atribut berikut ke wallpaper Anda:
+ `architecture`
+ `availabilityZone`
+ `hostName`
+ `instanceId`
+ `instanceSize`
+ `privateIpAddress`
+ `publicIpAddress`
+ `ipv6Address`
**instanceTags**
(Opsional) Anda dapat menggunakan salah satu opsi berikut untuk pengaturan ini.
+ **AllTags**(string) — Tambahkan semua tag instance ke wallpaper Anda.
```
instanceTags: AllTags
```
+ **instanceTags** (daftar string) - Tentukan daftar nama tanda instans untuk ditambahkan ke wallpaper Anda. Contoh:
```
instanceTags:
- Tag 1
- Tag 2
```
**Contoh**
Contoh berikut menunjukkan input konfigurasi wallpaper yang mengatur jalur file untuk gambar latar belakang wallpaper, bersama dengan tanda instans bernama `Tag 1` dan `Tag 2`, serta atribut yang menyertakan nama host, ID instans, dan alamat IP privat serta publik untuk instans tersebut.
```
task: setWallpaper
inputs:
path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
attributes:
- hostName
- instanceId
- privateIpAddress
- publicIpAddress
instanceTags:
- Tag 1
- Tag 2
```
**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).
## startSsm
Memulai layanan Systems Manager (SSM) setelah Sysprep.
*Frekuensi* - selalu
*AllowedStages* — `[PostReady, UserData]`
*Masukan* - tidak ada
*Contoh*
```
task: startSsm
```
## sysprep
Mereset status layanan, update `unattend.xml`, menonaktifkan RDP, dan menjalankan Sysprep. Tugas ini berjalan hanya setelah semua tugas lainnya selesai.
*Frekuensi* - sekali
*AllowedStages* — `[UserData]`
*Masukan* —
`clean`: (boolean) membersihkan log instans sebelum menjalankan Sysprep
`shutdown`: (boolean) menutup instans setelah menjalankan Sysprep
*Contoh*
```
task: sysprep
inputs:
clean: true
shutdown: true
```
## writeFile
Menuliskan file ke tujuan.
*Frekuensi* - lihat *Input*
*AllowedStages* — `[PostReady, UserData]`
*Masukan* —
`frequency`: (string) salah satu `once` atau `always`
`destination`: (string) jalur tempat menulis konten
`content`: (string) teks untuk ditulis ke tujuan
*Contoh*
```
task: writeFile
inputs:
- frequency: once
destination: C:\Users\Administrator\Desktop\booted.txt
content: Windows Has Booted
```
# Memecahkan masalah dengan agen EC2 Launch v2
Bagian ini menunjukkan skenario pemecahan masalah umum untuk EC2 Launch v2, informasi tentang melihat log peristiwa Windows, dan keluaran log konsol dan pesan.
**Topics**
+ [Skenario umum](#ec2launchv2-troubleshooting-scenarios)
+ [Log peristiwa Windows](#ec2launchv2-windows-event-logs)
+ [EC2Luncurkan keluaran log konsol v2](#ec2launchv2-console-output)
## Skenario pemecahan masalah umum
Bagian ini menunjukkan skenario pemecahan masalah umum dan langkah-langkah penyelesaiannya.
**Topics**
+ [Layanan gagal menyetel wallpaper](#ec2launchv2-troubleshooting-wallpaper)
+ [Layanan gagal menjalankan data pengguna](#ec2launchv2-troubleshooting-user-data)
+ [Layanan menjalankan tugas hanya satu kali](#ec2launchv2-troubleshooting-task-once)
+ [Layanan gagal menjalankan tugas](#ec2launchv2-troubleshooting-task-failed)
+ [Layanan menjalankan data pengguna lebih dari satu kali](#ec2launchv2-troubleshooting-user-data-more-than-once)
+ [Tugas terjadwal dari EC2 Launch v1 gagal dijalankan setelah migrasi ke EC2 Launch v2](#ec2launchv2-troubleshooting-scheduled-tasks-migration)
+ [Layanan menginisialisasi volume EBS yang tidak kosong](#ec2launchv2-troubleshooting-ebs-initialize)
+ [Tugas `setWallpaper` tidak diaktifkan tetapi wallpaper diatur ulang saat reboot](#ec2launchv2-troubleshooting-wallpaper-resets)
+ [Layanan macet dalam status berjalan](#ec2launchv2-troubleshooting-service-stuck-running)
+ [Tidak valid `agent-config.yml` mencegah membuka kotak dialog pengaturan EC2 Launch v2](#ec2launchv2-troubleshooting-invalid-agent-config)
+ [`task:executeScript should be unique and only invoked once`](#ec2launchv2-troubleshooting-executescript)
### Layanan gagal menyetel wallpaper
**Resolusi**
1. Periksa apakah `%AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk` ada.
1. Periksa `%ProgramData%\Amazon\EC2Launch\log\agent.log` untuk melihat apakah ada kesalahan yang terjadi.
### Layanan gagal menjalankan data pengguna
**Penyebab potensial**: Layanan mungkin gagal sebelum menjalankan data pengguna.
**Resolusi**
1. Periksa `%ProgramData%\Amazon\EC2Launch\state\previous-state.json`.
1. Lihat jika `boot`, `network`, `preReady`, dan `postReadyLocalData` semuanya telah ditandai sebagai sukses.
1. Jika salah satu tahapan gagal, periksa `%ProgramData%\Amazon\EC2Launch\log\agent.log` jika ada kesalahan tertentu.
### Layanan menjalankan tugas hanya satu kali
**Resolusi**
1. Periksa frekuensi tugas.
1. Jika layanan sudah berjalan setelah Sysprep, dan frekuensi tugas diatur ke `once`, tugas tidak akan dijalankan lagi.
1. Atur frekuensi tugas ke `always` jika Anda ingin menjalankan tugas setiap kali EC2 Launch v2 berjalan.
### Layanan gagal menjalankan tugas
**Resolusi**
1. Periksa entri terbaru di `%ProgramData%\Amazon\EC2Launch\log\agent.log`.
1. Jika tidak ada kesalahan yang terjadi, coba jalankan layanan secara manual dari `"%ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe" run` untuk melihat apakah tugas berhasil.
### Layanan menjalankan data pengguna lebih dari satu kali
**Resolusi**
Data pengguna ditangani secara berbeda antara EC2 Launch v1 dan EC2 Launch v2. EC2Launch v1 menjalankan data pengguna sebagai tugas terjadwal pada instance saat `persist` disetel ke`true`. Jika `persist` diatur ke, `false`maka tugas tidak dijadwalkan bahkan saat keluar dengan reboot atau terganggu saat berjalan.
EC2Launch v2 menjalankan data pengguna sebagai tugas agen dan melacak status jalanannya. Jika masalah data pengguna me-restart komputer atau jika data pengguna terganggu saat berjalan, maka status berjalan-nya masih tetap ada sebagai `pending` dan data pengguna akan berjalan lagi pada boot instans berikutnya. Jika Anda ingin mencegah skrip data pengguna berjalan lebih dari sekali, buat skrip menjadi idempoten.
Contoh skrip idempotensi berikut mengatur nama komputer dan bergabung dengan domain.
```
$name = $env:computername
if ($name -ne $desiredName) {
Rename-Computer -NewName $desiredName
}
$domain = Get-ADDomain
if ($domain -ne $desiredDomain)
{
Add-Computer -DomainName $desiredDomain
}
$telnet = Get-WindowsFeature -Name Telnet-Client
if (-not $telnet.Installed)
{
Install-WindowsFeature -Name "Telnet-Client"
}
false
```
### Tugas terjadwal dari EC2 Launch v1 gagal dijalankan setelah migrasi ke EC2 Launch v2
**Resolusi**
Alat migrasi tidak mendeteksi tugas terjadwal yang ditautkan ke skrip EC2 Launch v1; oleh karena itu, alat ini tidak secara otomatis mengatur tugas-tugas tersebut di EC2 Launch v2. Untuk mengonfigurasi tugas-tugas ini, edit [`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-task-configuration)file, atau gunakan [kotak dialog EC2 Launch v2 settings](ec2launch-v2-settings.md#ec2launch-v2-ui). Misalnya, jika sebuah instance memiliki tugas terjadwal yang berjalan`InitializeDisks.ps1`, maka setelah Anda menjalankan alat migrasi, Anda harus menentukan volume yang ingin Anda inisialisasi di kotak dialog EC2 Launch v2 settings. Lihat Langkah 6 prosedur untuk [Ubah pengaturan menggunakan kotak dialog EC2 Launch v2 settings](ec2launch-v2-settings.md#ec2launch-v2-ui).
### Layanan menginisialisasi volume EBS yang tidak kosong
**Resolusi**
Sebelum menginisialisasi volume, EC2 Launch v2 mencoba mendeteksi apakah itu kosong. Jika volume tidak kosong, maka ia melewatkan inisialisasi. Setiap volume yang terdeteksi sebagai tidak kosong tidak akan diinisialisasi. Volume dianggap kosong jika 4 KiB pertama dari volume adalah kosong, atau jika volume tidak memiliki [tata letak hard disk yang dapat dikenali Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex). Volume yang diinisialisasi dan diformat pada sistem Linux tidak memiliki tata letak hard disk yang dikenali Windows, misalnya MBR atau GPT. Oleh karena itu, volume tersebut akan dianggap sebagai volume kosong dan diinisialisasi. Jika Anda ingin menyimpan data ini, jangan mengandalkan deteksi drive kosong EC2 Luncurkan v2. Sebagai gantinya, tentukan volume yang ingin Anda inisialisasi di [kotak dialog EC2 Launch v2 settings](ec2launch-v2-settings.md#ec2launch-v2-ui) (lihat langkah 6) atau di [`agent-config.yml`](ec2launch-v2-task-definitions.md#ec2launch-v2-initializevolume).
### Tugas `setWallpaper` tidak diaktifkan tetapi wallpaper diatur ulang saat reboot
`setWallpaper`Tugas membuat file `setwallpaper.lnk` pintasan di folder startup setiap pengguna yang ada. File pintasan ini berjalan saat pengguna masuk untuk pertama kalinya setelah boot instans. File ini menyiapkan instans dengan wallpaper kustom yang menampilkan atribut instans. Menghapus `setWallpaper` tugas tidak menghapus file pintasan ini. Anda harus menghapus file ini secara manual atau menghapusnya menggunakan skrip.
Jalur pintasnya adalah:
`$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk`
**Resolusi**
Hapus file ini secara manual, atau hapus menggunakan skrip.
**Contoh PowerShell skrip untuk menghapus file pintasan**
```
foreach ($userDir in (Get-ChildItem "C:\Users" -Force -Directory).FullName)
{
$startupPath = Join-Path $userDir -ChildPath "AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"
if (Test-Path $startupPath)
{
$wallpaperSetupPath = Join-Path $startupPath -ChildPath "setwallpaper.lnk"
if (Test-Path $wallpaperSetupPath)
{
Remove-Item $wallpaperSetupPath -Force -Confirm:$false
}
}
}
```
### Layanan macet dalam status berjalan
**Deskripsi**
EC2Luncurkan v2 diblokir, dengan pesan log (`agent.log`) mirip dengan berikut ini:
```
2022-02-24 08:08:58 Info: *****************************************************************************************
2022-02-24 08:08:58 Info: EC2Launch Service starting
2022-02-24 08:08:58 Info: Windows event custom log exists: Amazon EC2Launch
2022-02-24 08:08:58 Info: ACPI SPCR table not supported. Bailing Out
2022-02-24 08:08:58 Info: Serial port is in use. Waiting for Serial Port...
2022-02-24 08:09:00 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:02 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:04 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:06 Info: ACPI SPCR table not supported. Use default console port.
```
**Kemungkinan penyebab**
SAC diaktifkan dan menggunakan port serial. Untuk informasi selengkapnya, lihat [Gunakan SAC untuk memecahkan masalah instans Windows Anda](troubleshoot-using-serial-console.md#troubleshooting-sac).
**Resolusi**
Coba langkah-langkah berikut untuk mengatasi masalah ini:
+ Nonaktifkan layanan yang menggunakan port serial.
+ Jika Anda ingin layanan terus menggunakan port serial, tulis skrip khusus untuk melakukan tugas agen peluncuran dan menginvokasinya sebagai tugas terjadwal.
### Tidak valid `agent-config.yml` mencegah membuka kotak dialog pengaturan EC2 Launch v2
**Deskripsi**
EC2Luncurkan pengaturan v2 mencoba mengurai `agent-config.yml` file sebelum membuka kotak dialog. Jika file konfigurasi YAMB tidak mengikuti skema yang didukung, kotak dialog akan menampilkan kesalahan berikut:
`Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.`
**Resolusi**
1. Verifikasi bahwa file konfigurasi mengikuti [skema yang didukung](ec2launch-v2-settings.md#ec2launch-v2-schema-agent-config).
1. Jika Anda ingin memulai dari awal, salin file konfigurasi default ke `agent-config.yml`. Anda dapat menggunakan [contoh `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config) yang disediakan di bagian Konfigurasi Tugas.
1. Anda juga dapat memulai dari awal dengan menghapus `agent-config.yml`. EC2Luncurkan pengaturan v2 menghasilkan file konfigurasi kosong.
### `task:executeScript should be unique and only invoked once`
**Deskripsi**
Tugas tidak dapat diulang dalam tahap yang sama.
**Resolusi**
Beberapa tugas harus dimasukkan sebagai array, seperti [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript) dan [**executeProgram**](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram). Untuk contoh cara menulis skrip sebagai array, lihat [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript).
## Log peristiwa Windows
EC2Launch v2 menerbitkan log peristiwa Windows untuk acara penting, seperti memulai layanan, Windows siap, dan keberhasilan dan kegagalan tugas. Pengidentifikasi peristiwa secara unik mengidentifikasi peristiwa tertentu. Setiap acara berisi informasi tahapan, tugas, dan level, serta deskripsi. Anda dapat mengatur pemicu untuk peristiwa tertentu menggunakan pengenal peristiwa.
Acara IDs memberikan informasi tentang suatu peristiwa dan secara unik mengidentifikasi beberapa peristiwa. Digit paling signifikan dari ID peristiwa menunjukkan tingkat keparahan suatu peristiwa.
| Peristiwa | Digit paling tidak signifikan |
| --- | --- |
| Success | . . .0 |
| Informational | . . .1 |
| Warning | . . .2 |
| Error | . . .3 |
Peristiwa terkait layanan yang dihasilkan ketika layanan dimulai atau berhenti termasuk satu digit pengenal peristiwa.
| Peristiwa | Pengenal digit tunggal |
| --- | --- |
| Success | 0 |
| Informational | 1 |
| Warning | 2 |
| Error | 3 |
Pesan peristiwa untuk peristiwa `EC2LaunchService.exe` dimulai dengan `Service:`. Pesan peristiwa untuk peristiwa `EC2Launch.exe` tidak dimulai dengan `Service:`.
Acara empat digit IDs mencakup informasi tentang tahap, tugas, dan tingkat keparahan suatu peristiwa.
**Topics**
+ [Format ID Peristiwa](#ec2launchv2-windows-event-logs-format)
+ [Contoh ID Peristiwa](#ec2launchv2-windows-event-logs-id-examples)
+ [Skema log peristiwa Windows](#ec2launch-v2-windows-event-logs-schema)
### Format ID Peristiwa
Tabel berikut menunjukkan format pengenal peristiwa EC2 Launch v2.
| 3 | 2 1 | 0 |
| --- | --- | --- |
| D | T | L |
Huruf dan angka dalam tabel mewakili tipe dan definisi peristiwa berikut.
| Tipe peristiwa | Definisi |
| --- | --- |
| S (Panggung) | 0 - Pesan tingkat layanan 1 - Boot 2 - Jaringan 3 - PreReady 5 - Windows sudah Siap 6 - PostReady 7 - Data Pengguna |
| T (Tugas) | Tugas yang diwakili oleh dua nilai yang sesuai berbeda untuk setiap tahap. Untuk melihat daftar lengkap peristiwa, lihat [Skema log Peristiwa Windows](#ec2launch-v2-windows-event-logs-schema). |
| L (Level peristiwa) | 0 - Sukses 1 - Informasi 2 - Peringatan 3 - Kesalahan |
### Contoh ID Peristiwa
Berikut ini adalah contoh peristiwa IDs.
+ `5000` - Windows siap digunakan
+ `3010`- Aktifkan tugas windows di PreReady panggung berhasil
+ `6013`- Mengatur tugas wallpaper di tahap Data PostReady Lokal mengalami kesalahan
### Skema log peristiwa Windows
| MessageId/ Id Acara | Pesan peristiwa |
| --- | --- |
| . . .0 | Success |
| . . .1 | Informational |
| . . .2 | Warning |
| . . .3 | Error |
| x | EC2Launch service-level logs |
| 0 | EC2Launch service exited successfully |
| 1 | EC2Launch service informational logs |
| 2 | EC2Launch service warning logs |
| 3 | EC2Launch service error logs |
| 10 | Replace state.json with previous-state.json |
| 100 | Serial Port |
| 200 | Sysprep |
| 300 | PrimaryNic |
| 400 | Metadata |
| x000 | Stage (1 digit), Task (2 digits), Status (1 digit) |
| 1000 | Boot |
| 1010 | Boot - extend\$1root\$1partition |
| 2000 | Network |
| 2010 | Network - add\$1routes |
| 3000 | PreReady |
| 3010 | PreReady - activate\$1windows |
| 3020 | PreReady - install\$1egpu\$1manager |
| 3030 | PreReady - set\$1monitor\$1on |
| 3040 | PreReady - set\$1hibernation |
| 3050 | PreReady - set\$1admin\$1account |
| 3060 | PreReady - set\$1dns\$1suffix |
| 3070 | PreReady - set\$1wallpaper |
| 3080 | PreReady - set\$1update\$1schedule |
| 3090 | PreReady - output\$1log |
| 3100 | PreReady - enable\$1open\$1ssh |
| 5000 | Windows is Ready to use |
| 6000 | PostReadyLocalData |
| 7000 | PostReadyUserData |
| 6010/7010 | PostReadyLocal/UserData - set\$1wallpaper |
| 6020/7020 | PostReadyLocal/UserData - set\$1update\$1schedule |
| 6030/7030 | PostReadyLocal/UserData - set\$1hostname |
| 6040/7040 | PostReadyLocal/UserData - execute\$1program |
| 6050/7050 | PostReadyLocal/UserData - execute\$1script |
| 6060/7060 | PostReadyLocal/UserData - manage\$1package |
| 6070/7070 | PostReadyLocal/UserData - initialize\$1volume |
| 6080/7080 | PostReadyLocal/UserData - write\$1file |
| 6090/7090 | PostReadyLocal/UserData - start\$1ssm |
| 7100 | PostReadyUserData - enable\$1open\$1ssh |
| 6110/7110 | PostReadyLocal/UserData - enable\$1jumbo\$1frames |
## EC2Luncurkan keluaran log konsol v2
Bagian ini berisi contoh keluaran log konsol untuk EC2 Launch v2 dan mencantumkan semua pesan kesalahan log konsol EC2 Luncurkan v2 untuk membantu Anda memecahkan masalah. Untuk informasi selengkapnya tentang keluaran konsol instance dan cara mengaksesnya, lihat[Output konsol instans](troubleshoot-unreachable-instance.md#instance-console-console-output).
**Topics**
+ [EC2Luncurkan keluaran log konsol v2](#ec2launchv2-console-log-output)
+ [EC2Luncurkan pesan log konsol v2](#ec2launchv2-console-log-messages)
### EC2Luncurkan keluaran log konsol v2
Berikut ini adalah contoh keluaran log konsol untuk EC2 Launch v2. Beberapa nilai dalam contoh ini diganti dengan teks representatif yang dikelilingi oleh kurawal kurawal.
```
2025/07/22 21:26:53Z: Windows sysprep configuration complete.
2025/07/22 21:26:53Z: Message: Waiting for access to metadata...
2025/07/22 21:26:53Z: Message: Meta-data is now available.
2025/07/22 21:26:53Z: AMI Origin Version: 2024.12.13
2025/07/22 21:26:53Z: AMI Origin Name: Windows_Server-2022-English-Full-Base
2025/07/22 21:26:53Z: OS: Microsoft Windows NT 10.0.20348
2025/07/22 21:26:53Z: OsVersion: 10.0
2025/07/22 21:26:53Z: OsProductName: Windows Server 2022 Datacenter
2025/07/22 21:26:53Z: OsBuildLabEx: 20348.1.amd64fre.fe_release.210507-1500
2025/07/22 21:26:53Z: OsCurrentBuild: 20348
2025/07/22 21:26:53Z: OsReleaseId: 2009
2025/07/22 21:26:53Z: Language: en-US
2025/07/22 21:26:53Z: TimeZone: UTC
2025/07/22 21:26:53Z: Offset: UTC +0000
2025/07/22 21:26:53Z: Launch: EC2 Launch v2.2.63
2025/07/22 21:26:53Z: AMI-ID: ami-1234567890abcdef1
2025/07/22 21:26:53Z: Instance-ID: i-1234567890abcdef0
2025/07/22 21:26:54Z: Instance Type: t3.xlarge
2025/07/22 21:26:54Z: Driver: AWS NVMe Driver v1.6.0.35
2025/07/22 21:26:54Z: SubComponent: 1.6.0.35; EnableSCSIPersistentReservations: 0
2025/07/22 21:26:54Z: Driver: AWS PV Driver Package v8.5.0
2025/07/22 21:26:55Z: Driver: Amazon Elastic Network Adapter v2.8.0.0
2025/07/22 21:26:55Z: HOSTNAME: EC2AMAZ-9FJG5CC
2025/07/22 21:26:55Z: RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
2025/07/22 21:26:55Z: RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
2025/07/22 21:26:56Z: SSM: Amazon SSM Agent v3.3.2746.0
2025/07/22 21:26:57Z: User data format: no_user_data
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentCommandErrorCode=1
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentErrorLocation=execute_windows.go:410
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/22 21:26:57Z: Message: Windows is Ready to use
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
```
### EC2Luncurkan pesan log konsol v2
Berikut ini adalah daftar semua pesan log konsol EC2 Launch v2.
```
Error EC2Launch service is stopping. {error message}
```
Detail kesalahan layanan yang dihentikan:
+ `Error setting up EC2Launch agent folders`
+ `See instance logs for detail`
+ `Error stopping service`
+ `Error initializing service`
```
Windows sysprep configuration complete
```
```
Invalid administrator username: {invalid username}
```
```
Invalid administrator password
Username: {username}
Password: {encrypted password}
```
Pesan berikut adalah blok informasi yang berisi detail AMI:
```
AMI Origin Version: {amiVersion}
AMI Origin Name: {amiName}
Microsoft Windows NT {currentVersion}.{currentBuildNumber}
OsVersion: {currentVersion}
OsProductName: {productName}
OsBuildLabEx: {buildLabEx}
OsCurrentBuild: {currentBuild}
OsReleaseId: {releaseId}
Language: {language}
TimeZone: {timeZone}
Offset: UTC {offset}
Launch agent: EC2Launch {BuildVersion}
AMI-ID: {amiId}
Instance-ID: {instanceId}
Instance Type: {instanceType}
HOSTNAME: {computer name}
RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
SqlServerBilling: {sql billing}
SqlServerInstall: {sql patch leve, edition type}
Driver: AWS NVMe Driver {version}
Driver: Inbox NVMe Driver {version}
Driver: AWS PV Driver Package {version}
SSM: Amazon SSM Agent {version}
AWS VSS Version: {version}
```
```
Windows sysprep configuration complete.
Windows is being configured. 'SysprepState is {state}'
Windows is still being configured. 'SysprepState is {state}'
Windows is Ready to use
Waiting for access to metadata...
Meta-data is now available.
Metadata is not available for this instance.
Timed out waiting for access to metadata.
User data format: {format}
```
Pesan telemetri EC2launch v2 menyertakan nilai properti telemetri peluncuran. Dimulai dengan versi 2.2.63, data telemetri agen EC2 diformat sebagai objek JSON.
```
EC2LaunchTelemetry: {telemetry property}
```
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
# EC2Luncurkan riwayat versi v2
**Topics**
+ [EC2Luncurkan riwayat versi v2](#ec2launchv2-version-history)
## EC2Luncurkan riwayat versi v2
Untuk memastikan bahwa Anda telah menginstal agen peluncuran terbaru, lihat[Instal versi terbaru EC2 Launch v2](ec2launch-v2-install.md). Anda dapat menerima pemberitahuan saat versi baru agen EC2 Launch v2 dirilis. Untuk informasi selengkapnya, lihat [Berlangganan pemberitahuan agen peluncuran EC2 Windows](launch-agents-subscribe-notifications.md).
Tabel berikut menjelaskan versi rilis EC2 Launch v2.
| Versi | Detail | Tanggal rilis |
| --- | --- | --- |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Maret 5, 2026 |
| 2.3.237 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Februari 25, 2026 |
| 2.3.108 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Desember 29, 2025 |
| 2.3.56 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | November 4, 2025 |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | September 15, 2025 |
| 2.2.63 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Juli 29, 2025 |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 14 Mei 2025 |
| 2.0.2107 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Maret 27, 2025 |
| 2.0.2081 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Februari 4, 2025 |
| 2.0.2046 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Oktober 3, 2024 |
| 2.0.1981 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Agustus 6, 2024 |
| 2.0.1948 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Juli 1, 2024 |
| 2.0.1924 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Juni 10, 2024 |
| 2.0.1914 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Juni 5, 2024 |
| 2.0.1881 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 Mei 2024 |
| 2.0.1815 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Maret 6, 2024 |
| 2.0.1739 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | Januari 17, 2024 |
| 2.0.1702 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 Januari 2024 |
| 2.0.1643 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 Oktober 2023 |
| 2.0.1580 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 September 2023 |
| 2.0.1521 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 Juli 2023 |
| 2.0.1303 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 Mei 2023 |
| 2.0.1245 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 Maret 2023 |
| 2.0.1173 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 Februari 2023 |
| 2.0.1121 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 Januari 2023 |
| 2.0.1082 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 Desember 2022 |
| 2.0.1011 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 11 November 2022 |
| 2.0.1009 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 November 2022 |
| 2.0.982 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 Oktober 2022 |
| 2.0.863 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 Juli 2022 |
| 2.0.698 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 30 Januari 2022 |
| 2.0.674 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15 November 2021 |
| 2.0.651 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 Oktober 2021 |
| 2.0.592 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 Agustus 2021 |
| 2.0.548 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 Agustus 2021 |
| 2.0.470 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 20 Juli 2021 |
| 2.0.285 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 Maret 2021 |
| 2.0.207 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 2 Februari 2021 |
| 2.0.160 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 Desember 2020 |
| 2.0.153 | Menambahkan fungsionalitas Sysprep di. UserData | 3 November 2020 |
| 2.0.146 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 Oktober 2020 |
| 2.0.124 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10 September 2020 |
| 2.0.104 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 12 Agustus 2020 |
| 2.0.0 | Pelepasan awal. | Selasa, Selasa, 30 Juni 2020 |