Visual Studio yüklemesi için komut satırı parametre örnekleri

visual studio yüklemek için komut satırı parametrelerinin nasılkullanı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.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 ^ karakterini kullanabilirsiniz. Alternatif olarak, bu satırları tek bir satıra yerleştirebilirsiniz. PowerShell'de eşdeğer, backtick (`) karakteridir.

Komutları etkileşimli olmayan bir şekilde yürütmek için--passive veya --quietkullanabilirsiniz. Bu parametreler hakkında daha fazla bilgi için komutlar ve komut satırı parametreleri sayfasına bakın.

Komut satırını kullanarak yükleyebileceğiniz iş yüklerinin ve bileşenlerin listeleri için visual studio iş yükü ve bileşen kimlikleri sayfasına bakın.

Önyükleyicinin yanında --installPath ve --add 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ştirmek

• 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, yerleşim düzeninde sürekli güncellenen bir önyükleyici kullanarak istemciyi güncelleştirmenin simülasyonunu 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. 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"
  

  Standart kullanıcılarauygun izinler verildiyse yükleyiciyi kullanarak program aracılığıyla güncelleştirme komutunu yürütebilir, ancak --passive veya --quiet anahtarını kullanmalarına izin verilmez.

--wait kullanımı

• Sonraki komut yürütülmeden önce ilk komutun tamamlanmasını beklemek için toplu iş dosyalarında veya betiklerde --wait kullanın. Toplu iş dosyaları için %ERRORLEVEL% ortam değişkeni, Visual Studio yüklemek için komut satırı parametrelerini kullanma belgelendiği gibi 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, --waitPowerShell betik komutuyla Start-Process kullanma ö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()
  

• İlk --wait Visual Studio önyükleyicisi tarafından, ikinci -Wait ise tamamlanmasını beklemek için 'Start-Process' tarafından kullanılır. -PassThru parametresi, Start-Process tarafından yükleyicinin çıkış kodunu dönüş değeri olarak kullanmak için 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. Visual Studio'nun ağ yüklemesi oluşturma sayfasında daha fazla düzen oluşturma örneği 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 kullanmak

• Visual Studio Community sürümü zaten yüklü olan ve Node.js geliştirme desteğine sahip bir makineye takma ad kullanarak ikinci bir Visual Studio Professional örneği 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ırabilirsiniz. --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	--kanal Kimliği
Visual Studio 2026 Kararlı kanal	https://aka.ms/vs/stable/channel	VisualStudio.18.Stable
Visual Studio 2026 Insider kanalı	https://aka.ms/vs/insiders/channel	VisualStudio.18.Insiders
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ığı başka bir şey)

Güncelleştirme kanalı olarak özel bir düzen kullanmayı seçerseniz aşağıdaki yönergeleri dikkate alın:

• --channelUri, özel düzendeki 'channelmanifest.json' dosyasına işaret etmelidir.
• Yöneticiler, 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 kullanarak

• 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 değiştirme komutunu yürütebilir, ancak --passive veya --quiet anahtarını kullanmalarına 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\18\Enterprise" ^
 --remove Microsoft.VisualStudio.Component.DiagnosticTools ^
 --passive

--removeile aynı komutta --layout kullanamazsınız. Başka bir deyişle, bir düzenden bileşenleri kaldırmak mümkün değildir.

'--removeOos’u kullanma

en son yükleyiciyi kullanarak, bir yüklemeyi değiştirebilir ve varsayılan yüklü Visual Studio örneğinden destek dışı durum geçiş yapmış tüm bileşenlerini 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ılarauygun izinler verildiyse yükleyiciyi kullanarak program aracılığıyla modify komutunu yürütebilir, ancak --passive veya --quiet anahtarını kullanmalarına 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\18\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/stable.18.0/channel ^
  --productID Microsoft.VisualStudio.Product.Enterprise ^
  --newChannelURI \\layoutserver\share\path\channelmanifest.json ^
  --removeOos true ^
  --quiet  
  

--path kullanımı

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"

Veri dışa 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.18.Stable --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"

--config kullanarak

• 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 değiştirme komutunu yürütebilir, ancak --passive veya --quiet anahtarını kullanmalarına 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 kullanımı

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'in install komutuyla birlikte kullanabilir ve aşağıdaki gibi dışarı aktarılan vsconfig dosyasını geçirebilirsiniz:

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

Ayrıca winget configure kullanabilir ve var olan bir Visual Studio yüklemesini değiştirmek için bir .yaml dosyası geçirebilirsiniz. Bu yaklaşım, burada belgelenenVisual Studio PowerShell DSC sağlayıcısı 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 yükleme sohbeti (yalnızca İngilizce) destek seçeneğini kullanın.
• Hem Visual Studio Yükleyicisi'nde hem de Visual Studio IDE'de görünen Sorun Bildir aracını kullanarak ürün sorunlarını bize bildirin. BT Yöneticisiyseniz ve Visual Studio yüklü değilse, BT Yöneticisi geri bildirimi gönderebilirsiniz.
• Visual Studio Geliştirici Topluluğu içinde bir özellik önerin, ürün sorunlarını izleyin ve yanıtlar bulun.

İlgili içerik

• Visual Studio Yönetici Kılavuzu
• Visual Studio yüklemek için komut satırı parametrelerini kullanma
• Visual Studio ağ yüklemesi oluşturma
• Visual Studio iş yükü ve bileşen kimlikleri