Menggunakan parameter baris perintah untuk menginstal, memperbarui, dan mengelola Visual Studio
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.
Kata kerja dan parameter baris perintah berikut dapat digunakan dengan executable atau program berikut:
- Bootstrapper penyiapan, yang merupakan file kecil (~1 MB) (misalnya, vs_enterprise.exe) yang memulai proses pengunduhan dan penginstalan awal.
- Alat penginstal Visual Studio yang mungkin sudah diinstal pada komputer dan terletak di folder
C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Anda harus memulai alat penginstal secara terprogram dari direktori lain tempat alat penginstal berada. Alat penginstal biasanya digunakan untuk memperbarui atau mengubah perintah. - Dengan perintah winget menggunakan winget's --override switch.
- Dengan paket Pembaruan Administrator, yang tersedia untuk diunduh dari Katalog Pembaruan Microsoft, untuk memperbarui tata letak jaringan Anda secara terprogram. Informasi selengkapnya dapat ditemukan di artikel Perbarui atau ubah tata letak Anda.
Tidak semua perintah atau parameter berfungsi dalam setiap situasi ini, dan peringatan atau pengecualian khusus apa pun didokumentasikan. Selain itu, dalam beberapa skenario Anda mungkin tidak memiliki akses ke semua executable ini yang dijelaskan sebelumnya. Misalnya, komputer klien mungkin hanya memiliki alat penginstal yang tersedia untuk eksekusi terprogram jika Visual Studio diinstal melalui tata letak.
Anda bisa mendapatkan bootstrapper Visual Studio 2019 dari tabel berikut. Atau, jika Anda menginginkan versi Visual Studio 2019 tertentu, lihat halaman Rilis Visual Studio 2019. Halaman ini 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 |
| Alat Build Visual Studio 2019 versi 16.11 | vs_buildtools.exe |
Untuk mendapatkan bootstrapper terbaru untuk Visual Studio 2022 yang selalu menginstal versi terbaru saluran Saat Ini, unduh salah satu file dalam tabel berikut. Atau, untuk menginstal versi tertentu atau saluran tertentu dari Visual Studio 2022, lihat halaman Riwayat Rilis Visual Studio 2022. Halaman ini 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 lihat 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 versi Produk LTSC 17.0 akan menginstal rilis layanan 17.0.x terbaru yang tersedia di saluran 17.0 LTSC. Bootstrapper dengan versi Produk yang hanya mengatakan Visual Studio 2022 akan menginstal versi terbaru Visual Studio 2022 di saluran Saat ini.
Instal, Perbarui, Ubah, Perbaiki, Hapus instalan, dan Ekspor perintah dan parameter baris perintah
Saat memanggil bootstrapper Visual Studio atau alat penginstal secara terprogram untuk menginstal produk atau untuk mempertahankan tata letak:
- Parameter pertama adalah perintah (kata kerja) yang menjelaskan operasi yang akan dilakukan.
- Parameter baris perintah opsional berikutnya, semua 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 lebih banyak contoh dapat ditemukan di halaman contoh parameter Baris perintah.
Contoh sintaks: vs_enterprise.exe [command] <optional parameters>...
| Perintah | Keterangan |
|---|---|
| (kosong) | Perintah default menginstal produk, dan digunakan untuk semua operasi pemeliharaan tata letak. |
modify |
Memodifikasi produk yang diinstal. |
update |
Memperbarui produk yang diinstal. |
updateall |
Memperbarui semua produk yang diinstal secara berurutan. Bekerja dengan --quiet parameter dan --passive . |
repair |
Memperbaiki produk yang diinstal. |
uninstall |
Menghapus instalan produk yang diinstal. |
export |
Mengekspor konfigurasi penginstalan ke dalam *.vsconfig file. |
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 | Keterangan |
|---|---|
--installPath <dir> |
Untuk perintah penginstalan default, parameter ini bersifat Opsional dan menjelaskan tempat instans diinstal pada komputer klien. Untuk perintah lain seperti pembaruan atau modifikasi, parameter ini Diperlukan dan menunjukkan direktori penginstalan untuk ditindaklanjuti instans. |
--productId <id> |
Opsional: ID instans produk yang dimodifikasi, dan digunakan dengan --channelId. productID adalah sesuatu seperti "Microsoft.VisualStudio.Product.Enterprise". |
--channelUri |
Opsional: Selama perintah pembaruan, Anda dapat meneruskan yang baru --channelUri untuk mengubah lokasi pengaturan pembaruan. Rekomendasikan untuk dipasangkan dengan --installPath parameter sehingga eksplisit instans Visual Studio mana yang Anda konfigurasi. Lihat contoh sintaks dari --channelUri |
--channelId <id> |
ID saluran, misalnya, VisualStudio.17.Release. Lihat contoh sintaks .--channelId channelId diperlukan untuk memodifikasi operasi, bersama dengan --productID atau --installPath. |
--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 lain secara global menggunakan --includeRecommended dan/atau --includeOptional parameter. 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. |
--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 menyertakan komponen yang direkomendasikan untuk beban kerja apa pun yang diinstal. Ini tidak termasuk komponen opsional. Beban kerja ditentukan baik dengan --allWorkloads atau --add. Harap dicatat bahwa dengan menggunakan --includeRecommended parameter , Anda akan mengaktifkan dialog Pengaturan Pembaruan untuk "menambahkan komponen yang direkomendasikan untuk beban kerja yang diinstal pada pembaruan". Lihat Menyesuaikan pengaturan pembaruan untuk mengubah pengaturan ini. |
--includeOptional |
Opsional: Selama perintah instal atau ubah, parameter ini menyertakan komponen opsional untuk beban kerja apa pun yang diinstal. Ini tidak termasuk komponen yang direkomendasikan. Beban kerja ditentukan baik dengan --allWorkloads atau --add. |
--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 [Daftar lokal bahasa] |
--remove <one or more workload or component IDs> |
Opsional: Selama perintah modifikasi, parameter yang dapat diulang ini menentukan satu atau beberapa ID beban kerja atau komponen yang akan dihapus. Ini melengkapi dan berulah mirip --add dengan parameter . |
| (#list bahasa lokal) 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 berulah mirip --addProductLang dengan parameter . |
--in <path> |
Opsional: URI atau jalur ke file respons, yang dapat berisi pengaturan konfigurasi. |
--quiet |
Opsional: Digunakan dengan perintah apa pun, parameter ini mencegah antarmuka pengguna ditampilkan saat perintah sedang dijalankan. Tidak tersedia untuk digunakan secara terprogram oleh pengguna standar terlepas dari bagaimana kebijakan AllowStandardUserControl ditetapkan. |
--passive, -p |
Opsional: Parameter ini menyebabkan antarmuka pengguna ditampilkan secara non-interaktif. Parameter ini saling eksklusif dari (dan sebenarnya mengambil alih) --quiet parameter . Juga tidak tersedia untuk digunakan secara terprogram oleh pengguna standar terlepas dari bagaimana kebijakan AllowStandardUserControl ditetapkan. |
--norestart |
Opsional: Parameter ini harus dipasangkan dengan --passive parameter atau --quiet . Selama perintah instal, perbarui, atau ubah, menambahkan --norestart parameter menunda boot ulang yang diperlukan. |
--force |
Opsional: Parameter ini memaksa Visual Studio untuk menutup meskipun ada proses Visual Studio yang sedang digunakan. Memaksa Visual Studio menutup dapat menyebabkan hilangnya pekerjaan, jadi gunakan dengan hati-hati. |
--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 . |
--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 penginstalan, parameter ini menentukan kunci produk yang akan digunakan untuk produk yang diinstal. Kunci produk terdiri dari 25 karakter alfanumerik dalam format xxxxxxxxxxxxxxxxxxxxxxxxx. |
--removeOos true |
Opsional: Selama perintah instal, perbarui, atau ubah, parameter ini, diikuti oleh true atau false, memberi tahu Penginstal Visual Studio apakah akan menghapus semua komponen yang diinstal yang ditransisikan ke status di luar dukungan. Perilaku ini berlaku untuk satu peristiwa. Jika Anda ingin membuat perilaku ini persisten, terapkan parameter ini ke perintah modifySettings, dijelaskan nanti, atau konfigurasikan kebijakan global removeOOS. Berguna untuk membantu menjaga keamanan komputer. |
--config <path to *.vsconfig file> |
Opsional: Selama operasi penginstalan atau modifikasi, Anda dapat meneruskan file konfigurasi menggunakan --config parameter untuk menentukan beban kerja, komponen, atau ekstensi yang akan ditambahkan berdasarkan file konfigurasi penginstalan yang disimpan sebelumnya. Operasi ini hanya bersifat aditif; tidak menghapus apa pun yang tidak ditentukan dalam file. Selain itu, item yang ditentukan dalam file konfigurasi yang tidak berlaku untuk produk tidak ditambahkan. Sangat merekomendasikan Anda menentukan jalur yang sepenuhnya memenuhi syarat ke file konfigurasi. Selama operasi ekspor, parameter ini menentukan lokasi untuk menyimpan file konfigurasi penginstalan. |
--allowUnsignedExtensions |
Opsional: Selama operasi penginstalan atau modifikasi berjalan dalam --passive konteks atau --quiet menggunakan --config file, jika ekstensi ditentukan dalam file konfigurasi, parameter ini diperlukan untuk memuat ekstensi tanpa tanda tangan digital. |
--installerOnly |
Opsional: Selama operasi penginstalan atau pembaruan, parameter ini memberi tahu Penginstal Visual Studio untuk menginstal sendiri (alat penginstal) dan bukan produk Visual Studio. Fungsionalitasnya setara dengan --update parameter, tetapi lebih intuitif. Dimaksudkan untuk digunakan saat menyiapkan dan mengonfigurasi mesin klien sebelumnya. |
--help, --?, -h, -? |
Menampilkan versi luring halaman ini. |
Perintah tata letak dan parameter baris perintah
Semua operasi manajemen tata letak, seperti membuat atau memperbarui tata letak, dijalankan menggunakan exe bootstrapper dan mengasumsikan bahwa perintah adalah Penginstalan default (kosong). Semua operasi manajemen tata letak harus dimulai dengan parameter awal yang diperlukan --layout . Tabel berikut ini menjelaskan parameter lain yang bisa Anda gunakan untuk membuat atau memperbarui tata letak menggunakan baris perintah.
| Parameter tata letak | Keterangan |
|---|---|
--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 satu atau beberapa 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 lebih banyak komponen 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. |
--wait |
Opsional: Proses menunggu hingga penginstalan selesai sebelum mengembalikan kode keluar. wait berguna saat mengotomatiskan penginstalan di mana seseorang perlu menunggu instalasi selesai untuk menangani kode pengembalian dari penginstalan tersebut. Parameter --wait hanya dapat diteruskan ke bootstrapper; alat penginstal (setup.exe) tidak mendukungnya. Ini berguna saat memperbarui tata letak. Contoh lainnya dapat ditemukan di sini. |
--useLatestInstaller |
Opsional: Fungsionalitas warisan yang hanya berlaku untuk bootstrapper Visual Studio yang lebih lama dari April 2023. Apa pun yang dikirim setelah April 2023 menggunakan alat penginstal terbaru secara default. Jika parameter ini ada, maka versi terbaru Penginstal Visual Studio disertakan dalam tata letak Anda, bahkan jika itu termasuk dalam versi utama produk yang lebih baru. Alat penginstal terbaru dapat berguna jika Anda ingin memanfaatkan fitur baru atau perbaikan bug yang tersedia dalam versi terbarunya. Untuk informasi selengkapnya, lihat Mengonfigurasi tata letak untuk selalu menggunakan dokumentasi penginstal terbaru. |
--config <path to *.vsconfig file> |
Opsional: Jika ada, Visual Studio menggunakan konten file konfigurasi untuk mengonfigurasi tata letak Anda. Pastikan Anda menentukan jalur yang sepenuhnya memenuhi syarat ke file konfigurasi. |
--noWeb |
Opsional: Jika ada, penyiapan Visual Studio menggunakan file di direktori tata letak Anda untuk menginstal Visual Studio, dan tidak mengunduh paket apa pun dari web. Jika pengguna mencoba menginstal komponen yang tidak ada di tata letak, penyiapan gagal. Jangan gunakan parameter ini jika Anda mencoba menyebarkan tata letak yang dihosting di situs web intranet internal. Untuk informasi selengkapnya, lihat Menginstal pada klien yang tidak memiliki akses internet. Penting: Parameter --noWeb tidak menghentikan Penginstal Visual Studio pada komputer klien yang terhubung ke internet untuk memeriksa pembaruan jika klien dikonfigurasi untuk melihat server yang dihosting Microsoft untuk pembaruan. Dalam hal ini, --noWeb hanya mencegah klien mengunduh paket produk. |
--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 diperbarui ke versi yang lebih baru. |
| Parameter tata letak tingkat lanjut | Keterangan |
|---|---|
--channelId <id> |
Opsional: ID saluran untuk instans yang akan diinstal, diwakili seperti VisualStudio.17.Release. channelId diperlukan untuk perintah instal, dan diabaikan untuk perintah lain jika --installPath ditentukan. Lihat contoh sintaks dari --channelId. |
--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:\doesntExist.chman). Parameter ini dapat digunakan untuk perintah instal; perintah lain mengabaikannya. |
--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. Parameter ini dapat digunakan untuk perintah instal; perintah lain mengabaikannya. |
--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 dibuat dengan katalog produk yang sudah diunduh. Parameter ini dapat digunakan untuk perintah instal; perintah lain mengabaikannya. |
--productId <id> |
Opsional: ID produk untuk instans yang diinstal. Parameter ini telah diisi sebelumnya dalam kondisi penginstalan normal. productID adalah sesuatu seperti "Microsoft.VisualStudio.Product.Enterprise". |
--arch all |
Opsional: Secara default, tata letak dibuat hanya dengan biner produk x64. Untuk menyertakan biner ARM untuk beban kerja yang berlaku bersama biner x64 dalam tata letak, gunakan --arch all parameter atau --arch * . Untuk membuat tata letak biner ARM saja, gunakan --arch arm64 |
--keepLayoutVersion |
Opsional: Terapkan perubahan pada tata letak tanpa memperbarui versi produk yang disertakan dalam tata letak. |
--locale <language-locale> |
Opsional: Ubah bahasa tampilan antarmuka pengguna untuk alat penginstal itu sendiri. Pengaturan akan dipertahankan. 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 ketika diam ditentukan. Alat penginstal akan gagal perintah dan mengembalikan kode keluar bukan nol jika nolUpdateInstaller ditentukan dengan diam ketika pembaruan alat penginstal diperlukan. |
--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 saat 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. |
Perintah ModifySettings dan parameter baris perintah
Anda dapat mengubah pengaturan pembaruan dan secara terprogram mengonfigurasi lokasi sumber pembaruan untuk instans Visual Studio tertentu dengan menggunakan penginstal atau bootstrapper pada komputer klien, dan meneruskan perintah modifySettings dan saluran pembaruan yang diinginkan.
| Perintah | Keterangan |
|---|---|
modifySettings |
Kata kerja yang digunakan untuk mengubah pengaturan pembaruan instans Visual Studio tertentu. |
| parameter modifySettings | Keterangan |
|---|---|
--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:\doesntExist.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". |
--includeRecommended |
Opsional: Selama perintah modifySettings, parameter ini (yang harus memiliki kata true atau false segera setelah itu) memberi tahu alat penginstal Visual Studio untuk menonaktifkan fungsionalitas "tambahkan komponen yang direkomendasikan untuk beban kerja yang diinstal pada pembaruan" dalam dialog Pengaturan Pembaruan. |
--quiet |
Opsional: Parameter ini mencegah antarmuka pengguna ditampilkan saat perintah sedang dijalankan. Tidak tersedia untuk digunakan secara terprogram oleh pengguna standar. |
--removeOos true |
Opsional: Selama perintah modifySettings, parameter ini (yang harus memiliki kata benar atau salah segera setelah itu) memberi tahu alat penginstal Visual Studio untuk secara terus-menerus menghapus (atau tidak menghapus) semua komponen yang terinstal yang telah beralih ke status di luar dukungan. Berguna untuk membantu menjaga keamanan komputer. |
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 --removeOos true
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 --removeOos true --quiet
Perintah putar kembali dan parameter baris perintah
Mulai visual Studio 2022, Anda dapat mengembalikan pembaruan secara terprogram dengan menggunakan alat penginstal pada komputer klien dan meneruskan perintah putar kembali bersama instans jalur penginstalan.
| Perintah | Keterangan |
|---|---|
rollback |
Perintah untuk memutar kembali instans Visual Studio tertentu ke pembaruan yang diinstal sebelumnya. Perintah ini tidak akan berfungsi jika DisableRollback diaktifkan. |
| parameter putar kembali | Keterangan |
|---|---|
--installPath <dir> |
Disarankan untuk digunakan untuk menentukan instans Visual Studio mana yang akan ditindaklanjuti. |
Contoh sintaks:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
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.
Memperbarui tata letak
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
Memperbarui klien
Pada klien, jika Anda mengunduh Pembaruan Administrator ke direktori penginstalan di komputer klien, Anda cukup mengeklik dua kali pada file untuk menerapkan pembaruan. Anda juga dapat membuka jendela perintah dan meneruskan beberapa parameter di bawah ini untuk mengubah perilaku default.
Mengonfigurasi Pembaruan Administrator di SCCM
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 di 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 | Keterangan |
|---|---|
--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. Ini menyebabkan UI muncul dengan cara yang tidak 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 meskipun Visual Studio sedang digunakan. Gunakan parameter ini dengan hati-hati, karena dapat menyebabkan hilangnya pekerjaan. Parameter ini hanya boleh digunakan ketika pembaruan Administrator dijalankan dalam konteks pengguna; ini diabaikan jika pembaruan Administrator dijalankan dalam konteks sistem. --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. --keepWindowsUpdateOn: Parameter ini mencegah alat penginstal menonaktifkan agen Windows Update pada klien. Anda harus menggunakan parameter ini jika Anda mengimpor pembaruan Administrator dari Katalog ke SCCM. Anda mungkin juga perlu mengatur batas waktu paket SCCM menjadi lebih lama dari default 10 menit. Mengubah jenis penyebaran SCCM menjadi Diperlukan membuat parameter ini tidak perlu.--downloadThenInstall: Parameter ini memaksa Visual Studio untuk mengunduh semua file sebelum menginstalnya. Ini saling eksklusif dari --installWhileDownloading parameter . |
--checkPendingReboot |
Pembaruan akan dibatalkan jika ada reboot yang tertunda pada komputer, terlepas dari aplikasi mana yang mungkin menyebabkannya. Defaultnya adalah tidak memeriksa reboot yang tertunda. |
Contoh sintaks untuk meneruskan parameter ke dalam pembaruan Administrator:
visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot
Menghapus perintah saluran dan parameter baris perintah
Saluran yang tersedia untuk diperbarui, di-cache pada klien, dan seiring waktu mereka dapat mengacaukan semuanya. Anda dapat menghapus saluran pembaruan secara manual dengan memunculkan Alat Penginstal Visual Studio, beralih ke tab Tersedia , dan mengklik X di sudut kanan atas kartu produk. Anda dapat menghapus saluran secara terprogram (misalnya, lokasi tata letak yang lebih lama) menggunakan removeChannel perintah . Anda dapat menjalankan vswhere secara terprogram pada komputer klien untuk menentukan saluran mana yang di-cache pada komputer klien.
| Perintah | Keterangan |
|---|---|
removeChannel |
Perintah untuk menghapus saluran dari komputer klien. |
| parameter removeChannel | Keterangan |
|---|---|
--channelUri |
Diperlukan URI manifes saluran lama. |
--quiet |
Opsional Parameter ini mencegah antarmuka pengguna ditampilkan saat perintah sedang dijalankan. |
--passive |
Opsional Parameter ini mengambil alih --quiet parameter. Ini menyebabkan UI muncul dengan cara yang tidak interaktif. |
Contoh sintaks:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"
Menggunakan winget untuk menginstal atau memodifikasi Visual Studio
Anda dapat menggunakan alat "winget" Pengelola Paket Windows untuk menginstal, memodifikasi, atau memperbarui Visual Studio secara terprogram di komputer Anda bersama dengan paket lain yang dikelola oleh winget.
Secara default, winget hanya menginstal beban kerja inti Visual Studio.
winget install --id Microsoft.VisualStudio.2022.Community
Namun, jika Anda ingin menyesuaikan penginstalan dan menentukan beban kerja dan komponen tambahan untuk diperoleh selama penginstalan awal, Anda dapat menggunakan sakelar winget --override bersama perintah wingetinstall, dan meneruskan file vsconfig yang diekspor yang berisi beban kerja dan komponen untuk menambahkan:
winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"
Tentu saja, Anda juga dapat menyertakan komponen secara langsung selama penginstalan awal, seperti ini:
winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"
Jika Anda sudah menginstal Visual Studio di komputer Anda, maka dimungkinkan untuk menggunakan perintah winget configure bersama dengan penyedia Visual Studio PowerShell DSC, file yaml, dan file .vsconfig untuk menambahkan komponen ke penginstalan Visual Studio yang ada. Perintah Winget configure pada dasarnya bertindak sebagai operasi "modifikasi" Visual Studio. Lihat cara menulis file Konfigurasi WinGet untuk mempelajari cara membuat konfigurasi winget.
Tidak dimungkinkan untuk menggunakan --override sakelar atau penyedia Visual Studio DSC bersama perintah winget upgrade , karena upgrade pada dasarnya hanya bertindak sebagai operasi "perbarui" Visual Studio dan menginstal versi terbaru komponen yang telah Anda pilih. Anda tidak dapat menambahkan komponen melalui pembaruan/peningkatan. Anda perlu menggunakan winget untuk configure menambahkan komponen.
Perhatikan bahwa operasi Penginstal Visual Studio saat ini memerlukan hak istimewa administrator, jadi winget akan meminta Anda untuk meningkatkan hak istimewa Anda jika perlu untuk menyelesaikan perintah. Selain itu, saat ini tidak mungkin untuk menggunakan winget untuk menginstal beberapa edisi (yaitu, SKU yang berbeda) atau beberapa instans SKU yang sama pada saat yang sama pada komputer klien. Terakhir, Visual Studio harus ditutup jika Anda akan mengonfigurasi (memodifikasi)nya untuk menambahkan komponen, atau meningkatkannya ke versi terbaru.
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 | Portugis - Brasil |
| Ru-ru | Rusia |
| Tr-tr | Turki |
| Zh-cn | Bahasa Tionghoa - Disederhanakan |
| 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 boot ulang 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 yang berjalan |
| 8010 | Sistem Operasi tidak didukung. Lihat Persyaratan Sistem |
| -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:
- Kami menawarkan opsi dukungan obrolan penginstalan (hanya bahasa Inggris) untuk masalah terkait penginstalan.
- Laporkan masalah produk kepada kami melalui alat Laporkan Masalah yang muncul baik di Penginstal Visual Studio maupun di Ide Visual Studio. Jika Anda adalah Administrator TI dan belum menginstal Visual Studio, Anda dapat mengirimkan umpan balik Admin TI di sini.
- Sarankan fitur, lacak masalah produk, dan temukan jawaban di Komunitas Pengembang Visual Studio.