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 anahtarını kullanan bir winget komutuyla.
• Ağ düzeninizi program aracılığıyla güncelleştirmek için Microsoft Update Kataloğu'ndan indirilebilen Yönetici istrator Update 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 özel durumlar belgelenir. 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 düzen 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 2022 için en son önyükleyicileri almak için aşağıdaki tabloda yer alan dosyalardan birini indirin. Alternatif olarak, visual studio 2022'nin belirli bir sürümünü veya belirli bir kanalını yüklemek için Visual Studio 2022 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.

Sürüm	Önyükleyici
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Topluluğu	vs_community.exe
Visual Studio 2022 Derleme Araçları	vs_buildtools.exe

İpucu

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 açın, önyükleyici dosyasına sağ tıklayın, Özellikler'i seçin 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, LTSC 17.0 Ürün sürümüne sahip bir önyükleyici, 17.0 LTSC kanalında bulunan en son 17.0.x bakım sürümünü yükler. Yalnızca Visual Studio 2022'nin geçerli kanala Visual Studio 2022'nin en son sürümünü yükleyeceğini söyleyen ürün sürümüne sahip bir önyükleyici.

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

Komut	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ştirmeler.
updateall	Yüklü tüm ürünleri sıralı olarak Güncelleştirmeler. ve --passive parametreleriyle --quiet ç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, veya --remove komut satırı anahtarını her öğe için yinelemeniz --add 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 veya ile --productID--installPathbirlikte değiştirme işlemleri için 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. Ve/veya --includeOptional parametreleri kullanarak --includeRecommended 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 veya ;includeOptional sonuna (örneğin, --add Workload1;includeRecommended veya --add Workload2;includeRecommended;includeOptional) ekleyebilirsiniz;includeRecommended. 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 veya --addile --allWorkloads belirtilir.
--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 veya --addile --allWorkloads 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, yükleme, makine 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. Parametresini tamamlar ve parametresine --add benzer şekilde davranır.
(#list-of-language-locales) bölümü.
--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. Parametresini tamamlar ve parametresine --addProductLang benzer şekilde davranır.
--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ıklarından bağımsız olarak standart kullanıcılar tarafından program aracılığıyla 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, parametreden birbirini dışlar --quiet (ve aslında 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 --quiet parametreleriyle --passive 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, parametresinden birbirini dışlar --installWhileDownloading .
--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 modify Ayarlar 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 --config veya --quiet bağlamında çalıştırılırken--passive, 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 Visual Studio ürününü değil yalnızca kendisini (yükleyici) yüklemesini bildirir. İş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. ve/veya --includeOptionalkullanarak --includeRecommended genel olarak daha fazla bileşeni denetleyebilirsiniz. Daha ayrıntılı denetim için, kimliğin sonuna veya ;includeOptional sonuna (örneğin, --add Workload1;includeRecommended veya --add Workload2;includeOptional) ekleyebilirsiniz;includeRecommended. 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 veya --addile --allWorkloads 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 ile --addbelirtilir.
--wait	İsteğe bağlı: İşlem, bir çıkış kodu döndürmeden önce yükleme tamamlanana kadar bekler. wait yüklemesinin tamamlanmasını beklemesi gereken yüklemeleri otomatikleştirerek bu yüklemeden dönüş kodunu işlerken 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, ürünün daha yeni bir ana sürümüne ait olsa bile Visual Studio Yükleyicisi en son sürümü 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 Düzeni her zaman en son yükleyici belgelerini kullanacak şekilde yapılandırma bölümüne 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: parametresi, --noWeb internete bağlı bir istemci makinesindeki Visual Studio Yükleyicisi, istemcinin güncelleştirmeler için Microsoft barındırılan sunucularına bakacak şekilde yapılandırılıp yapılandırılmadığı güncelleştirmeleri denetlemesini 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ının kimliği, gibi VisualStudio.17.Releasetemsil edilir. install komutu için channelId gereklidir ve belirtilirse --installPath diğer komutlar için yoksayı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üncelleştirmeleri algılamak için tarafından --channelUri belirtilen URI (belirtildiğinde --installChannelUri belirtilmesi gerekir) 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 veya --arch * parametresini --arch all kullanın. Yalnızca ARM ikili dosyalarının düzenini oluşturmak için --arch arm64
--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. Bu, kaldırma komutu için 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. Bu, kaldırma komutu için 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, sessiz belirtildiğinde yükleyicinin kendisini güncelleştirmesini engeller. 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 ve --installPath "C:\VS"--path install="C:\VS" eşdeğerdir. Aynı anda bu komutlardan yalnızca biri kullanılabilir.

Değiştirme Ayarlar komut ve komut satırı parametreleri

İstemci makinesinde yükleyiciyi veya önyükleyiciyi kullanarak ve modify Ayarlar 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.

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

modify Ayarlar parameters	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.
--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 program aracılığıyla kullanılamaz.
--removeOos true	İsteğe bağlı: Modify Ayarlar 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çiş yapmış 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\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --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

Geri alma komutu ve komut satırı parametreleri

İstemci makinesindeki yükleyiciyi kullanarak ve yükleme yolu örneğinin yanında geri alma komutunu geçirerek güncelleştirmeyi program aracılığıyla geri alabilirsiniz.

Komut	Açıklama
rollback	Visual Studio'nun belirli bir örneğini önceden yüklenmiş güncelleştirmeye geri alma komutu. etkinse DisableRollback 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\2022\Enterprise"

Yönetici istrator Update komutu ve komut satırı parametreleri

Microsoft Update Kataloğu'ndan bir Yönetici istrator 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 istrator Update'i düzeni barındıran bilgisayara indirin, bu bilgisayarda bir komut istemi açın ve aşağıdaki gibi bir komut çalıştırın:

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

İstemciyi güncelleştirme

İstemcide, Yönetici istrator Update'i 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 istrator 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 istrator Update parametrelerinin varsayılan olarak "update" bağlamında çalıştırıldığını unutmayın.

Yönetici istrator 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 --passive ile --quiet 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 istrator güncelleştirmesi kullanıcı bağlamında yürütülürken kullanılmalıdır; Yönetici istrator 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 istrator güncelleştirmesi içeri 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, parametresinden birbirini dışlar --installWhileDownloading .
--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 bir Yönetici istrator 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 açarak, Kullanılabilir sekmesine geçerek ve ürün kartının sağ üst köşesindeki X işaretine tıklayarak güncelleştirme kanallarını el ile kaldırabilirsiniz. komutunu kullanarak removeChannel kanalları (örneğin, eski düzen konumları) program aracılığıyla 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.

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

removeChannel parametreleri	Açıklama
--channelUri	Eski kanal bildiriminin URI'sini gerekli .
--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

Visual Studio'yu program aracılığıyla yüklemek, değiştirmek veya güncelleştirmek için Windows Paket Yöneticisi "winget" aracını ve winget tarafından yönetilen diğer paketleri kullanabilirsiniz.

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

winget install --id Microsoft.VisualStudio.2022.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.2022.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.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Makinenizde Visual Studio zaten yüklüyse, winget komutunu Visual Studio PowerShell DSC sağlayıcısı, yaml dosyası ve .vsconfig dosyasıyla birlikte kullanarak mevcut Visual Studio yüklemesine bileşen ekleyebilirsiniz.configure Winget'in configure komutu temelde bir Visual Studio "değiştirme" işlemi işlevi görür.

Winget'in upgrade komutuyla birlikte anahtarı veya Visual Studio DSC sağlayıcısını kullanmak --override 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şlemlerin ş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ı	Dil
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
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:

Value	Sonuç
0	İşlem başarıyla tamamlandı
740	Yükseltme 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 denetimi hatası
8002	Arka plan indirme ön denetimi hatası
8003	Destek dışı seçilebilir hata
8004	Hedef dizin hatası
8005	Kaynak yüklerini doğrulama hatası
8006	Çalışan Visual Studio işlemleri
8010	İşletim Sistemi desteklenmiyor. Sistem Gereksinimleri'ne bakın
-1073720687	Bağlan ivity hatası
-1073741510	Microsoft Visual Studio Yükleyicisi sonlandırıldı (kullanıcı veya dış işlem tarafından)
Diğer (ö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_setup kurulum altyapısı için , dd_clientve ile dd_bootstrapperbaş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 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.

İlgili içerik

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