Contoh parameter baris perintah untuk penginstalan Visual Studio

  • Artikel

Untuk mengilustrasikan cara menggunakan parameter baris perintah untuk menginstal Visual Studio, berikut adalah beberapa contoh yang dapat Anda sesuaikan agar sesuai dengan kebutuhan Anda.

Dalam setiap contoh, vs_enterprise.exe, vs_professional.exe, dan vs_community.exe mewakili masing-masing edisi bootstrapper Visual Studio, yang merupakan file kecil (~ 1MB) yang memulai proses pengunduhan. Jika Anda menggunakan edisi yang berbeda, ganti nama bootstrapper yang sesuai.

Semua perintah memerlukan elevasi administratif, dan perintah Kontrol Akun Pengguna akan ditampilkan jika proses tidak dimulai dari prompt yang ditingkatkan.

Anda dapat menggunakan ^ karakter di akhir baris perintah untuk menggabungkan beberapa baris ke dalam satu perintah. Atau, Anda dapat menempatkan baris ini bersama-sama ke satu baris. Di PowerShell, yang setara adalah karakter backtick (`).

Untuk daftar beban kerja dan komponen yang dapat Anda instal dengan menggunakan baris perintah, lihat halaman BEBAN kerja Visual Studio dan ID komponen.

Instal menggunakan --installPath bersama bootstrapper

  • Instal instans minimal Visual Studio, tanpa perintah interaktif, tetapi kemajuan ditampilkan:

    vs_enterprise.exe --installPath C:\minVS ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
--passive --norestart

  • Instal instans desktop Visual Studio secara diam-diam, dengan paket bahasa Prancis, hanya kembali saat produk diinstal.

    vs_enterprise.exe --installPath C:\desktopVS ^
--addProductLang fr-FR ^
--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
--includeRecommended --quiet --wait

Pembaruan

  • Perbarui instans Visual Studio melalui baris perintah dengan kemajuan yang ditampilkan dan tanpa perintah interaktif. Anda dapat menjalankan serangkaian perintah ini dalam dua langkah dengan menggunakan bootstrapper yang ditemukan di klien atau dalam tata letak. Perintah pertama memperbarui alat penginstal pada klien, dan perintah kedua memperbarui produk Visual Studio. Anda perlu menjalankan perintah ini dalam prompt perintah yang ditinggikan, karena memperbarui alat penginstal memerlukan izin administrator. Contoh berikut mensimulasikan pembaruan klien menggunakan bootstrapper evergreen dalam tata letak.

    \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
\\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"

Atau, Anda juga dapat memperbarui instans Visual Studio dalam satu langkah dengan menggunakan alat penginstal pada klien. Pengguna standar, jika mereka telah diberikan izin yang sesuai, dapat secara terprogram menjalankan perintah pembaruan menggunakan alat penginstal, tetapi mereka tidak diizinkan untuk menggunakan --passive atau --quiet beralih. Perhatikan bahwa Anda tidak dapat memulai alat penginstal secara terprogram dari direktori yang sama dengan tempat alat penginstal berada.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

Menggunakan --wait

  • Gunakan --wait dalam file batch atau skrip untuk menunggu perintah awal selesai sebelum perintah berikutnya dijalankan. Untuk file batch, variabel lingkungan berisi nilai pengembalian perintah, seperti yang %ERRORLEVEL% didokumentasikan dalam halaman Gunakan parameter baris perintah untuk menginstal Visual Studio . Beberapa utilitas perintah mengharuskan parameter lain menunggu penyelesaian dan mendapatkan nilai pengembalian alat penginstal.

Parameter --wait hanya didukung oleh bootstrapper.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

Perintah berikut adalah contoh penggunaan --wait dengan perintah Start-Processskrip PowerShell :

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode

or

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()
  • Yang pertama --wait digunakan oleh bootstrapper Visual Studio, dan yang kedua -Wait digunakan oleh 'Start-Process' untuk menunggu penyelesaian. Parameter -PassThru digunakan oleh Start-Process untuk menggunakan kode keluar alat penginstal untuk nilai pengembaliannya.

Menggunakan --layout untuk membuat tata letak jaringan atau cache lokal

  • Buat tata letak yang hanya menyertakan editor inti Visual Studio (konfigurasi Visual Studio paling minimal) dan paket bahasa Inggris. Contoh pembuatan tata letak lainnya dapat ditemukan di halaman Buat penginstalan jaringan Visual Studio .

    vs_professional.exe --layout "C:\VS" ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^

Menggunakan --all untuk memperoleh seluruh produk

  • Mulai penginstalan interaktif semua beban kerja dan komponen yang tersedia di edisi Visual Studio Enterprise:

    vs_enterprise.exe --all

Menggunakan --includeRecommended

  • Instal instans kedua Visual Studio Professional menggunakan nama panggilan pada komputer dengan edisi Komunitas Visual Studio yang sudah diinstal, dengan dukungan untuk pengembangan Node.js:

    vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode

Menggunakan --channelURI

Dengan menggunakan alat penginstal terbaru, Dimungkinkan untuk mengonfigurasi tempat Visual Studio mencari pembaruan. --channelUri atau dikenal sebagai saluran pembaruan atau lokasi sumber pembaruan. Tabel berikut memberikan contoh nilai untuk channelId dan channelUri dan apa artinya.

Nama Saluran --channelUri --channelId
Saluran Visual Studio 2022 Saat ini https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Saluran Visual Studio 2022 17.0 LTSC https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Saluran Pratinjau Visual Studio 2022 https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Saluran Rilis Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Saluran Rilis Visual Studio 2017 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Tata letak kustom - Saluran Privat \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (atau apa pun tata letaknya didasarkan pada)

Jika Anda memilih untuk menggunakan tata letak kustom sebagai saluran pembaruan, ketahui panduan berikut:

Menggunakan --remove

  • Hapus komponen Alat Pembuatan Profil dari instans Visual Studio yang diinstal secara default. Contoh ini menggunakan alat penginstal yang sudah diinstal pada komputer klien. Pengguna standar dengan izin yang sesuai dapat secara terprogram menjalankan perintah ubah menggunakan alat penginstal , tetapi mereka tidak diizinkan untuk menggunakan --passive atau --quiet beralih. Perhatikan bahwa Anda tidak dapat memulai alat penginstal secara terprogram dari direktori yang sama dengan tempat alat penginstal berada.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--remove Microsoft.VisualStudio.Component.DiagnosticTools ^
--passive

Anda tidak dapat menggunakan --remove dalam perintah yang sama dengan --layout. Dengan kata lain, tidak dimungkinkan untuk menghapus komponen dari tata letak.

Menggunakan --removeOos

Dengan menggunakan alat penginstal terbaru, Anda dapat memodifikasi penginstalan dan menghapus semua komponen yang telah beralih ke status di luar dukungan dari instans Visual Studio yang diinstal secara default. Contoh ini menggunakan alat penginstal yang sudah diinstal pada komputer klien untuk mengonfigurasi pengaturan removeOos. Pengguna standar, jika mereka telah diberikan izin yang sesuai, dapat secara terprogram menjalankan perintah modifikasi menggunakan alat penginstal, tetapi mereka tidak diizinkan untuk menggunakan --passive atau --quiet beralih. Anda tidak dapat memulai alat penginstal secara terprogram dari direktori yang sama dengan tempat alat penginstal berada.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

  • Sesuaikan pengaturan pembaruan untuk menghapus semua komponen yang ditransisikan secara terus-menerus ke status di luar dukungan setiap kali produk diperbarui:

    "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
--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

Menggunakan --path

Semua contoh ini mengasumsikan Anda menginstal produk baru menggunakan bootstrapper.

  • Gunakan jalur instal, cache, dan bersama:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

  • Gunakan hanya jalur penginstalan dan cache:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

  • Gunakan hanya jalur instal dan bersama:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

  • Gunakan hanya jalur penginstalan:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Menggunakan ekspor

  • Gunakan ekspor untuk menyimpan pilihan dari penginstalan. Contoh ini menggunakan alat penginstal yang sudah diinstal pada komputer klien.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"

  • Gunakan ekspor untuk menyimpan pilihan kustom dari awal. Contoh ini menggunakan alat penginstal yang sudah diinstal pada komputer klien.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"

Menggunakan --config

  • Gunakan --config untuk menginstal beban kerja dan komponen dari file konfigurasi penginstalan yang disimpan sebelumnya:

    vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"

  • Gunakan --config untuk menambahkan beban kerja dan komponen ke penginstalan yang ada. Contoh ini menggunakan alat penginstal yang sudah diinstal pada komputer klien. Pengguna standar dengan izin yang sesuai dapat secara terprogram menjalankan perintah ubah menggunakan alat penginstal , tetapi mereka tidak diizinkan untuk menggunakan --passive atau --quiet beralih. Anda tidak dapat memulai alat penginstal secara terprogram dari direktori yang sama dengan tempat alat penginstal berada.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"

  • Gunakan --config untuk mengonfigurasi konten tata letak:

    vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig"

Menggunakan winget

Gunakan alat "winget" Pengelola Paket Windows untuk menginstal atau memperbarui Visual Studio secara terprogram di komputer Anda bersama dengan paket lain yang dikelola oleh winget. Untuk menyesuaikan penginstalan dan menentukan beban kerja dan komponen lain, Anda dapat menggunakan sakelar winget --override bersama perintah wingetinstall, dan meneruskan file vsconfig yang diekspor seperti ini:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config C:\my.vsconfig"

Anda juga dapat menggunakan winget configure dan meneruskan .yaml file untuk memodifikasi penginstalan Visual Studio yang ada. Pendekatan ini menggunakan penyedia DSC Visual Studio PowerShell yang didokumenkan di sini.

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.

Konten terkait