Bootstrapping Unduhan Internet
Dengan Windows Installer, executable bootstrap yang dapat dikonfigurasi (Setup.exe) dan alat konfigurasi (Msistuff.exe) disertakan dalam Komponen SDK Windows untuk Pengembang Penginstal Windows. Dengan menggunakan Msistuff.exe untuk mengonfigurasi sumber daya di Setup.exe, pengembang dapat dengan mudah membuat penginstalan web paket Windows Installer.
Versi penginstal minimum yang diperlukan oleh executable bootstrap adalah Windows Installer versi 2.0. Aplikasi bisa mendapatkan versi alat penginstal dengan menggunakan DllGetVersion. Untuk informasi selengkapnya lihat, Menentukan Versi Penginstal Windows
Executable bootstrap yang disediakan dengan Windows Installer SDK melakukan hal berikut:
- Memanggil WinVerifyTrust untuk memverifikasi tanda tangan digital file .msi. Windows Installer versi 2.0 dan versi yang lebih baru menyediakan Subject Interface Package (SIP) untuk mengaktifkan penandatanganan paket penginstal Windows.
- Jika perlu, tingkatkan versi alat penginstal Windows pada komputer.
Sumber daya Setup.exe berikut dapat ditampilkan atau dikonfigurasi menggunakan Msistuff.exe.
| ID sumber daya | Deskripsi |
|---|---|
| ISETUPPROPNAME_BASEURL | Lokasi URL dasar Setup.exe. Jika tidak ada nilai yang ditentukan, lokasi default Setup.exe ke media yang dapat dilepas. Hanya penginstalan berbasis URL yang tunduk pada pemeriksaan dengan WinVerifyTrust. Garis miring berikutnya pada URL bersifat opsional. Sumber daya ini bersifat opsional. |
| ISETUPPROPNAME_DATABASE | Nama file .msi. Ini adalah jalur relatif ke file .msi yang ditentukan relatif terhadap lokasi program Setup.exe. Sumber daya ini diperlukan jika ISETUPPROPNAME_PATCH sumber daya tidak ditentukan. ISETUPPROPNAME_DATABASE dan ISETUPPROPNAME_PATCH tidak dapat ditentukan keduanya. Hanya satu dari dua yang dapat ditentukan. |
| ISETUPPROPNAME_OPERATION | Jenis operasi yang akan dilakukan. Nilai yang mungkin adalah INSTALL, MINPATCH, MAJPATCH, dan INSTALLUPD. Nilai INSTALL sama dengan penginstalan pertama kali paket. Nilai MINPATCH menunjukkan bahwa patch yang ditentukan dalam properti PATCH adalah patch peningkatan kecil atau kecil. Nilai MAJPATCH menunjukkan bahwa patch yang ditentukan dalam properti PATCH adalah patch pembaruan utama. INSTALLUPD menunjukkan bahwa penginstalan bisa menjadi penginstalan pertama kali atau pembaruan. Penggunaan INSTALLUPD memiliki pemeriksaan bootstrap untuk keberadaan produk. Jika produk ada, maka bendera paket penarikan ulang diatur dan penginstalan ulang dilakukan; jika tidak, penginstalan reguler dilakukan. Perhatikan bahwa INSTALLUPD hanya boleh digunakan untuk paket peningkatan kecil dan kecil di mana kode produk tidak berubah. Dalam peningkatan besar, INSTAL ULANG tidak diperlukan karena kode produk berubah, pada dasarnya membuat produk baru. Penulisan tabel Peningkatan selain tindakan FindRelatedProducts, MigrateFeatureStates, dan RemoveExistingProducts menangani peningkatan produk asli. Dengan demikian, opsi INSTALL sudah cukup. Jika sumber daya ini hilang, operasi INSTALL diasumsikan jika properti ISETUPPROPNAME_DATABASE ditulis. Jika tidak, MINPATCH diasumsikan jika properti ISETUPPROPNAME_PATCH ditulis. Ini adalah nilai opsional. |
| ISETUPPROPNAME_PRODUCTNAME | Nama produk. Ini adalah nama yang digunakan dalam teks banner di antarmuka pengguna yang diunduh. Sumber daya ini bersifat opsional. Jika dihilangkan, nama default ke "produk". |
| ISETUPPROPNAME_MINIMUM_MSI | Versi minimum penginstal Windows diperlukan. Jika versi minimum Windows Installer tidak diinstal pada komputer, Instmsi.exe yang sesuai dipanggil untuk meningkatkan Windows Installer. Nilai properti ini memiliki format yang sama dengan nilai PID_PAGECOUNT. Untuk informasi selengkapnya, lihat properti Ringkasan Jumlah Halaman . Nilai ini harus setidaknya 200, nilai yang mengidentifikasi Windows Installer versi 2.0. Sumber daya ini diperlukan. |
| ISETUPPROPNAME_INSTLOCATION | Lokasi URL dasar dari executable peningkatan penginstal Windows. Sumber daya ini dapat dihilangkan. Jika nilai ini dihilangkan, lokasi default dari executable peningkatan adalah lokasi Setup.exe. |
| ISETUPPROPNAME_INSTMSIA | Nama versi ANSI dari peningkatan penginstal Windows yang dapat dieksekusi. Ini adalah jalur relatif ke versi ANSI Instmsi.exe relatif terhadap lokasi yang ditentukan oleh ISETUPPROPNAME_INSTLOCATION. Sumber daya ini diperlukan. |
| ISETUPPROPNAME_INSTMSIW | Nama versi Unicode dari Windows Installer upgrade executable. Ini adalah jalur relatif ke versi Unicode Instmsi.exe relatif terhadap lokasi yang ditentukan oleh ISETUPPROPNAME_INSTLOCATION. Sumber daya ini diperlukan. |
| ISETUPPROPNAME_PATCH | Nama file .msp. Ini adalah jalur relatif ke file .msp yang ditentukan relatif terhadap lokasi program Setup.exe. Sumber daya ini diperlukan jika ISETUPPROPNAME_DATABASE sumber daya tidak ditentukan. ISETUPPROPNAME_DATABASE dan ISETUPPROPNAME_PATCH tidak dapat ditentukan keduanya. Hanya satu dari dua yang dapat ditentukan. |
| ISETUPPROPNAME_PROPERTIES | String PROPERTY=VALUE. Ini adalah pasangan PROPERTY=VALUE untuk disertakan pada baris perintah. Opsi ini bersifat opsional. |
Misalnya, nilai ISETUPPROPNAME_BASEURL dan ISETUPPROPNAME_DATABASE berikut akan digunakan untuk lokasi paket hipotetis berikut.
| Lokasi paket aktual | Nilai sumber daya |
|---|---|
| https://www.blueyonderairlines.com/Products/Product1/product1.msi | ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = product1.msi |
| https://www.blueyonderairlines.com/Products/Product1/product1.msi | ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = .. /Products1/product1.msi |
| e:\product1.msi | Hilangkan ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = product1.msi |
| e:\setup\product1.msi (Lokasi Setup.exe yang sedang berjalan adalah e:\setup.exe.) |
Hilangkan ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = Setup\product1.msi |
Parameter Baris Perintah Setup.exe
Tabel berikut mencantumkan opsi perintah yang dapat digunakan dengan Setup.exe yang dikirim dengan Komponen SDK Windows untuk Pengembang Penginstal Windows. Saat dipanggil tanpa opsi baris perintah, Setup.exe default ke perilaku yang ditentukan melalui sumber daya yang dikonfigurasi. Opsi baris perintah saling eksklusif — hanya satu dari mereka yang dapat digunakan pada satu waktu.
| Opsi | Penggunaan | Makna |
|---|---|---|
| /a | setup.exe /a | Memulai penginstalan administratif. Jika properti ISETUPPROPNAME_DATABASE dikonfigurasi dalam Setup.exe, maka opsi ini dapat digunakan untuk melakukan penginstalan administratif produk. Opsi baris perintah ini tidak didukung jika sumber daya ISETUPPROPNAME_PATCH dikonfigurasi. |
| /a | setup.exe /afull-path< ke instalasi> administratif yang ada | Jika properti ISETUPPROPNAME_PATCH dikonfigurasi dalam Setup.exe, maka opsi ini dapat digunakan untuk menambal penginstalan administratif produk yang ada. Opsi baris perintah ini tidak didukung jika sumber daya ISETUPPROPNAME_DATABASE dikonfigurasi. |
| /v | setup.exe jalur /vfull< ke file> | Memverifikasi tanda tangan pada file menggunakan WinVerifyTrust. Tidak ada UI yang ditampilkan ketika opsi ini digunakan. Dalam hal ini, hasil pemeriksaan kepercayaan adalah nilai pengembalian yang diperoleh dari eksekusi Setup.exe. |
| /? | Menampilkan dialog bantuan yang menunjukkan argumen yang valid. Catatan: Dialog bantuan juga ditampilkan jika argumen yang tidak valid disediakan. |
Untuk informasi selengkapnya, lihat Contoh Penginstalan Penginstal Windows Berbasis URL.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk