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.exevs_professional.exeve 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

--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-Processkullanı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ından Start-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:

--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 --layoutkullanamazsı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.