Contoh parameter baris perintah untuk penginstalan Visual Studio

2025-06-21

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 menjalankan perintah secara non-interaktif, Anda dapat menggunakan--passive atau --quiet. Untuk informasi selengkapnya tentang parameter ini, lihat halaman parameter perintah dan baris perintah .

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

Instal menggunakan --installPath dan --add 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

Pemutakhiran

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 command prompt dengan hak akses tinggi, karena memperbarui penginstal memerlukan izin administrator. Contoh berikut ini mensimulasikan pembaruan klien dengan menggunakan bootstrapper evergreen di dalam tata letaknya.
```
\\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. 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"
```
pengguna Standar, jika mereka telah diberikan izin yang sesuai, dapat secara terprogram menjalankan perintah pembaruan menggunakan alat penginstal, tetapi mereka tidak diizinkan untuk menggunakan sakelar --passive atau --quiet.

Menggunakan --wait

Gunakan --wait dalam file batch atau skrip untuk menunggu perintah awal selesai sebelum perintah berikutnya dijalankan. Untuk file batch, variabel lingkungan %ERRORLEVEL% berisi nilai pengembalian perintah, seperti yang didokumentasikan dalam Gunakan parameter baris perintah untuk menginstal halaman Visual Studio. Beberapa utilitas perintah memerlukan parameter lain untuk menunggu hingga selesai dan mendapatkan nilai pengembalian dari 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 skrip PowerShell Start-Process:
```
$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode 
```
atau
```
  $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()
```
--wait pertama digunakan oleh bootstrapper Visual Studio, dan -Wait kedua digunakan oleh 'Start-Process' untuk menunggu sampai selesai. Parameter -PassThru dimanfaatkan oleh Start-Process untuk menggunakan kode keluaran 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 Membuat penginstalan jaringan Visual Studio.
```
vs_professional.exe --layout "C:\VS" ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
```

Menggunakan fitur --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 alias pada komputer yang sudah memiliki edisi Komunitas Visual Studio terinstal, yang mendukung pengembangan Node.js.
```
vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
```

Menggunakan --channelURI

Menggunakan penginstal terbaru, dimungkinkan untuk mengonfigurasi tempat Visual Studio mencari pembaruan. --channelUri 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`
Visual Studio 2022 17.0 channel 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)

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

--channelUri harus menunjuk ke file 'channelmanifest.json' dalam tata letak kustom.
Administrator dapat mengonfigurasi bagaimana tata letak kustom "Saluran Privat" ditampilkan di antarmuka pengguna Pengaturan Pembaruan dengan mengonfigurasi pengaturan registri klien.

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 modifikasi menggunakan alat penginstal, tetapi mereka tidak diizinkan untuk menggunakan sakelar --passive atau --quiet. 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 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 sakelar --passive atau --quiet. 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-sama:

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 berbagi:

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"

Penggunaan 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 modifikasi menggunakan alat penginstal, tetapi mereka tidak diizinkan untuk menggunakan sakelar --passive atau --quiet. 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 Pengelola Paket Windows "winget" 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 --override winget bersama perintah install winget, 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 file .yaml untuk memodifikasi penginstalan Visual Studio yang ada. Pendekatan ini menggunakan penyedia Visual Studio PowerShell DSC 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:

Gunakan obrolan penginstalan opsi dukungan (hanya dalam bahasa Inggris) untuk masalah terkait penginstalan.
Laporkan masalah produk kepada kami dengan menggunakan 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 .
Sarankan fitur, lacak masalah produk, dan temukan jawaban di Komunitas Pengembang Visual Studio.

Bagikan melalui