Visual Studio'nun ağ yüklemesini oluşturma ve sürdürme

Bazen kuruluş yöneticisi, bir kuruluştaki istemci makinelerine dağıtılabilir Visual Studio dosyalarını içeren özel bir yükleme önbelleği ("düzen" olarak da bilinir) oluşturmak ister.

Düzen oluşturmak aşağıdaki durumlarda kullanışlıdır:

• Kullanıcının sınırlı izinleri var
• İstemci makinelerinin İnternet erişimi sınırlıdır
• Kuruluş, geliştirici araç takımının belirli bir sürümünü standartlaştırmak istiyor

Visual Studio'yu, bir yöneticinin hem düzen oluşturup koruyabilmesi hem de bir iç ağ paylaşımında depolaması ve isteğe bağlı olarak kuruluşun intranetinde kullanılabilir hale getirmesi için tasarladık. Düzen, hem ilk istemci yüklemesi hem de sonraki güncelleştirmeler için gereken tüm Visual Studio dosyaları için kaynak konum görevi görür.

Bu sayfadaki bilgiler üç ana bölümde gruplandırılır:

• Düzeni oluşturma: Düzeni doğru ürün içeriğiyle oluşturmayı, varsayılan ayarları yapılandırmayı, bir ağ dosya paylaşımında depolamayı ve intranetinizde kullanılabilir hale getirmeyi açıklar.
• Düzeni koruyun: Düzenin ürün sürümünü en iyi şekilde güncelleştirme veya düzenin ürün içeriğini, kanal ayarlarını, yükleyici sürümünü ve klasör boyutunu değiştirme hakkında bilgi.
• Yardım ve Destek: nereden yardım istenir?

Düzeni oluşturma

Ağ dosya paylaşımı depolama konumunu hazırlama

İlk olarak, indirilen Visual Studio paketlerini nerede depolayabileceğinizi belirlemeniz gerekir. Kuruluşunuzda kullanılmakta olan birden çok Visual Studio sürümünüz varsa (örneğin, Visual Studio 2022 Professional ve Visual Studio 2022 Enterprise), her sürüm için ayrı bir düzen oluşturmanız gerekir. Her sürüm için ayrı bir düzen oluşturmak, özellikle de düzen güncelleştirmelerinin disk alanı tükettiği düşünüldüğünde çok fazla disk alanı tüketebilir.

Düzen yolu 80 karakterden az olmalıdır; bazı kuruluşlar 80 karakterlik sınırlamaya geçici bir çözüm bulmak için sembolik bağlantıları başarıyla kullanır.

Düzeni oluşturmak için Visual Studio önyükleyicisini indirme

İstediğiniz Visual Studio sürümü için doğru önyükleyiciyi indirin ve düzenin deposu olarak hizmet vermek istediğiniz dizine kopyalayın. Düzen oluşturulduktan sonra, visual studio'yu herhangi bir istemci makinesine yüklemek için kullanabilirsiniz. Önyükleyici, diğer düzen işlemlerini oluşturmak, güncelleştirmek ve gerçekleştirmek için kullandığınız yürütülebilir dosyadır. Bu adımı tamamlamak için İnternet bağlantınız ve yönetici izinleriniz olmalıdır.

Aşağıdaki önyükleyiciler, visual studio 2022'nin en son en güvenli sürümünü çalıştırdığınızda bağımsız olarak her zaman Geçerli kanala yükler. Alternatif olarak, bir düzeni belirli bir sürüme veya Visual Studio 2022'nin belirli bir kanalına oluşturmak veya güncelleştirmek istiyorsanız, Visual Studio 2022 Yayın Geçmişi'nden istediğiniz kanalın bakım sürümü için sürekli ve sabit sürüm önyükleyicisini indirin. Düzenin kaynak konumu olarak hizmet vermek istediğiniz dizine kopyalayın.

Edition	Ö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ın Geçerli olduğu varsayılır. Bu nedenle, LTSC 17.0 Ürün sürümüne sahip bir önyükleyici, 17.0 LTSC kanalında kullanılabilen en son 17.0.x hizmet sürümünü yükler. Visual Studio 2022'nin en son hizmet sürümünü Geçerli kanala Visual Studio 2022'nin en son hizmet sürümünü yüklediğini belirten Ürün sürümüne sahip bir önyükleyici.

Visual Studio paketlerini indirme

Bu adımı tamamlamak için İnternet bağlantınız olmalıdır.

Yükseltilmiş bir komut istemi açın, önyükleyiciyi indirdiğiniz dizine gidin ve ağ düzeninizi oluşturmak ve korumak için Visual Studio'yu yüklemek için komut satırı parametrelerini kullanma sayfasında tanımlandığı gibi önyükleyicinin parametrelerini kullanın. Aşağıdaki örneklerde ilk düzen oluşturmanın yaygın yolları gösterilmektedir. Visual Studio yükleme sayfasının komut satırı parametre örneklerinde daha fazla örnek bulunabilir.

Tek bir dil yerel ayarı için tam bir başlangıç düzeni için Visual Studio Community için yaklaşık 40 GB ve Visual Studio Enterprise için yaklaşık 50 GB disk alanı gerekir. Ek dil yerel ayarları için her birinin yaklaşık yarım GB'ı gerekir.

Önerilen yaklaşım, tüm iş yükleri ve uygun dillerle Visual Studio'nun ilk düzenini oluşturmak ve paketleri ağ sunucusundaki düzen dizininde depolamaktır. Bu şekilde, tüm istemci yüklemeleri Visual Studio ürün teklifinin tamamına ve herhangi bir alt kümeyi yükleme özelliğine erişebilir. Visual Studio'nun tam düzenini oluşturmak için, ağ düzenini barındırmayı planladığınız dizinden aşağıdaki komutu çalıştırın:

vs_enterprise.exe --layout c:\VSLayout

Düzeninizin doğru kanala göre ayarlandığından emin olun

Yöneticinin güncelleştirdiği ölçütlerden biri olduğundan, kuruluş genelinde dağıtılırsa hangi istemci örneklerinin güncelleştirilmesi gerektiğini belirlemek için ağ düzeninin doğru kanalı temel aldığından emin olmak önemlidir. Örneğin, düzeniniz VisualStudio.17.Release.LTSC.17.0 kanalını temel alıyorsa ve istemcileriniz Microsoft tarafından barındırılan sunuculardan güncelleştirme alacak şekilde yapılandırılmışsa, 17.0 LTSC kanalında sağlanan tüm güvenlik güncelleştirmeleri, bu düzenden yüklenen veya güncelleştirilen istemciler tarafından kullanılabilir.

Daha önce listelenen önyükleyiciler Geçerli kanalı temel alır. LTSC kanallarından birini temel alan bir düzen oluşturmak için, Visual Studio 2022 Yayın Geçmişi sayfasından doğru kanalın önyükleyicisini alın, düzen klasörünüzde kopyalayın ve düzeni oluşturmak veya güncelleştirmek için kullanın.

Düzenin içeriğini yapılandırma

Ağ düzeninizin içeriğini özelleştirmek için kullanabileceğiniz çeşitli seçenekler vardır. Yalnızca belirli bir dil yerel ayarları, iş yükleri, bileşenler ve bunların önerilen veya isteğe bağlı bağımlılıklarını içeren kısmi bir düzen oluşturabilirsiniz. İstemci iş istasyonlarına iş yüklerinin yalnızca bir alt kümesini dağıtacağını biliyorsanız kısmi düzen kullanışlıdır. Düzeni özelleştirmeye yönelik tipik komut satırı parametreleri şunlardır:

• --addiş yükü veya bileşen kimliklerini belirtmek için.
  Kullanılırsa --add , yalnızca ile --add belirtilen iş yükleri ve bileşenler indirilir. Kullanılmıyorsa --add , tüm iş yükü ve bileşenler indirilir.
• --includeRecommended belirtilen iş yükü kimlikleri için önerilen tüm bileşenleri dahil etmek için.
• --includeOptional belirtilen iş yükü kimlikleri için tüm isteğe bağlı bileşenleri dahil etmek için.
• --config bir dosyayı kullanarak *.vsconfig düzende yer alması veya buna başvurması gereken iş yüklerini , bileşenleri veya uzantıları belirtin. Yapılandırma dosyasının tam yolunu belirttiğinizden emin olun.
• --langdil yerel ayarları belirtmek için.

Özel ağ düzeni oluşturmaya birkaç örnek aşağıda verilmiştir.

• Yalnızca bir dilde tüm iş yükleri için gerekli bileşenlere sahip bir düzen oluşturmak için şunu çalıştırın:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US
  

• Birden çok dildeki tüm iş yükleri için gerekli bileşenlere sahip bir düzen oluşturmak için şunu çalıştırın:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
  

• Bir iş yükü ve tüm dillerde bu iş yükü için gerekli ve önerilen tüm bileşenlere sahip bir düzen oluşturmak için şunu çalıştırın:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
  

• İki iş yükü ve üç dilde isteğe bağlı bir bileşen içeren bir düzen oluşturmak için şunu çalıştırın:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
  

Bir düzenin içeriğini başlatmak için yapılandırma dosyası kullanma

Bir dosyayı geçirmek *.vsconfig için parametresini --config kullanabilirsiniz. Yapılandırma dosyasının tam yolunu belirttiğinizden emin olun. Düzen oluşturma sırasında dosya *.vsconfig kullanılması, ağ düzeninin içeriğini yapılandırma dosyasında belirtilenlerle özelleştirir ve sınırlar. Yapılandırma dosyası düzen dizinine kopyalanır ve olarak yeniden adlandırılır layout.vsconfig.

Dosyada *.vsconfig belirtilen uzantılar doğrudan düzene kopyalanmamıştır. Bunun response.json yerine, düzenin dosyası istemcinin uzantıları için yükleme konumunu tanımlayarak yeni oluşturulan layout.vsconfig dosyaya bir başvuru içerir. Dijital olarak imzalanmamış uzantılar yüklüyorsanız eklemek "allowUnsignedExtensions": trueiçin öğesini düzenlediğinizden response.json emin olun. İçerik örneklerine bakınresponse.json.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Düzeni ağ paylaşımına kopyalama

İstemci makinelerinden erişebilmek için düzeni bir ağ paylaşımında barındırmanız gerekir. Düzeni yerel bir makinede oluşturduysanız, bir ağ dosyası konumuna kopyalamanız gerekir. Aşağıdaki örnekte kullanılır xcopy. dilerseniz robocopykullanabilirsiniz. Örnek:

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Bu düzen için ilk istemci yükleme varsayılanlarını yapılandırma

Düzenin kök klasöründe adlı response.json bir dosya oluşturulur. Bu özelleştirilebilir dosya, istemci başlangıçta düzenden yüklendiğinde istemcide yapılandıracak ilk varsayılan ayarları sağlar. Yaygın yapılandırma seçenekleri şunlardır:

• İstemcide varsayılan olarak hangi iş yüklerinin, bileşenlerin veya dillerin yüklenmesi gerekir?
• Önerilen bileşenlerin de yüklenmesi gerekiyorsa
• İstemcinin bir yükleme dosyasına saygı duyması *.vsconfig gerekiyorsa
• İstemci güncelleştirmeleri nereden almalıdır?
• Güncelleştirme sırasında destek dışı bileşenlerin kaldırılması gerekiyorsa
• İmzasız uzantıların sessizce ve program aracılığıyla yüklenmesine izin veriliyorsa

Yanıt dosyasıyla Visual Studio yüklemesini otomatikleştirme sayfasında daha fazla bilgi bulabilirsiniz.

Düzeninizi intranet sitesi aracılığıyla erişilebilir hale getirme

Haziran 2023'te başlayarak, düzenlerinizi web sunucusu dosya önbelleği ve coğrafi çoğaltma performansı özelliklerinden yararlanmanızı sağlayan bir iç intranet sitesinde kullanılabilir hale getirebilirsiniz. Bu yeni özelliği kullanmak için en son Visual Studio önyükleyicilerini ve en son Visual Studio Yükleyicisi kullanmanız gerekir. BT yöneticilerinin bu intranet web barındırma özelliğinden yararlanmak için aşağıdakileri yapması gerekir:

1. İlk olarak, bir ağ düzeni oluşturup koruyun ve bitlerin ağ paylaşımında mevcut ve düzenli olarak güncelleştirildiğinden emin olun. Ayrıca, istemcilerinizin güncelleştirmelerini intranet düzeni konumundan almalarını istiyorsanız, düzenin response.json channelUri değerini yapılandırmayı unutmayın.

2. Bir yöneticinin bir iç web sitesi hazırlaması ve web sitesinin kaynağını düzenin ağ dosyası konumuna bağlaması gerekir. Ayrıca web sunucularının aşağıdaki MIME türlerine saygı duyduğundan da emin olmaları gerekir:

   Dosya Uzantısı	MIME Türü
   .Taksi	application/vnd.ms-cab-compressed
   .Exe	application/octet-stream
   .Json	application/json
   .Msı	application/octet-stream
   .Msu	application/octet-stream
   .nupkg	application/octet-stream
   .Opc	application/octet-stream
   .ps1	application/postscript
   .Vsıx	application/octet-stream
   .Xml	text/xml
   .Zip	application/x-zip-compressed

3. Son olarak, bu düzeni istemciye dağıtmak için istemcide bir PowerShell betiği çalıştırarak ilk yüklemeyi gerçekleştirin. Visual Studio, web'de barındırılan bir düzenden istemciye başarıyla yüklendikten sonra , web barındırma düzenleri için istemci güncelleştirmeleri standart yöntemlerle güncelleştirilebilir.

Düzeninizin en son yükleyiciyi kullandığından emin olun

Not

Haziran 2023 itibarıyla, en son yükleyici varsayılan olarak visual studio 2017, Visual Studio 2019 ve Visual Studio 2022'nin desteklenen tüm sürümlerine yapılan her güncelleştirmeyle birlikte sunulur. Bu nedenle, bu ürün sürümlerinden birini kullanıyorsanız, yükleyicinin en son sürümünü en son işlevsellik ve hata düzeltmeleriyle almak için açıkça herhangi bir şey yapmanız gerekmez.

Haziran 2023'e kadar gönderilen bir Visual Studio sürümü kullanıyorsanız, düzeninizde her zaman en son Visual Studio Yükleyicisi kullanmanızı ve istemcilerinize dağıtmanızı öneririz. Örneğin, Visual Studio 2022 yükleyicisini Visual Studio 2019 düzeninize dağıtırsanız, bu düzeni temel alan Visual Studio 2019 istemcileriniz güncelleştirmelerin kaynak konumunu değiştirebilir veya destek dışı bileşenleri kolayca kaldırabilir. Diğer ayrıntılar aşağıdaki bölümde açıklanmıştır.

Program aracılığıyla en son yükleyiciyi kullandığınızdan emin olma özelliği, yalnızca Visual Studio 2022 başlangıçta gönderildikten sonra oluşturulan Visual Studio 2019 önyükleyicileri tarafından kullanılabilir. Bu nedenle, aşağıdaki örnekteki vs_enterprise.exe 10 Kasım 2021'den sonra gönderilen bir sürüm olmalıdır.

Mevcut en son ve en iyi yükleyiciyi kullanan tüm ürünün düzenini oluşturmak için

vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller

Düzeninizi koruma

Visual Studio düzeninizi ürünün en son güvenli sürümüne düzenli aralıklarla güncelleştirmek en iyi yöntemdir. Bu, düzenin istemci yüklemeleri için hem yükleme noktası hem de güncelleştirme kaynağı olarak kullanılabilmesini sağlar. Aşağıdaki bölümde en yaygın veya kullanışlı düzen bakım işlemleri açıklanmaktadır.

Bir ağ dosya paylaşımında bir düzen barındırdıysanız, güncelleştirilmiş bir düzeni özel bir yerel paylaşıma (örneğin, c:\VSLayoutUpdate) indirmek ve güncelleştirilmiş içeriğin tümü indirildikten sonra, bunu düzen ağ dosya paylaşımınıza (örneğin, \server\products\VS) kopyalamak isteyebilirsiniz. Bunu yapmazsanız, siz düzeni güncelleştirirken kurulumu çalıştıran kullanıcılar, henüz tam olarak güncelleştirilmediğinden, düzendeki içerik uyuşmazlığıyla karşılaşabilir.

Düzeni ürünün en güncel sürümüne güncelleştirin

Microsoft, işlevsellik veya güvenlik sorunlarını düzeltmek için ürünün güncelleştirilmiş sürümlerini sık sık yayınlar. Müşterilerinizin her zaman ürünün en son en güvenli sürümüne erişebilmesi için düzeninizi ürünün en son sürümüyle güncel tutmanızı kesinlikle öneririz. İstemcilerinizin İnternet erişimi yoksa ve yalnızca düzenden ürün güncelleştirmeleri alabiliyorsa bu özellikle önemlidir. Visual Studio genellikle güvenlik güncelleştirmelerini ayın ikinci Salı günü yayınlar ve "yama Salı" olarak bilinir. Bu nedenle, salı öğleden sonraları düzeltme eki uygulamak için tüm düzenlerinizi güncelleştirmek iyi bir strateji olacaktır.

İlk düzeni oluşturduğunuzda, düzene eklenecek iş yükleri ve diller gibi belirtilen seçenekler düzenin yapılandırma dosyasına layout.jsonkaydedilir. Daha sonra, bu düzeni ürünün daha yeni bir sürümüne güncelleştirdiğinizde, düzende ürünün hangi bileşenlerini istediğinizi yeniden belirtmeniz gerekmez. Düzen güncelleştirmesi, düzendeki mevcut bileşenleri en güncel sürümlerine güncelleştirir.

Yukarıdaki tabloda yer alan her zaman yeşil önyükleyicilerden birini kullanarak bu kısmi düzeni zaten oluşturduğunuzu varsayalım.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

Bu düzeni Microsoft tarafından sunulan ve Microsoft sunucularında barındırılan ürünün en son sürümüne güncelleştirmek kolaydır. Düzende var olan her zaman yeşil önyükleyiciyi kullanmanız ve en son paketleri düzeninize indirmek için komutunu yükseltilmiş bir istemde aşağıdaki gibi çalıştırmanız --layout yeterlidir:

vs_enterprise.exe --layout c:\VSLayout

Ayrıca, düzeninizi katılımsız bir şekilde güncelleştirilmiş bir sürüme güncelleştirebilirsiniz. Düzen işlemi, kurulum işlemini yeni bir konsol penceresinde çalıştırır. Pencere açık bırakılır, böylece yöneticiler son düzen güncelleştirme sonucunu ve oluşmuş olabilecek hataların özetini görebilir. Düzen güncelleştirme işlemini katılımsız bir şekilde gerçekleştirmek istiyorsanız (örneğin, düzeninizi en son sürüme güncelleştirmek için düzenli olarak çalıştırılan bir betiğiniz var), parametresini --passive kullanın; işlem pencereyi otomatik olarak kapatır.

vs_enterprise.exe --layout c:\VSLayout --passive

Düzeni ürünün belirli bir sürümüne güncelleştirme

Bazen düzeninizi ürünün belirli bir sürümüne güncelleştirmek isteyebilirsiniz. Örneğin, düzeninizin kuruluşunuzu standartlaştırdığınız hizmet temelinin en son güvenli sürümüyle eşleşmesini sağlamak isteyebilirsiniz. Bu işlemi şöyle yapabilirsiniz:

Visual Studio 2022 Yayın Geçmişi sayfasına gidip belirli bir sabit sürüm önyükleyicisini indirebilir, düzeninize kopyalayabilir ve düzeni önyükleyicide belirtilen tam sürüme güncelleştirmek için kullanabilirsiniz. Yukarıdakiyle tam olarak aynı söz dizimini kullanırsınız.

Düzeninizi ürünün belirli bir sürümüne güncelleştirmek için bir yönetici güncelleştirmesi kullanabilirsiniz. Yönetici güncelleştirmesini almak için Microsoft Update Kataloğu'na gidin ve düzeninizi güncelleştirmek istediğiniz güncelleştirmeyi arayın. update.exe öğesini düzeni barındıran bilgisayara indirin, bu bilgisayarda yükseltilmiş bir komut istemi açın ve aşağıdaki gibi bir komut çalıştırın:

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

Yönetici güncelleştirmesinin yeni düzen oluşturma işlemini başlatmayacağını unutmayın; yalnızca mevcut bir düzeni güncelleştirir. İlk düzeni oluşturmak için önyükleyici kullanmanız gerekir.

Ağ düzeninizin desteklenen bir sürüme dayalı olduğundan emin olun

Bazen kanallar destekten çıktıkçe, istemcilerinizin güvenlik güncelleştirmeleriyle ilgili bildirimleri almaya devam edebilmesi için ağ düzeninin desteklenen bir kanalı temel almaya devam ettiğinden emin olmanız gerekir. Düzeniniz VisualStudio.17.Release.LTSC.17.0 kanalını temel alıyorsa, 17.0 LTSC kanalı Temmuz 2023'te destekten çıktıktan sonra, bu kanala daha fazla güvenlik güncelleştirmesi yayınlamayacağız ve düzeniniz ve istemcileriniz güvenli olmayacaktır. Çeşitli Visual Studio 2022 kanalları için destek tarihleri burada bulunabilir.

Düzenin temel aldığı kanalı değiştirmek için, Visual Studio 2022 Yayın Geçmişi sayfasından istenen kanalın önyükleyicisini alın, düzen klasörünüzde kopyalayın ve normal bir güncelleştirme gerçekleştirin. Daha sonra istemcilerinizin de güvende kalabilmeleri için bir güncelleştirmeden uygun şekilde haberdar edilmesi gerekir.

Düzenin içeriğini değiştirme

Kısmi bir düzeni değiştirmek ve ek iş yükleri, bileşenler veya diller eklemek mümkündür. Bileşenlerin bir düzenden güvenilir bir şekilde kaldırılması mümkün değildir.

Aşağıdaki örnekte, azure iş yükünü ve yerelleştirilmiş bir dili, daha önce yalnızca Yönetilen Masaüstü iş yükü ve İngilizce diliyle oluşturulmuş olan düzene ekleyeceğiz. Değişikliği yaptıktan sonra hem Yönetilen Masaüstü hem de Azure iş yükleri ve hem İngilizce hem de Almanca kaynaklar bu düzene dahil edilecek. Komut, bileşen eklemeye --layout ek olarak düzenin önyükleyici tarafından belirtilen sürüme güncelleştirilmasına da neden olur. Bu nedenle, her zaman yeşil önyükleyiciyi kullanıyorsanız, sonuçta elde edilen düzen yeni bileşene, yeni dile ve tüm düzen içeriği önyükleyicinin kanalındaki en son sürüme güncelleştirilir.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

Var olan bir kısmi düzeni tam düzene dönüşecek şekilde değiştirmek istiyorsanız, aşağıdaki örnekte gösterildiği gibi --all seçeneğini kullanın. Bu komut da düzen içeriğinin önyükleyici tarafından belirtilen sürüme güncelleştirilmasına neden olur.

vs_enterprise.exe --layout c:\VSLayout --all

Düzeninizde olmasını istediğiniz ek bileşenleri içeren bir *.vsconfig dosya geçirerek bir düzene bileşen ekleyebilirsiniz. Bunu yaparsanız, yeni *.vsconfig içerik mevcut layout.vsconfig içeriğin üzerine yazılır. Daha fazla bilgi için, bir düzenin içeriğini başlatmak için yapılandırma dosyası kullanma başlıklı önceki bölüme bakın.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Son olarak, düzen klasöründeki layout.json yapılandırma dosyasını doğrudan düzenleyebilir ve bu dosyanın "ekle" bölümünü düzeninize eklenmesini istediğiniz ek bileşenleri içerecek şekilde güncelleştirebilirsiniz. Ardından en son bileşenleri indirmek için daha önce açıklandığı gibi kullanarak --layout düzeni güncelleştirmeniz gerekir.

Not

Yeni eklenen düzen bileşenlerini bir istemci makinesine yüklemenin en kolay yolu, önyükleyiciyi istemci makinesinden düzende çalıştırmaktır. Düzendeki dosyanın 'ekle' bölümü response.json , istemcinin yükleyici kullanıcı arabiriminde varsayılan olarak hangi bileşenlerin seçileceğini belirler. Yukarıdaki yöntemlerden birini kullanarak düzeni değiştirdiyseniz, dosyadaki response.json 'ekle' bölümünü yeni değiştirilen layout.json dosyanın 'ekle' bölümündeki içeriklerle daha uygun bir şekilde eşleşecek şekilde el ile iki kez denetlemek ve ayarlamak isteyebilirsiniz.

İstemci makinesindeki destek dışı bileşenleri kaldırmak için düzeni yapılandırın.

Bazı kuruluşlar, Visual Studio 2022 sürüm 17.4'te sunulan ve destek dışı duruma geçirilmiş bileşenleri kaldıran özellikten yararlanmak isteyecektir. Bir düzeni yönetiyorsanız ve istemcileriniz yönetici güncelleştirmeleri alıyorsa, bunu ayarlamak nispeten kolaydır. İlk olarak, düzeninizi aşağıda açıklandığı gibi yükleyicinin en son sürümüne sahip olacak şekilde yapılandırmanız gerekir. İkinci olarak, satırı "removeOos": true dosyaya response.json eklemeniz gerekir. Düzeninizde bu iki ayrıntı düzgün ayarlanmışsa, sonraki yönetici güncelleştirmeleri bu ayara uygun olur ve istemci makinelerinden destek dışı bileşenleri kaldırır.

Düzeni doğrulama

Paket dosyalarının eksik veya geçersiz olup olmadığını denetleyen ağ düzeninde doğrulama gerçekleştirmek için kullanın --verify . Doğrulamanın sonunda, eksik ve geçersiz dosyaların listesini yazdırır.

Doğrulama yalnızca Visual Studio'nun belirli bir ikincil sürümünün en son sürümü için çalışır. Yeni bir sürüm yayımlanır yayımlanmaz, önceki sürümleri içeren düzenler için doğrulama çalışmaz.

vs_enterprise.exe --layout <layoutDir> --verify

Not

seçeneği tarafından gerekli olan bazı önemli meta veri dosyalarının --verify düzen klasöründe olması gerekir. Bu meta veri dosyaları eksikse "--verify" çalıştırılamaz ve Kurulum size bir hata verir. Bu hatayla karşılaşırsanız düzeni yeniden güncelleştirmeyi deneyin veya farklı bir klasörde yeni bir ağ düzeni oluşturun.

Microsoft'un güncelleştirmeleri Düzenli aralıklarla Visual Studio'ya gönderdiğini unutmayın. Bu nedenle, her zaman yeşil bir önyükleyici kullanıyorsanız, daha yeni bir düzen ilk düzen ile aynı sürümü içermeyebilir. Bununla birlikte, sabit bağlantı önyükleyicileri kullanırsanız (neredeyse) her zaman belirleyici bir dosya kümesi alırsınız.

Düzeni düzeltme

ile aynı doğrulamayı --verify gerçekleştirmek için kullanın --fix ve ayrıca tanımlanan sorunları düzeltmeye çalışın. İşlemin --fix bir İnternet bağlantısına ihtiyacı olduğundan, çağırmadan --fixönce makinenizin İnternet'e bağlı olduğundan emin olun.

vs_enterprise.exe --layout <layoutDir> --fix

Düzenden eski sürümleri kaldırma

Bir ağ önbelleğinde düzen güncelleştirmeleri gerçekleştirdikten sonra, düzen klasöründe artık en son Visual Studio yüklemesi için gerekli olmayan bazı eski paketler olabilir. Eski paketleri ağ düzeni klasöründen kaldırmak için seçeneğini kullanabilirsiniz --clean .

Bunu yapmak için, bu eski paketleri içeren bildirimleri kataloglayan dosya yolları gerekir. Katalog bildirimlerini ağ düzeni önbelleğindeki "Arşiv" klasöründe bulabilirsiniz. Bir düzeni güncelleştirdiğinizde bunlar oraya kaydedilir. "Arşiv" klasöründe, her biri eski bir katalog bildirimi içeren bir veya daha fazla "GUID" adlı klasör vardır. "GUID" klasörlerinin sayısı, düzenlerinizde yapılan güncelleştirme sayısıyla aynı olmalıdır.

Her "GUID" klasörüne birkaç dosya kaydedilir. En çok ilgilendiğim iki dosya bir "catalog.json" dosyası ve bir "version.txt" dosyasıdır. "catalog.json" dosyası, seçeneğine geçirmeniz gereken eski katalog bildirimidir --clean . Diğer version.txt dosyası bu eski katalog bildiriminin sürümünü içerir. Sürüm numarasına bağlı olarak, bu katalog bildiriminden eski paketleri kaldırmak isteyip istemediğinize karar vekleyebilirsiniz. Diğer "GUID" klasörlerinde yaptığınız işlemi yapabilirsiniz. Temizlemek istediğiniz kataloglar üzerinde karar verdikten sonra, bu katalogların dosya yollarını sağlayarak komutunu çalıştırın --clean .

--clean seçeneğinin nasıl kullanılacağına ilişkin bir örnek aşağıda verilmiştir:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Bu komutu yürüttüğünüzde, Kurulum kaldıracağı dosyaların listesini bulmak için ağ düzeni klasörünüzü analiz eder. Daha sonra silinecek dosyaları gözden geçirme ve silmeleri onaylama fırsatınız olur.

Düzeni her zaman en son yükleyiciyi içerecek ve sağlayacak şekilde yapılandırın

Not

Haziran 2023 itibarıyla en son yükleyici, visual studio 2017, Visual Studio 2019 ve Visual Studio 2022'nin desteklenen sürümlerine yapılan her güncelleştirmeyle varsayılan olarak gönderilmektedir. Bu nedenle, en son işlevsellik ve hata düzeltmeleriyle yükleyicinin en son sürümünü düzeninize ve istemcilerinize almak için açıkça hiçbir şey yapmanız gerekmez.

Ancak, Haziran 2023'den önce oluşturulmuş bir düzen kullanıyorsanız, yükleyici Visual Studio'nun daha yeni bir sürümünün parçası olarak kabul edilse bile düzeninizi her zaman dahil etmek ve istemcilerinize en son yükleyiciyi sağlamak için açıkça yapılandırabilirsiniz. Bu nedenle, istemciniz bu düzenden güncelleştirildiğinde, istemci bu düzen tarafından eklenen ve sağlanan en son yükleyiciyi alır. Bunun avantajı, istemcinize en son yükleyici yüklendikten sonra istemci yüklemelerinizin, yükleyiciye eklemeye devam ettiğimiz hata düzeltmelerinden ve yeni işlevlerden yararlanabilmesidir.

Düzeninizin en son yükleyiciyi içermesini ve sağlamasını sağlamanın birkaç yolu vardır:

• Visual Studio'nun Haziran 2023 veya sonrasında oluşturulmuş bir sürümünü kullanabilirsiniz.

• Düzeni oluştururken veya güncelleştirirken parametresini önyükleyiciye geçirebilirsiniz --useLatestInstaller . Bu, düzenin layout.json kök dizininde bulunabilen dosyada bir ayarın ayarlanmasına neden olur. Aşağıda, düzeni güncelleştirmeye ve kullanılabilir en son ve en iyi yükleyiciyi kullanacak şekilde yapılandırmaya yönelik bir örnek verilmiştir.

  vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
  

• Bu ayarı eklemek için dosyayı doğrudan düzenleyebilirsiniz layout.json .

  {
     "installChannelUri": ".\\ChannelManifest.json",
     "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
     "installCatalogUri": ".\\Catalog.json",
     "channelId": "VisualStudio.16.Release",
     "productId": "Microsoft.VisualStudio.Product.Enterprise",
  
     "useLatestInstaller": true,
     "removeOos": true
  
  }
  

Dosyada layout.json bu ayarı program aracılığıyla kaldırmanın bir yolu yoktur, dolayısıyla düzeninizin Microsoft'un kullanıma sunduğu en son yükleyiciyi kullanmayı durdurmasını ve bunun yerine yükleyicinin önyükleyiciye karşılık gelen sürümünü kullanmasını istiyorsanız (büyük olasılıkla en son yükleyiciden daha eskidir), dosyayı düzenleyin layout.json ve ayarı kaldırın "UseLatestInstaller": true .

Bu "UseLatestInstaller": true ayarı düzenin response.json dosyasında da bulabileceğinizi unutmayın, ancak düzenin her zaman en son yükleyiciye sahip olduğundan emin olun. response.json dosyası, istemci bir düzenden yüklendiğinde veya güncelleştirdiğinde istemcide varsayılan yapılandırma seçeneklerini ayarlamak için kullanılır. Dosyadaki layout.json bu özel "useLatestInstaller": true ayar, düzenin içeriğinin en son yükleyiciyi içerdiğinden emin olmak için kullanılır, böylece istemci makineleri düzenden en son yükleyiciyi alabilir.

Hata kodları

parametresini --wait kullandıysanız, işlemin %ERRORLEVEL% sonucuna bağlı olarak ortam 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

Ağ düzeniniz için destek alın

Ağ düzeninizle ilgili bir sorun yaşıyorsanız, bunu öğrenmek istiyoruz. Bize bunu söylemenin en iyi yolu, hem Visual Studio Yükleyicisi hem de Visual Studio IDE'de görünen Sorun Bildir aracını kullanmaktır. BT Yönetici istrator'sanız ve Visual Studio yüklü değilse, BT Yönetici geri bildirimini buradan gönderebilirsiniz. Bu aracı kullandığınızda, sorunu tanılamamıza ve çözmemize yardımcı olabilecek Günlükleri Visual Studio Collect aracıyla gönderebilmeniz çok yararlı olacaktır.

Ayrıca yüklemeyle ilgili sorunlar için bir yükleme sohbeti (yalnızca İngilizce) destek seçeneği sunuyoruz.

Başka destek seçenekleri de mevcuttur. Bkz. Visual Studio Geliştirici Topluluğu.

İlgili içerik

• Visual Studio yönetici kılavuzu
• Visual Studio'yu bir düzenden istemci makinesine dağıtma
• Visual Studio’nun ağ tabanlı yüklemesini güncelleştirme
• Visual Studio'yu yüklerken veya kullanırken ağ ile ilgili hataları giderme
• Visual Studio'nun kurumsal dağıtımları için ilkeleri yapılandırma
• Visual Studio ürün yaşam döngüsü ve bakımı
• Komut satırı parametrelerini kullanarak Visual Studio'yu yükleme
• Visual Studio iş yükü ve bileşen kimlikleri
• Visual Studio çevrimdışı yüklemesi için gereken sertifikaları yükleme