Menambahkan Skrip Kustom ke Penyetelan Windows

Artikel
05/30/2023

Skrip penyetelan Windows

Setupcomplete.cmd dan ErrorHandler.cmd adalah skrip kustom yang berjalan selama atau setelah proses Penyiapan Windows. Mereka dapat digunakan untuk menginstal aplikasi atau menjalankan tugas lain dengan menggunakan skrip cscript/wscript .

%WINDIR%\Setup\Scripts\SetupComplete.cmd: Skrip ini berjalan dengan izin sistem lokal dan segera dimulai setelah pengguna melihat desktop. Pengaturan ini dinonaktifkan saat menggunakan kunci produk OEM, kecuali pada edisi Enterprise dan sistem operasi Windows Server.
%WINDIR%\Setup\Scripts\ErrorHandler.cmd: Skrip ini berjalan secara otomatis saat Penyetelan mengalami kesalahan fatal. Ini berjalan dengan izin sistem lokal.

Jalankan skrip setelah penyiapan selesai (SetupComplete.cmd)

Urutan operasi

Setelah Windows diinstal tetapi sebelum layar masuk muncul, Penyetelan Windows mencari file SetupComplete.cmd di direktori %WINDIR%\Setup\Scripts\ .
Jika file SetupComplete.cmd ditemukan, Penyiapan Windows menjalankan skrip. Penyiapan Windows mencatat tindakan di file C:\Windows\Panther\UnattendGC\Setupact.log .

Penyetelan tidak memverifikasi kode keluar atau tingkat kesalahan dalam skrip setelah menjalankan SetupComplete.cmd.

Peringatan

Anda tidak dapat me-reboot sistem dan melanjutkan menjalankan SetupComplete.cmd. Anda tidak boleh me-reboot sistem dengan menambahkan perintah seperti shutdown -r. Ini akan menempatkan sistem dalam keadaan buruk.
Jika komputer bergabung dengan domain selama penginstalan, Kebijakan Grup yang ditentukan dalam domain tidak diterapkan ke komputer hingga Setupcomplete.cmd selesai. Ini untuk memastikan bahwa aktivitas konfigurasi Kebijakan Grup tidak mengganggu skrip.

Jalankan skrip jika Penyiapan Windows mengalami kesalahan fatal (ErrorHandler.cmd)

ErrorHandler.cmd berguna saat Anda menginstal banyak sistem secara bersamaan. Ini membantu Anda mendeteksi kapan terjadi kesalahan selama Penyetelan Windows. Ketika itu terjadi, Penyetelan secara otomatis menjalankan skrip yang dapat berisi perintah atau tindakan kustom untuk mengatasi penyebab kesalahan.

Jika Penyetelan Windows mengalami kesalahan fatal dan dicegah untuk menyelesaikan penginstalan, Penyetelan Windows mencari skrip perintah di direktori berikut: %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Salah satu dari dua tindakan akan terjadi, tergantung pada apakah skrip ditemukan.

Jika skrip tidak ditemukan, kotak dialog ditampilkan dengan teks kesalahan. Pengguna harus menutup kotak dialog sebelum Penyetelan Windows keluar.
Jika skrip ditemukan, skrip akan dijalankan secara sinkron. Tidak ada kotak dialog atau teks kesalahan yang ditampilkan. Setelah skrip ErrorHandler.cmd selesai berjalan, Penyetelan Windows keluar.

Bergantung pada fase Penyetelan Windows, komputer akan kembali ke lingkungan tempat Penyetelan Windows dijalankan, seperti versi sistem operasi yang lebih lama atau Windows Preinstallation Environment (Windows PE), misalnya.

Mungkin ada instans ketika Penyiapan Windows mengalami lebih dari satu kesalahan dan menjalankan skrip ErrorHandler.cmd lebih dari sekali. Saat mengembangkan kode untuk ErrorHandler.cmd, pastikan Anda dapat menjalankan skrip ini beberapa kali.

Gunakan ErrorHandler.cmd

Untuk menggunakan ErrorHandler.cmd, Anda dapat melakukan salah satu hal berikut:

Pasang gambar, dan tambahkan ke gambar, di %WINDIR%\Setup\Scripts\ErrorHandler.cmd. Lepaskan gambar.

-atau-
Tambahkan ErrorHandler.cmd ke lokasi file sementara (misalnya, C:\Temp\ErrorHandler.cmd), lalu jalankan Penyiapan Windows menggunakan opsi /m .
```
Setup /m:C:\Temp
```
Untuk mempelajari selengkapnya, lihat Opsi Command-Line Penyetelan Windows.

Gunakan Tanpa Pengawas untuk menjalankan skrip

Buat file Unattend.xml dengan salah satu pengaturan ini untuk dijalankan selama proses Penyetelan Windows. Ini dapat digunakan dengan kunci produk OEM.

Untuk menjalankan layanan atau perintah yang dapat dimulai pada saat yang sama, gunakan RunAsynchronousCommands.

Beberapa pengaturan ini berjalan dalam konteks pengguna, yang lain berjalan dalam konteks sistem tergantung pada pass konfigurasi.

Tambahkan Microsoft-Windows-Setup\RunAsynchronousCommand atau RunSynchronousCommand untuk menjalankan skrip saat Penyiapan Windows dimulai. Ini dapat membantu untuk mengatur partisi hard disk.
Tambahkan Microsoft-Windows-Deployment\RunAsynchronousCommand atau RunSynchronousCommand ke pass konfigurasi auditUser untuk menjalankan skrip yang berjalan saat PC memasuki mode audit. Ini dapat membantu untuk tugas-tugas seperti penginstalan atau pengujian aplikasi otomatis.
Tambahkan Microsoft-Windows-Shell-Setup\LogonCommands\AsynchronousCommand atau FirstLogonCommands\SynchronousCommand untuk berjalan setelah Pengalaman Di Luar Kotak (OOBE) tetapi sebelum pengguna melihat desktop. Ini dapat sangat berguna untuk menyiapkan aplikasi atau konten khusus bahasa setelah pengguna memilih bahasa mereka.

Gunakan skrip ini dengan hemat karena skrip panjang dapat mencegah pengguna mencapai layar Mulai dengan cepat. Untuk versi ritel Windows, pembatasan tambahan berlaku untuk skrip ini. Untuk informasi, lihat panduan Lisensi dan Kebijakan di Pusat Mitra OEM.

Catatan

Saat Anda menambahkan skrip menggunakan FirstLogonCommands, skrip akan dipicu pada boot berikutnya, bahkan jika Anda melakukan boot ke mode audit menggunakan Ctrl+Shift+F3. Untuk melakukan boot ke mode audit tanpa memicu skrip ini, tambahkan pengaturan: Microsoft-Windows-Deployment\Reseal\Mode = Audit.

Referensi Teknis Penyiapan Windows Sebarkan Windows Boot Gambar Kustom ke Mode Audit atau OOBE Tambahkan Driver Perangkat ke Windows Selama Penyiapan Windows