Visual Studio'yu yüklemek, güncelleştirmek ve yönetmek için komut satırı parametrelerini kullanma

Visual Studio'yu program aracılığıyla veya komut isteminden yüklediğinizde, aşağıdaki eylemleri gerçekleştirmek üzere yüklemeyi denetlemek veya özelleştirmek için çeşitli komut satırı parametreleri kullanabilirsiniz:

• Belirli seçenekler ve davranışlar önceden seçilmiş olarak istemcide yüklemeyi başlatın.
• Yükleme veya güncelleştirme işlemini otomatikleştirin.
• İstemci makinelerini yüklemek veya güncelleştirmek için ürün dosyalarının ağ düzenini oluşturun veya koruyun.

Aşağıdaki komut satırı fiilleri ve parametreleri aşağıdaki yürütülebilir dosya veya programlarla kullanılabilir:

• İndirme işlemini ve ilk yüklemeyi başlatan küçük (yaklaşık 1 MB) dosya (örneğin, vs_enterprise.exe) olan kurulum önyükleyicisi.
• Makinede zaten yüklü olan ve klasöründe C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exebulunan Visual Studio yükleyicisi. Yükleyiciyi, yükleyicinin bulunduğu farklı bir dizinden program aracılığıyla başlatmanız gerekir. Yükleyici genellikle güncelleştirme veya değiştirme komutları için kullanılır.
• Winget'in --override seçeneğini kullanan bir winget komutuyla.
• Ağ düzeninizi program aracılığıyla güncelleştirmek için Microsoft Update Kataloğu'ndan indirilebilen bir Yönetici Güncelleştirme paketiyle. Daha fazla bilgi için Bkz. Düzeninizi güncelleştirme veya değiştirme makalesi.

Tüm komutlar veya parametreler bu durumların her birinde çalışmaz ve özel uyarılar veya istisnalar belgelenmiştir. Ayrıca, bazı senaryolarda daha önce açıklanan bu yürütülebilir dosyalara erişiminiz olmayabilir. Örneğin, istemci makinelerinde yükleyici, yalnızca Visual Studio bir yerleşim düzeni aracılığıyla yüklendiyse programlı yürütme için kullanılabilir olabilir.

Her zaman Geçerli kanalın en son sürümünü yükleyen Visual Studio 2026 için en son önyükleyicileri almak için aşağıdaki tabloda yer alan dosyalardan birini indirin. Alternatif olarak, visual studio 2026'nın belirli bir sürümünü veya belirli bir kanalını yüklemek için Visual Studio 2026 Yayın Geçmişi sayfasına bakın. Bu sayfada, her bakım sürümü için sabit sürüm önyükleyicilerine bağlantılar bulunur.

Baskı	Önyükleyici
Visual Studio 2026 Enterprise	vs_enterprise.exe
Visual Studio 2026 Professional	vs_professional.exe
Visual Studio 2026 Topluluğu	vs_community.exe
Visual Studio 2026 Derleme Araçları	vs_buildtools.exe

Tip

Daha önce bir önyükleyici dosyası indirdiyseniz ve hangi sürümün yükleneceğini doğrulamak istiyorsanız, bunu şu şekilde yapabilirsiniz. Windows'ta Dosya Gezgini'ni açın, önyükleyici dosyasına sağ tıklayın, Özellikler'i ve ardından Ayrıntılar sekmesini seçin. Ürün sürümü alanında önyükleyicinin yükleyeceği kanal ve sürüm açıklanır. Sürüm numarası her zaman "belirtilenin en son hizmet sürümü" olarak okunmalıdır ve açıkça belirtilmediği sürece kanal Güncel olmalıdır. Bu nedenle, Kararlı 18.0 Ürün sürümüne sahip bir önyükleyici, 18.0 Kararlı kanalında kullanılabilen en son 18.0.x bakım sürümünü yükler. Yalnızca "Visual Studio 2026" şeklinde bir ürün sürümüne sahip olan bir önyükleyici, Kararlı sürümdeki en son Visual Studio 2026 sürümünü yükleyecektir.

Komutları ve komut satırı parametrelerini Yükleme, Güncelleştirme, Değiştirme, Onarma, Kaldırma ve Dışarı Aktarma

Ürünü yüklemek veya düzeni korumak için Visual Studio önyükleyicisini veya yükleyiciyi program aracılığıyla çağırırken:

• İlk parametre, gerçekleştirilecek işlemi açıklayan komutudur (fiil).
• Tümü iki tire (--) ön ekine sahip sonraki isteğe bağlı komut satırı parametreleri, bu işlemin nasıl gerçekleşmesi gerektiğini daha ayrıntılı olarak tanımlar.

Tüm Visual Studio komut satırı parametreleri büyük/küçük harfe duyarlı değildir ve Komut satırı parametre örnekleri sayfasında daha fazla örnek bulunabilir.

Söz dizimi örneği: vs_enterprise.exe [command] <optional parameters>...

Command	Açıklama
(boş)	Varsayılan komut hem ürünü yükler hem de tüm düzen bakım işlemleri için kullanılır.
modify	Yüklü bir ürünü değiştirir.
update	Yüklü bir ürünü güncelleştirir.
updateall	Yüklü tüm ürünleri sıralı olarak güncelleştirir. --quiet ve --passive parametreleriyle çalışır.
repair	Yüklü bir ürünü onarıyor.
uninstall	Yüklü bir ürünü kaldırır.
export	Yükleme yapılandırmasını bir *.vsconfig dosyaya aktarır.

Önemli

Birden çok farklı iş yükü, bileşen veya dil belirtirken, her öğe için --add veya --remove komut satırı anahtarını yinelemeniz gerekir.

Parametreler	Açıklama
--installPath <dir>	Varsayılan yükleme komutu için bu parametre İsteğe bağlıdır ve örneğin istemci makinesinde nereye yüklendiğini açıklar. Güncelleştirme veya değiştirme gibi diğer komutlar için bu parametre Gerekli'dir ve örneğin üzerinde işlem görmesi için yükleme dizinini belirtir.
--productId <id>	İsteğe bağlı: değiştirilen ve ile --channelIdkullanılan ürün örneğinin kimliği. , productID "Microsoft.VisualStudio.Product.Enterprise" gibi bir şeydir.
--channelUri	İsteğe bağlı: Güncelleştirme komutu sırasında, güncelleştirme ayarları konumunu değiştirmek için yeni --channelUri bir ileti iletebilirsiniz. Hangi Visual Studio örneğini yapılandırdığınızın açıkça belirtilmesi için parametresiyle --installPath eşleştirmenizi öneririz. Bkz. söz dizimi örnekleri --channelUri
--channelId <id>	Kanalın kimliği, örneğin, VisualStudio.17.Release. Bkz. söz dizimi örnekleri.--channelId channelId değiştirme işlemleri için, --productID veya --installPath yanında gereklidir.
--add <one or more workload or component IDs>	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında, bu yinelenebilir parametre eklenecek bir veya daha fazla iş yükü veya bileşen kimliği belirtir. Yapıtın gerekli bileşenleri yüklenir, ancak önerilen veya isteğe bağlı bileşenler yüklenmez. --includeRecommended ve/veya --includeOptional parametrelerini kullanarak diğer bileşenleri genel olarak denetleyebilirsiniz. Birden çok iş yükü veya bileşen eklemek için komutunu yineleyin --add (örneğin, --add Workload1 --add Workload2). Daha ayrıntılı denetim için, kimliğin sonuna ;includeRecommended veya ;includeOptional ekleyebilirsiniz (örneğin, --add Workload1;includeRecommended veya --add Workload2;includeRecommended;includeOptional). Daha fazla bilgi için İş yükü ve bileşen kimlikleri sayfasına bakın.
--all	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu parametre, ürünün tüm iş yüklerinin ve bileşenlerinin yüklenmesine neden olur.
--allWorkloads	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu parametre tüm iş yüklerini ve bileşenleri yükler, ancak önerilen veya isteğe bağlı bileşen yoktur.
--includeRecommended	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında, bu parametre yüklü tüm iş yükleri için önerilen bileşenleri içerir. İsteğe bağlı bileşenleri içermez. İş yükleri, ya --allWorkloads ya da --add ile belirtilir. Lütfen --includeRecommended parametresini kullanarak, Güncelleştirme Ayarları iletişim kutusunu, yüklü iş yükleri için önerilen bileşenlerin güncelleme sırasında eklenmesini sağlayacak şekilde ayarlayacaksınız. Bu ayarı değiştirmek için bkz . Güncelleştirme ayarlarını özelleştirme.
--includeOptional	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında, bu parametre yüklü tüm iş yükleri için isteğe bağlı bileşenleri içerir. Önerilen bileşenleri içermez. İş yükleri, ya --allWorkloads ya da --add ile belirtilir.
--addProductLang <language-locale>	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu yinelenebilir parametre, ürünle birlikte yüklenmesi gereken kullanıcı arabirimi dil paketlerini belirtir. Yoksa, kurulum, bilgisayarın yerel ayarına karşılık gelen dil paketini kullanır. Daha fazla bilgi için bkz. [Dil yerel ayarları listesi]
--remove <one or more workload or component IDs>	İsteğe bağlı: Değiştirme komutu sırasında, bu yinelenebilir parametre kaldırılacak bir veya daha fazla iş yükü veya bileşen kimliği belirtir. --add parametresini tamamlar ve ona benzer şekilde davranır.
--removeProductLang <language-locale>	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu yinelenebilir parametre, üründen kaldırılması gereken kullanıcı arabirimi dil paketlerini belirler. --addProductLang parametresini tamamlar ve ona benzer şekilde davranır. Daha fazla bilgi için bu sayfadaki Dil yerel ayarları listesi bölümüne bakın.
--in <path>	İsteğe bağlı: Yapılandırma ayarlarını içerebilen URI veya yanıt dosyasının yolu.
--quiet	İsteğe bağlı: Herhangi bir komutla kullanıldığında, bu parametre komut yürütülürken herhangi bir kullanıcı arabiriminin görüntülenmesini engeller. AllowStandardUserControl ilkesinin nasıl ayarlandığından bağımsız olarak standart kullanıcıların programatik olarak kullanılamaz.
--passive, -p	İsteğe bağlı: Bu parametre, kullanıcı arabiriminin etkileşimli olmayan bir şekilde görüntülenmesine neden olur. Bu parametre, --quiet parametresi ile karşılıklı olarak birbirini dışlar (ve aslında onu geçersiz kılar). Ayrıca AllowStandardUserControl ilkesinin nasıl ayarlandıklarından bağımsız olarak standart kullanıcılar tarafından program aracılığıyla kullanılamaz.
--norestart	İsteğe bağlı: Bu parametre veya --passive parametreleriyle --quiet eşlenmelidir. Yükleme, güncelleştirme veya değiştirme komutu sırasında parametresinin --norestart eklenmesi gerekli tüm yeniden başlatmaları geciktirmektedir.
--force	İsteğe bağlı: Bu parametre, herhangi bir Visual Studio işlemi kullanılıyor olsa bile Visual Studio'yu kapanmaya zorlar. Visual Studio'yu kapanmaya zorlamak iş kaybına neden olabilir, bu nedenle dikkatli kullanın.
--installWhileDownloading	İsteğe bağlı: Yükleme, güncelleştirme veya değiştirme komutu sırasında, bu parametre Visual Studio'nın ürünü paralel olarak indirmesine ve yüklemesine olanak tanır. Bu varsayılan deneyimdir.
--downloadThenInstall	İsteğe bağlı: Yükleme, güncelleştirme veya değiştirme komutu sırasında, bu parametre Visual Studio'yu yüklemeden önce tüm dosyaları indirmeye zorlar. Bu, --installWhileDownloading parametresiyle birbirini dışlar.
--nickname <name>	İsteğe bağlı: Yükleme komutu sırasında, bu parametre yüklü bir ürüne atanacak takma adı tanımlar. Takma ad 10 karakterden uzun olamaz.
--productKey	İsteğe bağlı: Yükleme komutu sırasında bu parametre, yüklü bir ürün için kullanılacak ürün anahtarını tanımlar. Ürün anahtarı biçiminde xxxxxxxxxxxxxxxxxxxxxxxxx25 alfasayısal karakterden oluşur.
--removeOos true	İsteğe bağlı: Yükleme, güncelleştirme veya değiştirme komutu sırasında, bu parametre ve ardından true veya falsekomutu, Visual Studio Yükleyicisi destek dışı duruma geçirilmiş tüm yüklü bileşenlerin kaldırılıp kaldırılmayacağını bildirir. Bu davranış tek bir olay için geçerlidir. Bu davranışı kalıcı hale getirmek istiyorsanız, bu parametreyi daha sonra açıklanan modifySettings komutuna uygulayın veya removeOOS genel ilkesini yapılandırın. Makinenin güvenli kalmasına yardımcı olmak için kullanışlıdır.
--config <path to *.vsconfig file>	İsteğe bağlı: Yükleme veya değiştirme işlemi sırasında, önceden kaydedilmiş bir yükleme yapılandırma dosyasına göre eklenecek iş yüklerini, bileşenleri veya uzantıları belirtmek için parametresini kullanarak --config bir yapılandırma dosyası geçirebilirsiniz. Bu işlem yalnızca ek bir işlemdir; dosyada belirtilmeyen hiçbir şeyi kaldırmaz. Ayrıca, yapılandırma dosyasında belirtilen ve ürün için geçerli olmayan öğeler eklenmez. Yapılandırma dosyasının tam yolunu belirtmeniz kesinlikle önerilir. Dışarı aktarma işlemi sırasında bu parametre yükleme yapılandırma dosyasının kaydedileceği konumu belirler.
--allowUnsignedExtensions	İsteğe bağlı: Yükleme veya değiştirme işlemi sırasında dosya kullanılarak --passive veya --quiet bağlamında çalıştırılırken--config, yapılandırma dosyasında uzantılar belirtilirse, uzantıları dijital imza olmadan yüklemek için bu parametre gereklidir.
--installerOnly	İsteğe bağlı: Yükleme veya güncelleştirme işlemi sırasında, bu parametre Visual Studio Yükleyicisi'ne Visual Studio ürününü değil yalnızca kendisini (yükleyici) yüklemesini söyler. İşlevselliği parametresine --update eşdeğerdir, ancak daha sezgiseldir. İstemci makinelerini hazırlarken ve önceden yapılandırırken kullanılması amaçlanmalıdır.
--help, --?, -h, -?	Bu sayfanın çevrimdışı sürümünü görüntüler.

Düzen komutu ve komut satırı parametreleri

Düzen oluşturma veya güncelleştirme gibi tüm düzen yönetimi işlemleri önyükleyici exe kullanılarak çalıştırılır ve komutun varsayılan Yükleme (boş) olduğunu varsayar. Tüm düzen yönetimi işlemleri gerekli --layout ilk parametreyle başlamalıdır. Aşağıdaki tabloda, komut satırını kullanarak düzen oluşturmak veya güncelleştirmek için kullanabileceğiniz diğer parametreler açıklanmaktadır.

Düzen parametreleri	Açıklama
--layout <dir>	Çevrimdışı yükleme önbelleği oluşturulacak veya güncelleştirilecek bir dizin belirtir. Daha fazla bilgi için bkz. Visual Studio'nun ağ tabanlı yüklemesini oluşturma.
--lang <one or more language-locales>	İsteğe bağlı: Belirtilen bir veya daha fazla belirtilen dile sahip kaynak paketleriyle çevrimdışı yükleme önbelleği hazırlamak için ile --layout kullanılır. Daha fazla bilgi için bu sayfadaki Dil yerel ayarları listesi bölümüne bakın.
--add <one or more workload or component IDs>	İsteğe bağlı: Eklenecek bir veya daha fazla iş yükü veya bileşen kimlikleri. Yapıtın gerekli bileşenleri yüklenir, ancak önerilen veya isteğe bağlı bileşenler yüklenmez. --includeRecommended ve/veya --includeOptional kullanarak genel olarak daha fazla bileşeni kontrol edebilirsiniz. Daha ayrıntılı denetim için, kimliğin sonuna ;includeRecommended veya ;includeOptional ekleyebilirsiniz (örneğin, --add Workload1;includeRecommended veya --add Workload2;includeOptional). Daha fazla bilgi için İş yükü ve bileşen kimlikleri sayfasına bakın. Not: Kullanılırsa --add , yalnızca belirtilen iş yükleri ve bileşenleri ve bağımlılıkları indirilir. Belirtilmezse --add , tüm iş yükleri ve bileşenler düzene indirilir.
--includeRecommended	İsteğe bağlı: Yüklenen tüm iş yükleri için önerilen bileşenleri içerir, ancak isteğe bağlı bileşenleri içermez. İş yükleri, ya --allWorkloads ya da --add ile belirtilir.
--includeOptional	İsteğe bağlı: Düzene dahil edilen tüm iş yükleri için önerilen ve isteğe bağlı bileşenleri içerir. İş yükleri --add ile belirtilmiştir.
--wait	İsteğe bağlı: İşlem, bir çıkış kodu döndürmeden önce yükleme tamamlanana kadar bekler. wait yüklemelerini otomatikleştirirken, yüklemenin tamamlanmasını beklemek ve dönüş kodunu işlemek gerektiğinde kullanışlıdır. --wait Parametre yalnızca önyükleyiciye geçirilebilir; yükleyici (setup.exe) bunu desteklemez. Düzenleri güncelleştirirken kullanışlıdır. Burada daha fazla örnek bulabilirsiniz.
--useLatestInstaller	İsteğe bağlı: Yalnızca Nisan 2023'ten eski Visual Studio önyükleyicileri için geçerli olan eski işlevler. Nisan 2023'e kadar gönderilen her şey varsayılan olarak en son yükleyiciyi kullanır. Bu parametre varsa, visual studio yükleyicisinin en son sürümü, ürünün daha yeni bir ana sürümüne ait olsa bile düzeninize eklenir. En son sürümde bulunan yeni özelliklerden veya hata düzeltmelerinden yararlanmak istiyorsanız en son yükleyici yararlı olabilir. Daha fazla bilgi için her zaman en son yükleyici belgelerini kullanacak şekilde düzeni yapılandırma belgelerine bakın.
--config <path to *.vsconfig file>	İsteğe bağlı: Varsa, Visual Studio düzeninizi yapılandırmak için yapılandırma dosyasının içeriğini kullanır. Yapılandırma dosyasının tam yolunu belirttiğinizden emin olun.
--noWeb	İsteğe bağlı: Varsa, Visual Studio kurulumu Visual Studio'yu yüklemek için düzen dizininizdeki dosyaları kullanır ve web'den herhangi bir paket indirmez. Kullanıcı düzende olmayan bileşenleri yüklemeye çalışırsa kurulum başarısız olur. İç intranet web sitesinde barındırılan bir düzeni dağıtmaya çalışıyorsanız bu parametreyi kullanmayın. Daha fazla bilgi için bkz . İnternet erişimi olmayan bir istemciye yükleme. Önemli: --noWeb parametresi, internete bağlı bir istemci makinedeki Visual Studio Yükleyicisi'nin, güncellemeler için istemcinin Microsoft barındırılan sunucularına bakacak şekilde yapılandırılmışsa, güncellemeleri kontrol etmesini durdurmaz. Bu durumda, --noWeb istemcinin ürün paketlerini indirmesini engellemeniz yeterlidir.
--verify	İsteğe bağlı: Düzenin içeriğini doğrulayın. Bozuk veya eksik dosyalar listelenir.
--fix	İsteğe bağlı: Düzenin içeriğini doğrulayın. Bozuk veya eksik dosyalar yeniden yüklenir. Düzeni düzeltmek için İnternet erişimi gereklidir.
--clean <one or more paths to catalogs>	İsteğe bağlı: Bileşenlerin eski sürümlerini, daha yeni bir sürüme güncelleştirilmiş bir düzenden kaldırır.

Gelişmiş düzen parametreleri	Açıklama
--channelId <id>	İsteğe bağlı: Yüklenecek örneğin kanal kimliği VisualStudio.17.Release şeklinde temsil edilir. install komutunda channelId gereklidir ve --installPath belirtilirse diğer komutlar için yok sayılır. --channelId söz dizimi örneklerine bakın.
--channelUri <uri>	İsteğe bağlı: Kanal bildiriminin URI'si. Bu değer güncelleştirmelerin kaynak konumunu yönetir ve ilk değer düzenin response.json dosyasında yapılandırılır. Olası değerler için --channelUri söz dizimi örneklerine bakın. Güncelleştirmeler istenmiyorsa, --channelUri varolmayan bir dosyaya işaret edebilir (örneğin, --channelUri C:\doesntExist.chman). Bu parametre yükleme komutu için kullanılabilir; diğer komutlar bunu yoksayar.
--installChannelUri <uri>	İsteğe bağlı: Yükleme için kullanılacak kanal bildiriminin URI'si. Güncellemeleri algılamak için, --channelUri belirtildiğinde belirtilmesi gereken URI olan --installChannelUri kullanılır. Bu parametre yükleme komutu için kullanılabilir; diğer komutlar bunu yoksayar.
--installCatalogUri <uri>	İsteğe bağlı: Yükleme için kullanılacak katalog bildiriminin URI'si. Belirtilirse, kanal yöneticisi yükleme kanalı bildiriminde URI'yi kullanmadan önce bu URI'den katalog bildirimini indirmeyi dener. Bu parametre, düzen önbelleğinin önceden indirilmiş ürün kataloğuyla oluşturulduğu çevrimdışı yüklemeyi desteklemek için kullanılır. Bu parametre yükleme komutu için kullanılabilir; diğer komutlar bunu yoksayar.
--productId <id>	İsteğe bağlı: Yüklenen örneğin ürünün kimliği. Bu parametre normal yükleme koşullarında önceden doldurulur. , productID "Microsoft.VisualStudio.Product.Enterprise" gibi bir şeydir.
--arch all	İsteğe bağlı: Düzenler varsayılan olarak yalnızca x64 ürün ikili dosyalarıyla oluşturulur. Geçerli iş yükleri için ARM ikili dosyalarını, bir düzendeki x64 ikili dosyalarının yanı sıra eklemek için --arch all ve --arch * parametrelerini kullanın. Yalnızca ARM binär dosyalarının düzenini oluşturmak için --arch arm64 kullanın.
--keepLayoutVersion	İsteğe bağlı: Düzende bulunan ürün sürümünü güncelleştirmeden düzende değişiklikleri uygulayın.
--locale <language-locale>	İsteğe bağlı: Yükleyicinin kendisi için kullanıcı arabiriminin görüntüleme dilini değiştirin. Ayar kalıcı hale gelecek. Daha fazla bilgi için bu sayfadaki Dil yerel ayarları listesi bölümüne bakın.
--cache	İsteğe bağlı: Varsa, paketler sonraki onarımlar için yüklendikten sonra saklanır. Bu, sonraki yüklemeler, onarımlar veya değişiklikler için kullanılacak genel ilke ayarını geçersiz kılar. Varsayılan ilke paketleri önbelleğe almaktır. Kaldırma komutu için bu yoksayılır. Daha fazla bilgi için paket önbelleğini devre dışı bırakma veya taşıma hakkında bilgi edinin.
--nocache	İsteğe bağlı: Varsa paketler yüklendikten veya onarıldıktan sonra silinir. Bunlar yalnızca gerektiğinde yeniden indirilir ve kullanımdan sonra yeniden silinir. Bu, sonraki yüklemeler, onarımlar veya değişiklikler için kullanılacak genel ilke ayarını geçersiz kılar. Varsayılan ilke paketleri önbelleğe almaktır. Kaldırma komutu için bu yoksayılır. Daha fazla bilgi için paket önbelleğini devre dışı bırakma veya taşıma hakkında bilgi edinin.
--noUpdateInstaller	İsteğe bağlı: Varsa, yükleyici sessiz modu seçildiğinde kendisini güncelleştiremez. Yükleyici güncelleştirmesi gerektiğinde noUpdateInstaller sessiz olarak belirtilirse, yükleyici komutu başarısız olur ve sıfır olmayan bir çıkış kodu döndürür.
--path <name>=<path>	İsteğe bağlı: Yükleme için özel yükleme yollarını belirtmek için kullanılır. Desteklenen yol adları paylaşılır, önbelleğe alınır ve yüklenir.
--path cache=<path>	İsteğe bağlı: Yükleme dosyalarını indirmek için belirttiğiniz konumu kullanır. Bu konum yalnızca Visual Studio ilk kez yüklendiğinde ayarlanabilir. Örnek: --path cache="C:\VS\cache"
--path shared=<path>	İsteğe bağlı: Yan yana Visual Studio yüklemeleri için paylaşılan dosyaları içerir. Bazı araçlar ve SDK'lar bu sürücüdeki bir konuma yüklenirken, bazıları bu ayarı geçersiz kılıp başka bir sürücüye yükleyebilir. Örnek: --path shared="C:\VS\shared" Önemli: Bu yalnızca bir kez ve Visual Studio ilk kez yüklendiğinde ayarlanabilir.
--path install=<path>	İsteğe bağlı: ile eşdeğerdir –-installPath. Özellikle --installPath "C:\VS" ve --path install="C:\VS" eşdeğerdir. Aynı anda bu komutlardan yalnızca biri kullanılabilir.

ModifySettings komutu ve komut satırı parametreleri

İstemci makinesindeki yükleyiciyi veya önyükleyiciyi kullanarak ve modifySettings komutunu ve istenen güncelleştirme kanalını geçirerek güncelleştirme ayarlarını değiştirebilir ve belirli bir Visual Studio örneğinin güncelleştirmelerinin kaynak konumunu program aracılığıyla yapılandırabilirsiniz.

Command	Açıklama
modifySettings	Visual Studio'nun belirli bir örneğinin güncelleştirme ayarlarını değiştirmek için kullanılan fiil.

modifySettings parametreleri	Açıklama
--installPath <dir>	Hangi Visual Studio örneğinin üzerinde işlem gerçekleştirileceğini belirtmek için kullanılması önerilir.
--newChannelUri	Gerekli: Kanal bildiriminin URI'si. Bu değer, güncelleştirmelerin bir sonraki kaynak konumunun nerede olacağını belirtir. Olası değerler için --channelUri söz dizimi örneklerine bakın. Güncelleştirmeler istenmiyorsa, --channelUri varolmayan bir dosyaya işaret edebilir (örneğin, --channelUri C:\doesntExist.chman).
--channelUri	Eski kanal bildiriminin URI'sini. --installPath bilinmiyorsa kullanılabilir. Üzerinde işlem yapılacak doğru örneği tanımlamak için productID ile birlikte kullanılmalıdır.
--productId <id>	--channelUri belirtilirse ve üzerinde işlem yapılacak doğru örneği tanımlamak için kullanılırsa kullanılmalıdır. , productID "Microsoft.VisualStudio.Product.Enterprise" gibi bir şeydir.
--includeRecommended	İsteğe bağlı: ModifySettings komutu sırasında, bu parametre (bundan hemen sonra true veya false sözcüğü olmalıdır) Visual Studio yükleyicisine Güncelleştirme Ayarı iletişim kutusunda "güncelleştirme sırasında yüklü iş yükleri için önerilen bileşenleri ekleme" işlevini devre dışı bırakmasını söyler.
--quiet	İsteğe bağlı: Bu parametre, komut yürütülürken herhangi bir kullanıcı arabiriminin görüntülenmesini engeller. Standart kullanıcılar tarafından programatik olarak kullanılamaz.
--removeOos true	İsteğe bağlı: ModifySettings komutu sırasında, bu parametre (hemen sonra true veya false sözcüğüne sahip olmalıdır) Visual Studio yükleyicisine destek dışı duruma geçirilmiş tüm yüklü bileşenleri kalıcı olarak kaldırmasını (veya kaldırmaması) söyler. Makinenin güvenli kalmasına yardımcı olmak için kullanışlıdır.

Söz dizimi örnekleri:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft Visual Studio\18\Enterprise" --newChannelUri https://aka.ms/vs/stable.18.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/stable.18.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Geri alma komutu ve komut satırı parametreleri

Visual Studio 2022'den başlayarak, istemci makinesindeki yükleyiciyi kullanarak ve yükleme yolu örneğinin yanında geri alma komutunu geçirerek bir güncelleştirmeyi program aracılığıyla geri alabilirsiniz.

Command	Açıklama
rollback	Visual Studio'nun belirli bir örneğini önceden yüklenmiş güncelleştirmeye geri alma komutu. DisableRollback etkinse, bu komut çalışmaz.

geri alma parametreleri	Açıklama
--installPath <dir>	Hangi Visual Studio örneğinin üzerinde işlem gerçekleştirileceğini belirtmek için kullanılması önerilir.

Söz dizimi örnekleri:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\18\Enterprise"

Yönetici Güncelleştirmesi komutu ve komut satırı parametreleri

Microsoft Update Kataloğu'ndan bir Yönetici Güncelleştirmesi indirebilir ve istemci yüklemenizi veya düzeninizi güncelleştirmek için kullanabilirsiniz.

Düzeni güncelleştirme

Bir düzeni Visual Studio'nun belirli bir sürümüne güncelleştiriyorsanız, Yönetici Güncelleştirmesi'ni düzeni barındıran bilgisayara indirmeniz, bu bilgisayarda bir komut istemi açmanız ve aşağıdaki gibi bir komut çalıştırmanız gerekir:

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

İstemciyi güncelleştirme

İstemcide, Yönetici Güncelleştirmesi'ni istemci makinenizdeki yükleme dizininize indirirseniz, güncelleştirmeyi uygulamak için dosyaya çift tıklayabilirsiniz. Ayrıca, varsayılan davranışı değiştirmek için bir komut penceresi açabilir ve aşağıdaki parametrelerin bazılarını geçirebilirsiniz.

SCCM'de Yönetici Güncelleştirmesini Yapılandırma

Yönetici güncelleştirmesini Microsoft Endpoint Manager (SCCM) aracılığıyla dağıtıyorsanız, aşağıdaki parametreleri kullanarak davranışı ayarlamak için paketi değiştirebilirsiniz. Ayrıca, parametreleri istemci makinesindeki bir yapılandırma dosyası aracılığıyla da denetleyebilirsiniz. Daha fazla bilgi için bkz. Yönetici güncelleştirmesi yapılandırma yöntemleri

Düzen fiili belirtilmediği sürece tüm Yönetici Güncelleştirme parametrelerinin varsayılan olarak "güncelleştirme" bağlamında çalıştırıldığını unutmayın.

Yönetici güncelleştirme parametreleri	Açıklama
--installerUpdateArgs [optional parameters]	Bu parametre, yönetici güncelleştirme senaryolarıyla ilgili belirli parametrelerin "geçiş dizisi" olarak işlev görür. Bu amaçla etkinleştirilen isteğe bağlı parametreler şunlardır: --quiet: Bu, yönetici güncelleştirmeleri için varsayılan deneyimdir ve tamlık için burada listelenmiştir. --passive: Bu parametre parametresini --quiet geçersiz kılar. Kullanıcı arabiriminin etkileşimli olmayan bir şekilde görünmesine neden olur. --norestart: Bu parametre veya --quiet ile --passive birlikte kullanılmalıdır ve gerekli yeniden başlatmaların gecikmesine neden olur. --noWeb: Bu parametre, Visual Studio'un ürün güncelleştirmeleri için İnternet'te denetlemesini engeller. --force: Bu parametre, Visual Studio kullanımda olsa bile Visual Studio'yu kapanmaya zorlar. İş kaybına neden olabileceğinden bu parametreyi dikkatli kullanın. Bu parametre yalnızca Yönetici güncelleştirmesi kullanıcı bağlamında yürütülürken kullanılmalıdır; Yönetici güncelleştirmesi sistem bağlamında yürütülürse yoksayılır. --installWhileDownloading: Bu parametre, Visual Studio'nın ürünü paralel olarak indirmesine ve yüklemesine olanak tanır. Yönetici güncelleştirmeleri için varsayılan deneyimdir ve tamlık için burada listelenmiştir. --keepWindowsUpdateOn: Bu parametre, yükleyicinin istemcide Windows Update aracısını kapatmasını engeller. Katalog'dan SCCM'ye bir Yönetici güncelleştirmesi aktarıyorsanız bu parametreyi kullanmalısınız. Ayrıca SCCM paketi zaman aşımını varsayılan 10 dakikadan uzun olacak şekilde ayarlamanız gerekebilir. SCCM dağıtım türünün Gerekli olarak değiştirilmesi bu parametreyi gereksiz hale getirir. --downloadThenInstall: Bu parametre, Visual Studio'yu yüklemeden önce tüm dosyaları indirmeye zorlar. Bu, --installWhileDownloading parametresiyle birbirini dışlar.
--checkPendingReboot	Hangi uygulamanın neden olmuş olabileceğinden bağımsız olarak, makinede bekleyen bir yeniden başlatma varsa güncelleştirme durdurulacaktır. Varsayılan ayar bekleyen yeniden başlatmaları denetlememektir.

Parametreleri Yönetici güncelleştirmesi içine geçirmek için söz dizimi örneği:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Kanal komutu ve komut satırı parametrelerini kaldırma

Güncelleştirme için kullanılabilecek kanallar istemcide önbelleğe alınır ve zaman içinde işleri karmaşık hale gelebilir. Visual Studio Yükleyicisi'ni açıp Kullanılabilir sekmesine geçip ürün kartının sağ üst köşesindeki X işaretine tıklayarak güncelleştirme kanallarını el ile kaldırabilirsiniz. Kanalları (örneğin, eski düzen konumları) program aracılığıyla removeChannel komutunu kullanarak kaldırabilirsiniz. İstemci makinesinde hangi kanalların önbelleğe alındığını belirlemek için vswhere'yi istemci makinesinde program aracılığıyla çalıştırabilirsiniz.

Command	Açıklama
removeChannel	İstemci makinesinden bir kanalı kaldırma komutu.

removeChannel parametreleri	Açıklama
--channelUri	Gerekli Eski kanal bildiriminin URI'si.
--quiet	İsteğe bağlı Bu parametre, komut yürütülürken herhangi bir kullanıcı arabiriminin görüntülenmesini engeller.
--passive	İsteğe bağlı Bu parametre parametresini --quiet geçersiz kılar. Kullanıcı arabiriminin etkileşimli olmayan bir şekilde görünmesine neden olur.

Söz dizimi örneği:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Visual Studio'yu yüklemek veya değiştirmek için winget kullanma

Windows Paket Yöneticisi "winget" aracını kullanarak, winget tarafından yönetilen diğer paketlerin yanı sıra makinenize Visual Studio'yu program aracılığıyla yükleyebilir, değiştirebilir veya güncelleştirebilirsiniz.

Varsayılan olarak winget yalnızca Visual Studio çekirdek iş yükünü yükler.

winget install --id Microsoft.VisualStudio.Community

Ancak, yüklemeyi özelleştirmek ve ilk yükleme sırasında edinilmesi gereken ek iş yüklerini ve bileşenleri belirtmek istiyorsanız winget komutunun yanı sıra winget --overrideinstall anahtarını kullanabilir ve eklenecek iş yüklerini ve bileşenleri içeren dışarı aktarılan bir vsconfig dosyasını geçirebilirsiniz:

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

Elbette, bileşenleri doğrudan ilk yükleme sırasında da ekleyebilirsiniz, örneğin:

 winget install --id Microsoft.VisualStudio.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Makinenizde Visual Studio zaten yüklüyse, winget configure komutunuVisual Studio PowerShell DSC sağlayıcısı, yaml dosyası ve .vsconfig dosyasıyla birlikte kullanarak mevcut Visual Studio yüklemesine bileşen ekleyebilirsiniz . Winget'in configure komutu temelde bir Visual Studio "değiştirme" işlemi işlevi görür. Winget yapılandırması oluşturmayı öğrenmek için WinGet Yapılandırma dosyası nasıl oluşturulur, görün.

Winget'in --override komutuyla birlikte anahtarı veya Visual Studio DSC sağlayıcısını kullanmak upgrade mümkün değildir, çünkü upgrade temelde bir Visual Studio "güncelleştirme" işlemi işlevi görür ve zaten seçtiğiniz bileşenlerin en son sürümünü yükler. Güncelleştirme/yükseltme yoluyla bileşen ekleyemezsiniz. Bileşenleri eklemek için winget'leri configure kullanmanız gerekir.

Visual Studio Yükleyicisi işlemlerinin şu anda yönetici ayrıcalıkları gerektirdiğini unutmayın; bu nedenle winget, komutu tamamlamak için gerekirse ayrıcalıklarınızı yükseltmenizi ister. Ayrıca şu anda winget kullanarak istemci makinesine aynı anda birden çok sürümü (farklı SKU'lar) veya aynı SKU'nun birden çok örneğini yüklemek mümkün değildir. Son olarak, bileşenleri eklemek için yapılandıracak (değiştirecek) veya en son sürüme yükseltecekseniz Visual Studio kapatılmalıdır.

İş yükü kimliklerinin ve bileşen kimliklerinin listesi

Visual Studio ürününe göre sıralanmış iş yükü ve bileşen kimliklerinin listesi için Visual Studio iş yükü ve bileşen kimlikleri sayfasına bakın.

Dil yerel ayarları listesi

Dil yerel ayarı	Language
Cs-cz	Çekçe
De-de	Almanca
En-us	İngilizce
Es-es	İspanyolca
Fr-fr	Fransızca
It-it	İtalyanca
Ja-jp	Japonca
Ko-kr	Korece
Pl-pl	Lehçe dili
Pt-br	Portekizce - Brezilya
Ru-ru	Rusça
Tr-tr	Türkçe
Zh-cn	Çince - Basitleştirilmiş
Zh-tw	Çince - Geleneksel

Hata kodları

İşlemin sonucuna bağlı olarak ortam %ERRORLEVEL% değişkeni aşağıdaki değerlerden birine ayarlanır:

Değer	Sonuç
0	İşlem başarıyla tamamlandı
740	Yükseklik artırımı gerekiyor
1001	Visual Studio yükleyici işlemi çalışıyor
1003	Visual Studio kullanımda
1602	İşlem iptal edildi
1618	Başka bir yükleme çalışıyor
1641	İşlem başarıyla tamamlandı ve yeniden başlatma başlatıldı
3010	İşlem başarıyla tamamlandı, ancak yüklemenin kullanılabilmesi için yeniden başlatma gerekiyor
5003	Önyükleyici yükleyiciyi indiremedi
5004	İşlem iptal edildi
5005	Önyükleyici komut satırı ayrıştırma hatası
5007	İşlem engellendi - bilgisayar gereksinimleri karşılamıyor
8001	Arm makinesi kontrol hatası
8002	Arka plan indirme ön denetimi hatası
8003	Desteklenmeyen seçilebilir arıza
8004	Hedef dizin hatası
8005	Kaynak yüklerini doğrulamada başarısızlık
8006	Çalışan Visual Studio işlemleri
8010	İşletim Sistemi desteklenmiyor. Sistem Gereksinimleri'ne bakın
-1073720687	Bağlantı hatası
-1073741510	Microsoft Visual Studio Yükleyicisi sonlandırıldı (kullanıcı veya dış işlem tarafından)
Other (örneğin: -1, 1, 1603 )	Hata durumu oluştu - Daha fazla bilgi için günlükleri denetleyin

Her işlem, dizinde %TEMP% yüklemenin ilerleme durumunu gösteren birkaç günlük dosyası oluşturur. Klasörü tarihe göre sıralayın ve sırasıyla önyükleyici, yükleyici uygulaması ve dd_bootstrapper kurulum altyapısı için , dd_clientve ile dd_setupbaşlayan dosyaları arayın.

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'de bir özellik önerin, ürün sorunlarını takip edin ve yanıtlar bulun.

İlgili içerik

• Visual Studio yüklemesi için komut satırı parametre örnekleri
• Visual Studio çevrimdışı yüklemesi oluşturma
• Visual Studio yüklemesini yanıt dosyasıyla otomatikleştirme
• Visual Studio iş yükü ve bileşen kimlikleri