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 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 ö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.
Visual Studio 2019 önyükleyicilerini aşağıdaki tablodan alabilirsiniz. Alternatif olarak, Visual Studio 2019'un belirli bir sürümünü istiyorsanız Visual Studio 2019 Yayınları sayfasına bakın. Bu sayfada, seçtiğiniz Visual Studio sürümü ve sürümü için sabit sürüm önyükleyicilerine bağlantılar bulunur.
| Sürüm | Önyükleyici |
|---|---|
| Visual Studio 2019 Enterprise sürüm 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional sürüm 16.11 | vs_professional.exe |
| Visual Studio 2019 Derleme Araçları sürüm 16.11 | vs_buildtools.exe |
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 sürümünü doğrulamak istiyorsanız, bunu şu şekilde yapabilirsiniz. Windows'da Dosya Gezgini açın, önyükleyici dosyasına sağ tıklayın, Özellikler'i seçin, Ayrıntılar sekmesini seçin ve ardından Ürün sürüm numarasını görüntüleyin. Bu sayıyı Visual Studio'nun bir sürümüyle eşleştirmek için Visual Studio 2019 Yayınları sayfasının en altındaki tabloya bakın.
İ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ştirir. |
updateall |
Yüklü tüm ürünleri sıralı olarak güncelleştirir. 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. Parametresini kullanarak Güncelleştirme Ayarları iletişim kutunuzu --includeRecommended etkinleştirerek "güncelleştirmede yüklü iş yükleri için önerilen bileşenleri ekle" seçeneğini etkinleştireceksiniz. 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 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 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 --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. |
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.
| Komut | 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 program aracılığıyla 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\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
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.
| 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 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 --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 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, 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 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 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 --override install 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 yapılandırması oluşturmayı öğrenmek için bkz . WinGet Yapılandırma dosyası yazma.
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ğlantı 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öneticisiyseniz ve Visual Studio yüklü değilse, BT Yöneticisi geri bildirimini buradan gönderebilirsiniz.
- Visual Studio Geliştirici Topluluğu bir özellik önerin, ürün sorunlarını izleyin ve yanıtlar bulun.