Visual Studio yüklemesi için komut satırı parametre örnekleri
Visual Studio'yu yüklemek için komut satırı parametrelerinin nasıl kullanılacağını göstermek için, gereksinimlerinize uyacak şekilde özelleştirebileceğiniz birkaç örnek aşağıda verilmiştir.
Her örnekte , vs_enterprise.exe
vs_professional.exe
ve vs_community.exe
, indirme işlemini başlatan küçük (~ 1 MB) dosya olan Visual Studio önyükleyicisinin ilgili sürümünü temsil eder. Farklı bir sürüm kullanıyorsanız, uygun önyükleyici adını değiştirin.
Tüm komutlar yönetici yükseltmesi gerektirir ve işlem yükseltilmiş bir istemden başlatılmazsa bir Kullanıcı Hesabı Denetimi istemi görüntülenir.
Birden çok satırı tek bir komutta birleştirmek için komut satırının sonundaki karakteri kullanabilirsiniz ^
. Alternatif olarak, bu satırları tek bir satıra yerleştirebilirsiniz. PowerShell'de eşdeğer, backtick (`
) karakteridir.
Komut satırını kullanarak yükleyebileceğiniz iş yüklerinin ve bileşenlerin listesi için Visual Studio iş yükü ve bileşen kimlikleri sayfasına bakın.
Önyükleyicinin yanında --installPath kullanarak yükleme
Etkileşimli istem olmadan ancak ilerleme durumu görüntülenen en düşük Visual Studio örneğini yükleyin:
vs_enterprise.exe --installPath C:\minVS ^ --add Microsoft.VisualStudio.Workload.CoreEditor ^ --passive --norestart
Visual Studio'nun bir masaüstü örneğini Fransızca dil paketiyle sessizce yükleyin ve yalnızca ürün yüklendiğinde geri gönderin.
vs_enterprise.exe --installPath C:\desktopVS ^ --addProductLang fr-FR ^ --add Microsoft.VisualStudio.Workload.ManagedDesktop ^ --includeRecommended --quiet --wait
Güncelleştir
Komut satırı aracılığıyla bir Visual Studio örneğini görüntülenen ilerleme durumuyla ve etkileşimli istem olmadan güncelleştirin. İstemcide veya düzende bulunan bir önyükleyiciyi kullanarak bu komut dizisini iki adımda çalıştırabilirsiniz. İlk komut istemcideki yükleyiciyi, ikinci komut ise Visual Studio ürününü güncelleştirir. Yükleyicinin güncelleştirilmesi yönetici izinleri gerektirdiğinden, bu komutları yükseltilmiş bir komut isteminde çalıştırmanız gerekir. Aşağıdaki örnek, düzende her zaman yeşil bir önyükleyici kullanarak istemcinin güncelleştirilmesinin benzetimini yapar.
\\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait \\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
Alternatif olarak, istemcideki yükleyiciyi kullanarak Visual Studio örneğinizi tek adımda da güncelleştirebilirsiniz. Standart kullanıcılara uygun izinler verildiyse, yükleyiciyi kullanarak program aracılığıyla güncelleştirme komutunu yürütebilir, ancak veya --quiet
anahtarını kullanmalarına --passive
izin verilmez. Yükleyiciyi, yükleyicinin bulunduğu dizinden program aracılığıyla başlatamazsınız.
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"
--wait kullanma
- Sonraki komut yürütülmeden önce ilk komutun tamamlanmasını beklemek için toplu iş dosyalarında veya betiklerde kullanın
--wait
. Toplu iş dosyaları için, Visual%ERRORLEVEL%
Studio'yu yüklemek için komut satırı parametrelerini kullanma sayfasında belirtildiği gibi bir ortam değişkeni komutun dönüş değerini içerir. Bazı komut yardımcı programları, tamamlanmasını beklemek ve yükleyicinin dönüş değerini almak için başka parametreler gerektirir.
--wait
parametresi yalnızca önyükleyici tarafından desteklenir.
start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%
Aşağıdaki komut, PowerShell betik komutuyla Start-Process
kullanımın --wait
bir örneğidir:
$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode
veya
$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()
- Birincisi
--wait
Visual Studio önyükleyicisi tarafından, ikincisi-Wait
ise tamamlanmasını beklemek için 'Start-Process' tarafından kullanılır.-PassThru
parametresi, döndüren değeri için yükleyicinin çıkış kodunu kullanmak için tarafındanStart-Process
kullanılır.
Ağ düzeni veya yerel önbellek oluşturmak için --layout kullanma
Yalnızca Visual Studio çekirdek düzenleyicisini (en düşük Visual Studio yapılandırması) ve İngilizce dil paketini içeren bir düzen oluşturun. Daha fazla düzen oluşturma örneği Visual Studio'nun ağ yüklemesi oluşturma sayfasında bulunabilir.
vs_professional.exe --layout "C:\VS" ^ --lang en-US ^ --add Microsoft.VisualStudio.Workload.CoreEditor ^
Ürünün tamamını almak için --all kullanma
Visual Studio Enterprise sürümünde kullanılabilen tüm iş yüklerinin ve bileşenlerin etkileşimli yüklemesini başlatın:
vs_enterprise.exe --all
--includeRecommended kullanma
Visual Studio Community sürümü zaten yüklü olan ve Node.js geliştirme desteğine sahip bir makineye takma ad kullanarak Visual Studio Professional'ın ikinci bir örneğini yükleyin:
vs_professional.exe --installPath C:\VSforNode ^ --add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
--channelURI kullanma
En son yükleyiciyi kullanarak Visual Studio'nun güncelleştirmeleri nerede arayacağı yapılandırılabilir. --channelUri
, güncelleştirme kanalı veya güncelleştirmelerin kaynak konumu olarak bilinir. Aşağıdaki tabloda channelId ve channelUri için örnek değerler ve bunların anlamı verilmiştir.
Kanal Adı | --channelUri | --channelId |
---|---|---|
Visual Studio 2022 Geçerli kanal | https://aka.ms/vs/17/release/channel |
VisualStudio.17.Release |
Visual Studio 2022 17.0 LTSC kanalı | https://aka.ms/vs/17/release.LTSC.17.0/channel |
VisualStudio.17.Release.LTSC.17.0 |
Visual Studio 2022 Preview kanalı | https://aka.ms/vs/17/pre/channel |
VisualStudio.17.Preview |
Visual Studio 2019 Yayın kanalı | https://aka.ms/vs/16/release/channel |
VisualStudio.16.Release |
Visual Studio 2017 Yayın kanalı | https://aka.ms/vs/15/release/channel |
VisualStudio.15.Release |
Özel düzen - Özel Kanal | \\layoutserver\share\path\channelmanifest.json |
VisualStudio.17.Release (veya düzenin temel alındığı her şey) |
Güncelleştirme kanalı olarak özel bir düzen kullanmayı seçerseniz aşağıdaki yönergeleri dikkate alın:
- özel
--channelUri
düzende 'channelmanifest.json' dosyasına işaret etmelidir. - Yönetici istrator'lar, istemcinin kayıt defteri ayarlarını yapılandırarak güncelleştirme Ayarlar kullanıcı arabiriminde "Özel Kanal" özel düzeninin nasıl görüntüleneceğini yapılandırabilir.
--remove kullanma
Profil Oluşturma Araçları bileşenini varsayılan yüklü Visual Studio örneğinden kaldırın. Bu örnek, istemci makinesinde zaten yüklü olan yükleyiciyi kullanır. Uygun izinlere sahip standart kullanıcılar yükleyiciyi kullanarak program aracılığıyla modify komutunu yürütebilir, ancak veya
--quiet
anahtarını kullanmalarına--passive
izin verilmez. Yükleyiciyi, yükleyicinin bulunduğu dizinden program aracılığıyla başlatamazsınız."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
ile aynı komutta --layout
kullanamazsınız--remove
. Başka bir deyişle, bir düzenden bileşenleri kaldırmak mümkün değildir.
--removeOos kullanma
En son yükleyiciyi kullanarak, bir yüklemeyi değiştirebilir ve varsayılan yüklü Visual Studio örneğinden destek dışı durumuna geçiş yapmış tüm bileşenleri kaldırabilirsiniz. Bu örnek, removeOos ayarını yapılandırmak için istemci makinesinde zaten yüklü olan yükleyiciyi kullanır. Standart kullanıcılara uygun izinler verildiyse yükleyiciyi kullanarak program aracılığıyla modify komutunu yürütebilir, ancak veya --quiet
anahtarını kullanmalarına --passive
izin verilmez. Yükleyiciyi, yükleyicinin bulunduğu dizinden program aracılığıyla başlatamazsınız.
"C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--removeOos true ^
--passive
Ürün her güncelleştirildiğinde destek dışı duruma geçirilmiş tüm bileşenleri kalıcı olarak kaldırmak için güncelleştirme ayarlarını yapın:
"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
--path kullanma
Bu örneklerin tümü, önyükleyici kullanarak yeni bir ürün yüklediğinizi varsayar.
Yükleme, önbellek ve paylaşılan yolları kullanın:
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"
Yalnızca yükleme ve önbellek yollarını kullanın:
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"
Yalnızca yükleme ve paylaşılan yolları kullanın:
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"
Yalnızca yükleme yolunu kullanın:
vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"
Dışarı aktarmayı kullanma
Bir yüklemeden seçimi kaydetmek için dışarı aktarmayı kullanın. Bu örnek, istemci makinesinde zaten yüklü olan yükleyiciyi kullanır.
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"
Özel seçimi sıfırdan kaydetmek için dışarı aktarmayı kullanın. Bu örnek, istemci makinesinde zaten yüklü olan yükleyiciyi kullanır.
"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"
--config kullanma
Daha önce kaydedilmiş bir yükleme yapılandırma dosyasından iş yüklerini ve bileşenleri yüklemek için --config kullanın:
vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
Var olan bir yüklemeye iş yükleri ve bileşenler eklemek için --config kullanın. Bu örnek, istemci makinesinde zaten yüklü olan yükleyiciyi kullanır. Uygun izinlere sahip standart kullanıcılar yükleyiciyi kullanarak program aracılığıyla modify komutunu yürütebilir, ancak veya
--quiet
anahtarını kullanmalarına--passive
izin verilmez. Yükleyiciyi, yükleyicinin bulunduğu dizinden program aracılığıyla başlatamazsınız."C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"
Düzenin içeriğini yapılandırmak için --config kullanın:
vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig"
Winget kullanma
Visual Studio'yu winget tarafından yönetilen diğer paketlerin yanı sıra makinelerinize program aracılığıyla yüklemek veya güncelleştirmek için Windows Paket Yöneticisi "winget" aracını kullanın. Yüklemeyi özelleştirmek ve diğer iş yüklerini ve bileşenleri belirtmek için winget'in --override
anahtarını winget install
komutunun yanı sıra kullanabilir ve aşağıdaki gibi dışarı aktarılan bir vsconfig dosyası geçirebilirsiniz:
winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config C:\my.vsconfig"
Ayrıca, var olan bir Visual Studio yüklemesini değiştirmek için bir .yaml
dosyayı kullanabilir winget configure
ve geçirebilirsiniz. Bu yaklaşım, burada belgelenen Visual Studio PowerShell DSC sağlayıcısını kullanır.
Destek veya sorun giderme
Bazen işler ters gidebilir. Visual Studio yüklemeniz başarısız olursa, adım adım yönergeler için bkz . Visual Studio yükleme ve yükseltme sorunlarını giderme.
İşte birkaç destek seçeneği daha:
- Yüklemeyle ilgili sorunlar için bir yükleme sohbeti (yalnızca İngilizce) destek seçeneği sunuyoruz.
- Hem Visual Studio Yükleyicisi hem de Visual Studio IDE'de görünen Sorun Bildir aracı aracılığıyla ürün sorunlarını bize bildirin. BT Yönetici uzmanıysanız ve Visual Studio yüklü değilse, BT'yi geri bildirim Yönetici buradan gönderebilirsiniz.
- Visual Studio Geliştirici Topluluğu bir özellik önerin, ürün sorunlarını izleyin ve yanıtlar bulun.