Menggunakan parameter baris perintah untuk menginstal, memperbarui, dan mengelola Visual Studio

Berlaku untuk:yaVisual Studio tidakVisual Studio untuk Mac tidakVisual Studio Code

Saat menginstal Visual Studio secara terprogram atau dari prompt perintah, Anda dapat menggunakan berbagai parameter baris perintah untuk mengontrol atau menyesuaikan penginstalan untuk melakukan tindakan berikut:

  • Mulai penginstalan pada klien dengan opsi dan perilaku tertentu yang telah dipilih sebelumnya.
  • Mengotomatiskan proses penginstalan atau pembaruan.
  • Buat atau pertahankan tata letak jaringan file produk untuk menginstal atau memperbarui komputer klien.

Opsi baris perintah yang dijelaskan di bawah ini dapat digunakan dengan bootstrapper penyiapan, yang merupakan file kecil (~1 MB) (misalnya, vs_enterprise.exe) yang memulai proses pengunduhan, atau dengan alat penginstal. Semua perintah dan parameter yang tercantum di bawah ini dirancang untuk bekerja dengan bootstrappers kecuali ditentukan secara eksplisit untuk menjadi alat penginstal saja. Perhatikan bahwa komputer klien mungkin hanya memiliki alat penginstal yang tersedia untuk eksekusi terprogram jika Visual Studio diinstal melalui tata letak.

Dimungkinkan juga untuk menggunakan paket Pembaruan Administrator, yang tersedia untuk diunduh dari Katalog Pembaruan Microsoft, untuk memperbarui tata letak jaringan Anda secara terprogram. Informasi selengkapnya cara melakukan ini dapat ditemukan di dokumentasi Perbarui atau ubah tata letak Anda .

Anda bisa mendapatkan bootstrapper Visual Studio 2019 dari tabel di bawah ini. Atau, jika Anda menginginkan versi Visual Studio 2019 tertentu, Anda dapat membuka halaman Rilis Visual Studio 2019 , yang memiliki tautan ke bootstrapper versi tetap untuk versi dan edisi Visual Studio yang Anda pilih.

Edisi Bootstrapper
Visual Studio 2019 Enterprise versi 16.11 vs_enterprise.exe
Visual Studio 2019 Professional versi 16.11 vs_professional.exe
Visual Studio 2019 Build Tools versi 16.11 vs_buildtools.exe

Untuk mendapatkan bootstrapper terbaru untuk Visual Studio 2022 yang akan selalu menginstal versi terbaru saluran Saat ini, unduh salah satu file di bawah ini. Atau, jika Anda ingin menginstal versi tertentu atau saluran tertentu dari Visual Studio 2022, buka halaman Riwayat Rilis Visual Studio 2022 , yang memiliki tautan ke bootstrapper versi tetap untuk setiap rilis layanan.

Edisi Bootstrapper
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Komunitas Visual Studio 2022 vs_community.exe
Alat Build Visual Studio 2022 vs_buildtools.exe

Tip

Jika sebelumnya Anda mengunduh file bootstrapper dan ingin memverifikasi versinya, berikut caranya. Di Windows, buka File Explorer, klik kanan file bootstrapper, pilih Properti, pilih tab Detail, lalu tampilkan nomor Versi produk. Untuk mencocokkan angka tersebut dengan rilis Visual Studio, lihat tabel di bagian bawah halaman Rilis Visual Studio 2019 .

Tip

Jika sebelumnya Anda mengunduh file bootstrapper dan ingin memverifikasi versi apa yang akan diinstalnya, berikut caranya. Di Windows, buka File Explorer, klik kanan file bootstrapper, pilih Properti lalu pilih tab Detail. Bidang Versi produk akan menjelaskan saluran dan versi yang akan diinstal bootstrapper. Nomor versi harus selalu dibaca sebagai "versi layanan terbaru dari apa yang ditentukan", dan salurannya Adalah Saat Ini kecuali ditentukan secara eksplisit. Jadi, bootstrapper dengan LTSC 17.0 versi Produk akan menginstal rilis layanan 17.0.x terbaru yang tersedia di saluran LTSC 17.0. Bootstrapper dengan versi Produk yang hanya mengatakan Visual Studio 2022 akan menginstal versi terbaru Visual Studio 2022 di saluran Saat ini.

Alat Penginstal Visual Studio dapat ditemukan di sini: C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Perhatikan bahwa Anda tidak dapat memulai alat penginstal secara terprogram dari direktori yang sama tempat alat penginstal berada.

Instal, Perbarui, Ubah, Perbaiki, Hapus Instalasi, dan Ekspor perintah dan parameter baris perintah

Saat memanggil bootstrapper Visual Studio atau alat penginstal secara terprogram untuk menginstal produk atau mempertahankan tata letak, parameter pertama adalah perintah (kata kerja) yang menjelaskan operasi yang akan dilakukan. Parameter baris perintah opsional berikutnya, yang semuanya diawali oleh dua tanda hubung (--), lebih lanjut menentukan bagaimana operasi tersebut seharusnya terjadi. Semua parameter baris perintah Visual Studio tidak peka huruf besar/kecil, dan contoh tambahan dapat ditemukan di halaman Contoh parameter baris perintah .

Contoh sintaks: vs_enterprise.exe [command] <optional parameters>...

Perintah Deskripsi
(kosong) Perintah default menginstal produk, dan digunakan untuk semua operasi pemeliharaan tata letak.
modify Memodifikasi produk yang diinstal.
update Updates produk yang diinstal.
updateall Updates semua produk yang diinstal secara berurutan. Bekerja dengan --quiet parameter dan --passive .
repair Memperbaiki produk yang diinstal.
uninstall Menghapus instalan produk yang terinstal.
export Mengekspor pilihan penginstalan ke file konfigurasi penginstalan. Catatan: Hanya dapat digunakan dengan vs_installer.exe atau setup.exe.

Penting

Saat menentukan beberapa beban kerja atau komponen atau bahasa yang berbeda, Anda harus mengulangi --add sakelar baris perintah atau --remove untuk setiap item.

Parameter Deskripsi
--installPath <dir> Untuk perintah penginstalan default, parameter ini bersifat Opsional dan menjelaskan di mana instans akan diinstal pada komputer klien. Untuk perintah lain seperti pembaruan atau modifikasi, parameter ini Diperlukan dan menunjukkan direktori penginstalan untuk ditindaklanjuti instans.
--add <one or more workload or component IDs> Opsional: Selama perintah instal atau ubah, parameter yang dapat diulang ini menentukan satu atau beberapa ID beban kerja atau komponen untuk ditambahkan. Komponen artefak yang diperlukan diinstal, tetapi bukan komponen yang direkomendasikan atau opsional. Anda dapat mengontrol komponen tambahan secara global menggunakan --includeRecommended parameter dan/atau --includeOptional . Untuk menyertakan beberapa beban kerja atau komponen, ulangi --add perintah (misalnya, --add Workload1 --add Workload2). Untuk kontrol yang lebih halus, Anda dapat menambahkan ;includeRecommended atau ;includeOptional ke ID (misalnya, --add Workload1;includeRecommended atau --add Workload2;includeRecommended;includeOptional). Untuk informasi selengkapnya, lihat halaman Beban Kerja dan ID komponen .
--remove <one or more workload or component IDs> Opsional: Selama perintah modifikasi, parameter yang dapat diulang ini menentukan satu atau beberapa beban kerja atau ID komponen untuk dihapus. Ini melengkapi dan berakibat mirip --add dengan parameter .
--addProductLang <language-locale> Opsional: Selama perintah instal atau ubah, parameter yang dapat diulang ini menentukan paket bahasa UI yang harus diinstal dengan produk. Jika tidak ada, penginstalan menggunakan paket bahasa yang sesuai dengan lokal komputer. Untuk informasi selengkapnya, lihat bagian Daftar lokal bahasa di halaman ini.
--removeProductLang <language-locale> Opsional: Selama perintah instal atau ubah, parameter yang dapat diulang ini menentukan paket bahasa UI yang harus dihapus dari produk. Ini melengkapi dan berakibat mirip --addProductLang dengan parameter .
--in <path> Opsional: URI atau jalur ke file respons, yang dapat berisi pengaturan konfigurasi.
--all Opsional: Selama perintah instal atau ubah, parameter ini menyebabkan semua beban kerja dan komponen untuk produk diinstal.
--allWorkloads Opsional: Selama perintah instal atau ubah, parameter ini menginstal semua beban kerja dan komponen, tetapi tidak ada komponen yang direkomendasikan atau opsional.
--includeRecommended Opsional: Selama perintah instal atau ubah, parameter ini mencakup komponen yang direkomendasikan untuk beban kerja apa pun yang diinstal, tetapi bukan komponen opsional. Beban kerja ditentukan baik dengan --allWorkloads atau --add.
--includeOptional Opsional: Selama perintah instal atau ubah, parameter ini mencakup komponen opsional untuk beban kerja apa pun yang diinstal, tetapi bukan komponen yang direkomendasikan. Beban kerja ditentukan baik dengan --allWorkloads atau --add.
--quiet, -q Opsional: Digunakan dengan perintah apa pun, parameter ini mencegah antarmuka pengguna ditampilkan saat perintah sedang dijalankan.
--passive, -p Opsional: Parameter ini menyebabkan antarmuka pengguna ditampilkan secara non-interaktif. Parameter ini saling eksklusif dari (dan sebenarnya mengambil alih) --quiet parameter .
--norestart Opsional: Parameter ini harus dipasangkan dengan --passive parameter atau --quiet . Selama perintah instal, perbarui, atau ubah, menambahkan --norestart parameter akan menunda boot ulang yang diperlukan.
--force Opsional: Parameter ini memaksa Visual Studio untuk menutup meskipun ada proses Visual Studio yang sedang digunakan.
--installWhileDownloading Opsional: Selama perintah instal, perbarui, atau ubah, parameter ini memungkinkan Visual Studio mengunduh dan menginstal produk secara paralel. Ini adalah pengalaman default.
--downloadThenInstall Opsional: Selama perintah instal, perbarui, atau ubah, parameter ini memaksa Visual Studio mengunduh semua file sebelum menginstalnya. Ini saling eksklusif dari --installWhileDownloading parameter .
--channelURI Opsional: Selama perintah pembaruan, Anda dapat meneruskan channelURI baru untuk mengubah lokasi pengaturan pembaruan. Sarankan untuk memasangkan dengan parameter --installPath sehingga sangat eksplisit instans Visual Studio mana yang Anda konfigurasi. Lihat contoh sintaks dari --channelURI
--nickname <name> Opsional: Selama perintah instal, parameter ini menentukan nama panggilan untuk ditetapkan ke produk yang diinstal. Nama panggilan tidak boleh lebih panjang dari 10 karakter.
--productKey Opsional: Selama perintah instal, parameter ini menentukan kunci produk yang akan digunakan untuk produk yang diinstal. Ini terdiri dari 25 karakter alfanumerik dalam format xxxxxxxxxxxxxxxxxxxxxxxxx.
--help, --?, -h, -? Menampilkan versi luring halaman ini.
--config <path> Opsional: Selama operasi penginstalan atau modifikasi, ini menentukan beban kerja dan komponen untuk ditambahkan berdasarkan file konfigurasi penginstalan yang disimpan sebelumnya. Operasi ini bersifat aditif dan tidak akan menghapus beban kerja atau komponen apa pun jika tidak ada dalam file. Selain itu, item yang tidak berlaku untuk produk tidak akan ditambahkan. Selama operasi ekspor, ini menentukan lokasi untuk menyimpan file konfigurasi penginstalan.

Perintah tata letak dan parameter baris perintah

Semua operasi manajemen tata letak dijalankan menggunakan exe bootstrapper dan mereka berasumsi bahwa perintah adalah Instal default (kosong), terlepas dari apakah Anda membuat atau memperbarui tata letak. Jadi, semua operasi manajemen tata letak harus dimulai dengan parameter awal yang diperlukan --layout . Tabel di bawah ini menjelaskan parameter lain yang dapat Anda gunakan untuk membuat atau memperbarui tata letak menggunakan baris perintah.

Parameter tata letak Deskripsi
--layout <dir> Menentukan direktori untuk membuat atau memperbarui cache penginstalan offline. Untuk informasi selengkapnya, lihat Membuat penginstalan Visual Studio berbasis jaringan.
--lang <one or more language-locales> Opsional: Digunakan dengan --layout untuk menyiapkan cache penginstalan offline dengan paket sumber daya dengan bahasa yang ditentukan. Untuk informasi selengkapnya, lihat bagian Daftar lokal bahasa di halaman ini.
--add <one or more workload or component IDs> Opsional: Satu atau beberapa beban kerja atau ID komponen untuk ditambahkan. Komponen artefak yang diperlukan diinstal, tetapi bukan komponen yang direkomendasikan atau opsional. Anda dapat mengontrol komponen tambahan secara global menggunakan --includeRecommended dan/atau --includeOptional. Untuk kontrol yang lebih halus, Anda dapat menambahkan ;includeRecommended atau ;includeOptional ke ID (misalnya, --add Workload1;includeRecommended atau --add Workload2;includeOptional). Untuk informasi selengkapnya, lihat halaman Beban Kerja dan ID komponen .
Catatan: Jika --add digunakan, hanya beban kerja dan komponen yang ditentukan dan dependensinya yang diunduh. Jika --add tidak ditentukan, semua beban kerja dan komponen diunduh ke tata letak.
--includeRecommended Opsional: Menyertakan komponen yang direkomendasikan untuk beban kerja apa pun yang diinstal, tetapi bukan komponen opsional. Beban kerja ditentukan baik dengan --allWorkloads atau --add.
--includeOptional Opsional: Menyertakan komponen yang direkomendasikan dan opsional untuk beban kerja apa pun yang disertakan dalam tata letak. Beban kerja ditentukan dengan --add.
--keepLayoutVersion Opsional: Terapkan perubahan pada tata letak tanpa memperbarui versi produk yang disertakan dalam tata letak.
--useLatestInstaller Opsional: Jika ada, versi terbaru Alat Penginstal Visual Studio akan disertakan dalam tata letak Anda, bahkan jika itu milik versi produk yang lebih baru. Ini dapat berguna jika Anda ingin memanfaatkan fitur baru atau perbaikan bug yang tersedia di alat penginstal terbaru. Untuk informasi selengkapnya, lihat Mengonfigurasi tata letak untuk selalu menggunakan dokumentasi alat penginstal terbaru .
--verify Opsional: Verifikasi konten tata letak. File yang rusak atau hilang tercantum.
--fix Opsional: Verifikasi konten tata letak. Jika ada file yang rusak atau hilang, file akan didownload ulang. Akses internet diperlukan untuk memperbaiki tata letak.
--clean <one or more paths to catalogs> Opsional: Menghapus versi komponen lama dari tata letak yang telah diperbarui ke versi yang lebih baru.
Parameter tata letak tingkat lanjut Deskripsi
--channelId <id> Opsional: ID saluran untuk instans yang akan diinstal. Ini diperlukan untuk perintah instal, dan diabaikan untuk perintah lain jika --installPath ditentukan.
--channelUri <uri> Opsional: URI manifes saluran. Nilai ini mengatur lokasi sumber pembaruan dan nilai awal dikonfigurasi dalam file response.json tata letak. Lihat contoh sintaks --channelURI untuk nilai yang mungkin. Jika pembaruan tidak diinginkan, --channelUri dapat menunjuk ke file yang tidak ada (misalnya, --channelUri C:\dontExist.chman). Ini dapat digunakan untuk perintah instal; diabaikan untuk perintah lain.
--installChannelUri <uri> Opsional: URI manifes saluran yang akan digunakan untuk penginstalan. URI yang ditentukan oleh --channelUri (yang harus ditentukan ketika --installChannelUri ditentukan) digunakan untuk mendeteksi pembaruan. Ini dapat digunakan untuk perintah instal; diabaikan untuk perintah lain.
--installCatalogUri <uri> Opsional: URI manifes katalog yang akan digunakan untuk penginstalan. Jika ditentukan, manajer saluran mencoba mengunduh manifes katalog dari URI ini sebelum menggunakan URI dalam manifes saluran penginstalan. Parameter ini digunakan untuk mendukung penginstalan offline, di mana cache tata letak akan dibuat dengan katalog produk yang sudah diunduh. Ini dapat digunakan untuk perintah instal; diabaikan untuk perintah lain.
--productId <id> Opsional: ID produk untuk instans yang akan diinstal. Ini telah diisi sebelumnya dalam kondisi penginstalan normal. productID adalah sesuatu seperti "Microsoft.VisualStudio.Product.Enterprise".
--wait Opsional: Proses akan menunggu hingga penginstalan selesai sebelum mengembalikan kode keluar. Ini berguna saat mengotomatiskan penginstalan di mana seseorang perlu menunggu penginstalan selesai untuk menangani kode pengembalian dari penginstalan tersebut.
--locale <language-locale> Opsional: Ubah bahasa tampilan antarmuka pengguna untuk alat penginstal itu sendiri. Pengaturan akan tetap ada. Untuk informasi selengkapnya, lihat bagian Daftar lokal bahasa di halaman ini.
--cache Opsional: Jika ada, paket akan disimpan setelah diinstal untuk perbaikan berikutnya. Ini mengambil alih pengaturan kebijakan global yang akan digunakan untuk penginstalan, perbaikan, atau modifikasi berikutnya. Kebijakan defaultnya adalah membuat cache paket. Ini diabaikan untuk perintah hapus instalan. Baca cara menonaktifkan atau memindahkan cache paket untuk informasi selengkapnya.
--nocache Opsional: Jika ada, paket akan dihapus setelah diinstal atau diperbaiki. Mereka akan diunduh lagi hanya jika diperlukan dan dihapus lagi setelah digunakan. Ini mengambil alih pengaturan kebijakan global yang akan digunakan untuk penginstalan, perbaikan, atau modifikasi berikutnya. Kebijakan defaultnya adalah membuat cache paket. Ini diabaikan untuk perintah hapus instalan. Baca cara menonaktifkan atau memindahkan cache paket untuk informasi selengkapnya.
--noUpdateInstaller Opsional: Jika ada, mencegah alat penginstal memperbarui dirinya sendiri saat diam ditentukan. Alat penginstal akan gagal perintah dan mengembalikan kode keluar bukan nol jika noUpdateInstaller ditentukan dengan tenang ketika pembaruan alat penginstal diperlukan.
--noWeb Opsional: Jika ada, penyiapan Visual Studio menggunakan file di direktori tata letak Anda untuk menginstal Visual Studio. Jika pengguna mencoba menginstal komponen yang tidak ada di tata letak, penyiapan gagal. Untuk informasi selengkapnya, lihat Menyebarkan dari penginstalan jaringan.

Penting: Sakelar ini tidak menghentikan penyiapan Visual Studio untuk memeriksa pembaruan. Untuk informasi selengkapnya, lihat Mengontrol pembaruan untuk penyebaran Visual Studio berbasis jaringan.
--path <name>=<path> Opsional: Digunakan untuk menentukan jalur penginstalan kustom untuk penginstalan. Nama jalur yang didukung dibagikan, di-cache, dan diinstal.
--path cache=<path> Opsional: Menggunakan lokasi yang Anda tentukan untuk mengunduh file penginstalan. Lokasi ini hanya dapat diatur saat pertama kali Visual Studio diinstal. Contoh: --path cache="C:\VS\cache"
--path shared=<path> Opsional: Berisi file bersama untuk penginstalan Visual Studio berdampingan. Beberapa alat dan SDK diinstal ke lokasi pada drive ini, sementara beberapa alat lain mungkin mengambil alih pengaturan ini dan menginstal ke drive lain. Contoh: --path shared="C:\VS\shared"

Penting: Ini hanya dapat diatur sekali dan pada pertama kali Visual Studio diinstal.
--path install=<path> Opsional: Setara dengan –-installPath. Secara khusus, --installPath "C:\VS" dan --path install="C:\VS" setara. Hanya salah satu perintah ini yang dapat digunakan pada satu waktu.

Mengonfigurasi lokasi sumber perintah pembaruan dan parameter baris perintah

Anda dapat mengonfigurasi lokasi sumber pembaruan secara terprogram untuk instans Visual Studio tertentu dengan menggunakan alat penginstal atau bootstrapper pada komputer klien, dan melewati saluran pembaruan yang diinginkan.

parameter modifySettings Deskripsi
--installPath <dir> Disarankan untuk digunakan untuk menentukan instans Visual Studio mana yang akan ditindaklanjuti.
--newChannelUri Diperlukan: URI manifes saluran. Nilai ini menentukan lokasi sumber pembaruan berikutnya. Lihat contoh sintaks --channelURI untuk nilai yang mungkin. Jika pembaruan tidak diinginkan, --channelUri dapat menunjuk ke file yang tidak ada (misalnya, --channelUri C:\dontExist.chman).
--channelUri URI manifes saluran lama. Dapat digunakan jika --installPath tidak diketahui. Harus digunakan bersama dengan productID untuk mengidentifikasi instans yang tepat untuk ditindaklanjuti.
--productId <id> Harus digunakan jika --channelUri ditentukan dan digunakan untuk mengidentifikasi instans yang tepat untuk ditindak lanjuti. productID adalah sesuatu seperti "Microsoft.VisualStudio.Product.Enterprise".
--quiet, -q Opsional: Parameter ini mencegah antarmuka pengguna ditampilkan saat perintah sedang dijalankan.

Contoh sintaks:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelURI https://aka.ms/vs/17/release.LTSC.17.0/channel

C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelURI https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelURI \\layoutserver\share\path\channelmanifest.json --quiet

Perintah Pembaruan Administrator dan parameter baris perintah

Anda dapat mengunduh Pembaruan Administrator dari Katalog Pembaruan Microsoft dan menggunakannya untuk memperbarui penginstalan klien atau tata letak Anda.

Jika Anda memperbarui tata letak ke versi Visual Studio tertentu, cukup unduh Pembaruan Administrator ke komputer yang menghosting tata letak, buka prompt perintah di komputer tersebut dan jalankan perintah seperti ini: visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

Pada klien, jika Anda mengunduh Pembaruan Administrator ke direktori penginstalan di komputer klien, Anda dapat mengklik dua kali pada file untuk menerapkan pembaruan. Anda juga dapat membuka jendela perintah dan meneruskan beberapa parameter di bawah ini untuk mengubah perilaku default.

Jika Anda menyebarkan pembaruan administrator melalui Microsoft Endpoint Manager (SCCM), Anda dapat memodifikasi paket untuk menyesuaikan perilaku dengan menggunakan parameter di bawah ini. Anda juga dapat mengontrol parameter melalui file konfigurasi pada komputer klien. Untuk informasi selengkapnya, lihat Metode untuk mengonfigurasi pembaruan administrator

Perhatikan bahwa semua parameter Pembaruan Administrator dijalankan secara default dalam konteks "perbarui" kecuali kata kerja tata letak ditentukan.

Parameter pembaruan administrator Deskripsi
--installerUpdateArgs [optional parameters] Parameter ini berfungsi sebagai "array pass-through" dari parameter tertentu yang relevan dengan skenario pembaruan administrator. Parameter opsional yang diaktifkan untuk tujuan ini adalah:

--quiet: Ini adalah pengalaman default untuk pembaruan administrator dan tercantum di sini untuk kelengkapan.
--passive: Parameter ini mengambil alih --quiet parameter . Hal ini menyebabkan UI muncul secara non-interaktif.
--norestart: Parameter ini harus digunakan bersama dengan --quiet atau --passive dan menyebabkan reboot yang diperlukan tertunda.
--noWeb: Parameter ini mencegah Visual Studio memeriksa di internet untuk pembaruan produk.
--force: Parameter ini memaksa Visual Studio untuk menutup, bahkan jika Visual Studio sedang digunakan. Gunakan parameter ini dengan hati-hati, karena dapat menyebabkan hilangnya pekerjaan. Parameter ini harus digunakan dalam konteks pengguna.
--installWhileDownloading: Parameter ini memungkinkan Visual Studio mengunduh dan menginstal produk secara paralel. Ini adalah pengalaman default untuk pembaruan administrator dan tercantum di sini untuk kelengkapan.
--downloadThenInstall: Parameter ini memaksa Visual Studio untuk mengunduh semua file sebelum menginstalnya. Ini saling eksklusif dari --installWhileDownloading parameter .
--checkPendingReboot Pembaruan akan dibatalkan jika ada boot ulang yang tertunda pada komputer, terlepas dari aplikasi mana yang mungkin menyebabkannya. Defaultnya adalah tidak memeriksa reboot yang tertunda.

Contoh sintaks: visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb --checkPendingReboot

Daftar ID beban kerja dan ID komponen

Untuk daftar beban kerja dan ID komponen yang diurutkan menurut produk Visual Studio, lihat halaman BEBAN kerja Visual Studio dan ID komponen .

Daftar lokal bahasa

Bahasa lokal Bahasa
Cs-cz Cheska
De-de Jerman
En-us Inggris
Es-es Spanyol
Fr-fr Prancis
It-it Italia
Ja-jp Jepang
Ko-kr Korea
Pl-pl Polski
Pt-br Bahasa Portugis - Brasil
Ru-ru Rusia
Tr-tr Turki
Zh-cn Bahasa Tionghoa - Sederhana
Zh-tw Bahasa Tionghoa - Tradisional

Kode kesalahan

Bergantung pada hasil operasi, %ERRORLEVEL% variabel lingkungan diatur ke salah satu nilai berikut:

Nilai Hasil
0 Operasi berhasil diselesaikan
740 Elevasi diperlukan
1001 Proses penginstal Visual Studio sedang berjalan
1003 Visual Studio sedang digunakan
1602 Operasi dibatalkan
1618 Penginstalan lain yang berjalan
1641 Operasi berhasil diselesaikan, dan reboot dimulai
3010 Operasi berhasil diselesaikan, tetapi penginstalan memerlukan boot ulang sebelum dapat digunakan
5003 Bootstrapper gagal mengunduh alat penginstal
5004 Operasi dibatalkan
5005 Kesalahan penguraian baris perintah Bootstrapper
5007 Operasi diblokir - komputer tidak memenuhi persyaratan
8001 Kegagalan pemeriksaan mesin arm
8002 Kegagalan pra-pemeriksaan pengunduhan latar belakang
8003 Kegagalan yang dapat dipilih di luar dukungan
8004 Kegagalan direktori target
8005 Memverifikasi kegagalan payload sumber
8006 Proses Visual Studio berjalan
-1073720687 Kegagalan konektivitas
-1073741510 Penginstal Microsoft Visual Studio dihentikan (oleh pengguna atau proses eksternal)
Lainnya
(misalnya:
-1, 1, 1603)
Kondisi kegagalan terjadi - periksa log untuk informasi selengkapnya

Setiap operasi menghasilkan beberapa file log di %TEMP% direktori yang menunjukkan kemajuan penginstalan. Urutkan folder menurut tanggal dan cari file yang dimulai dengan dd_bootstrapper, dd_client, dan dd_setup untuk bootstrapper, aplikasi penginstal, dan mesin penyiapan, masing-masing.

Dukungan atau pemecahan masalah

Kadang-kadang, hal-hal bisa salah. Jika penginstalan Visual Studio Anda gagal, lihat Memecahkan masalah penginstalan dan peningkatan Visual Studio untuk panduan langkah demi langkah.

Berikut adalah beberapa opsi dukungan lainnya:

Lihat juga