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

📣 Geri bildiriminizi duymak isteriz!Bu anket tamamlamak için lütfen biraz bekleyin ve düzen deneyimini nasıl geliştirebileceğimizi bize bildirin. Desteğiniz için teşekkür ederiz!

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

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

• Sınırlı sistem izinlerine sahip kullanıcı
• kısıtlı internet erişimine sahip istemci makineleri
• 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: Doğru ürün içeriğiyle bir düzen oluşturmayı, varsayılan ayarları yapılandırmayı, düzeni bir ağ dosya paylaşımında depolamayı ve intranetinizde kullanılabilir hale getirmeyi açıklar.
• Düzenkoruyun: 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 yerleşim deposu olarak hizmet vermesini istediğiniz klasöre 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, hangi zamanda çalıştırırsanız çalıştırın, Visual Studio 2022'nin en son ve en güvenli sürümünü her zaman Cari kanala kurar. Belirli bir sürüme veya Visual Studio 2022'nin belirli bir kanalına yönelik bir düzen oluşturmak veya güncellemek istiyorsanız, uygun önyükleyiciyi indirin. Her bakım sürümü ve kanalı için hem sürekli hem de sabit sürüm önyükleyicileri Visual Studio 2022 Yayın Geçmişi sayfasında bulunur. İstediğinizi indirin ve düzenin kaynak konumu olarak kullanmak istediğiniz dizine kopyalayın.

Baskı	Ö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

Bahşiş

Daha önce bir önyükleyici dosyası indirdiyseniz ve yüklendiğini doğrulamak istiyorsanız, bunu şu şekilde yapabilirsiniz. Windows'ta Dosya Gezgini'ni açın, önyükleyici dosyasına sağ tıklayın, Özellikler'i ve ardından Ayrıntılar sekmesini seçin. Ürün sürümü alanında önyükleyicinin yüklediğ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 İstemi 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ımlanan parametreleri kullanın. Aşağıdaki örneklerde ilk düzenleri oluşturmanın yaygın yolları gösterilmektedir. Visual Studio yükleme sayfasının komut satırı parametre örneklerinde daha fazla örnek bulabilirsiniz.

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ının her biri için yaklaşık yarım GB gereklidir.

Ö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

Ağ düzeninin doğru kanala dayalı olduğundan emin olmak önemlidir. Bunun nedeni, kanalın yönetici güncelleştirmelerinin kuruluş genelinde dağıtıldığında hangi istemci örneklerinin güncelleştirilmesi gerektiğini belirlemek için kullandığı ölçütlerden biri olmasıdır. Ö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 yayınlanan 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 Current kanalını 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 birdil yerel ayarları kümesini,iş yüklerini, bileşenlerini 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ünü veya bileşen kimliklerini belirtmek için .
  --add kullanılırsa, yalnızca --add ile belirtilen iş yükleri ve bileşenler indirilir. --add kullanılmazsa tüm iş yükü ve bileşenler indirilir.
• --includeRecommended belirtilen iş yükü kimlikleri için önerilen tüm bileşenleri eklemek.
• Belirtilen iş yükü kimlikleri için tüm isteğe bağlı bileşenleri dahil etmek --includeOptional.
• --config, düzenin içermesi veya referans vermesi gereken *.vsconfig belirtmek için dosyasını kullanın. Yapılandırma dosyasının tam yolunu belirttiğinizden emin olun.
• --lang, dil yerel ayarlarını 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

--configgeçirmek için *.vsconfig parametresini kullanabilirsiniz. Yapılandırma dosyasının tam yolunu belirttiğinizden emin olun. Düzen oluşturma sırasında bir *.vsconfig dosyası kullanmak, 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 layout.vsconfigolarak yeniden adlandırılır.

*.vsconfig dosyasındaki belirtilen uzantıları doğrudan düzene kopyalanmaz. Bunun yerine, düzenin response.json dosyası yeni oluşturulan layout.vsconfig dosyasına başvuru içerir ve istemcinin uzantıları için yükleme konumunu tanımlar. Dijital olarak imzalanmamış uzantılar yüklüyorsanız, response.json'ı düzenleyerek "allowUnsignedExtensions": trueeklediğinizden emin olun. response.json içerik örneklerine bakın.

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

Düzeni ağ paylaşımına kopyalayın

İ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 xcopykullanılır. dilerseniz robocopyde kullanabilirsiniz. Ö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 response.json adlı bir dosya oluşturulur. Bu özelleştirilebilir dosya, başlangıçta düzenden yüklenen istemciyi yapılandırmak üzere ilk varsayılan yapılandırma ayarlarını 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 *.vsconfig dosyasına saygı duyması 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 programatik olarak sessiz bir şekilde & yüklenmesine izin veriliyorsa

Visual Studio yüklemesini yanıt dosyasıyla 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'ni 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. İstemcilerinizin güncellemeleri intranet düzen konumundan almalarını istiyorsanız, ayrıca düzenin response.jsonöğesindeki 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ü
   .cab	application/vnd.ms-cab-compressed
   .exe	application/octet-stream
   .json	application/json
   .msi	application/octet-stream
   .msu	application/octet-stream
   .nupkg	application/octet-stream
   .opc	application/octet-stream
   .ps1	application/postscript
   .vsix	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ırın ve ilk yüklemegerç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ştirmeleristandart 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'ni 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 2021den 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 şu adımları takip edin ve çalıştırın.

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öntem olarak kabul edilir. Bunun yapılması, düzenin hem yükleme noktası hem de istemci yüklemeleri için 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.

Ağ dosya paylaşımında bir düzen barındıracaksanız, güncelleştirilmiş bir düzeni özel bir yerel paylaşıma indirin (örneğin, c:\VSLayoutUpdate). Güncelleştirilmiş içerik indirildikten sonra, bunu düzen ağ dosya paylaşımınıza kopyalayın (örneğin, \server\products\VS). Bunu yapmazsanız, siz düzeni güncelleştirirken kurulumu çalıştıran kullanıcılar, henüz 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. Bu, istemcilerinizin internet erişimi yoksa ve yalnızca düzenden ürün güncellemelerini alabilirlerse özellikle önemlidir. Visual Studio genellikle güvenlik güncelleştirmelerini ayın ikinci Salı günü yayınlar, bu gün "Yama Salısı" olarak bilinir. Bu nedenle, Yama Salısı öğleden sonralarında tüm düzenlerinizi güncellemek iyi bir strateji olabilir.

İlk düzeni oluşturduğunuzda, düzene eklenecek iş yükleri ve diller gibi belirtilen seçenekler layout.jsondüzenin yapılandırma dosyasına kaydedilir. 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.

Önceki tablodaki 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 --layout komutunu yükseltilmiş bir istemle çalıştırarak düzeninize aşağıdaki gibi en son paketleri indirmeniz 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şan 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 kullandığınızda 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'in belirli bir sürümüne güncellemek 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. Bunu şu şekilde 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 yönetici güncelleştirme kullanabilirsiniz. yönetici güncelleştirmesini almak için Microsoft Update Kataloğugidin ve düzeninizi güncelleştirmek istediğiniz güncelleştirmeyi arayın. update.exe dosyasını, düzeni barındıran bilgisayara indirin, bu bilgisayarda yükseltilmiş bir komut istemi açın ve buna benzer bir komut çalıştırın:

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

Yönetici güncelleştirmesi yeni bir düzen oluşturma işlemini başlatmaz; 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ştirmeleri bildirimlerini 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üvensiz hale gelir. Çeşitli Visual Studio 2022 kanalları için destek tarihleri buradabulunabilir.

Düzenin dayandığı kanalı değiştirmek için, Visual Studio 2022 Yayın Geçmişi sayfasından istenen kanalın önyükleyicisini alın, onu düzen klasörünüze kopyalayın ve normal bir güncelleme yapın. Daha sonra istemcilerinize de güvenli kalabilmeleri için bir güncelleştirmenin uygun şekilde bildirilmesi gerekir.

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

Kısmi bir düzeni değiştirmek ve diğer iş yüklerini, bileşenleri veya dilleri eklemek mümkündür. Bir düzenden bileşenlerin güvenilir bir şekilde kaldırılması mümkün değildir.

Aşağıdaki örnekte, daha önce yalnızca Yönetilen Masaüstü iş yükü ve İngilizce diliyle oluşturulmuş olan düzene Azure iş yükünü ve yerelleştirilmiş bir dili 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 edilir. Komut, bileşen eklemeye --layout ek olarak düzenin önyükleyici tarafından belirtilen sürüme güncelleştirilmiş olmasını da sağlar. Bu nedenle, her zaman yeşil önyükleyici kullanıyorsanız, sonuçta elde edilen düzende yeni bileşen, yeni dil bulunur 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ştirilmiş olmasını sağlar.

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

Düzeninizde olmasını istediğiniz diğer bileşenleri içeren bir *.vsconfig dosyayı geçirerek düzene bileşenler ekleyebilirsiniz. Bunu yaparsanız, yeni *.vsconfig içerik mevcut layout.vsconfig içeriğinin üzerine yazılır. Daha fazla bilgi için, düzen içeriğini başlatmak için yapılandırma dosyası kullanmaö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. Daha sonra, en son bileşenleri indirmek için daha önce açıklandığı şekilde --layout kullanarak düzeni güncellemelisiniz.

Not

Yeni eklenen düzen bileşenlerini bir istemci bilgisayarına yüklemenin en kolay yolu, düzen içerisindeki önyükleyiciyi istemci bilgisayarından çalıştırmaktır. Düzendeki response.json dosyasının 'ekle' bölümü, istemcinin yükleyici kullanıcı arabiriminde varsayılan olarak hangi bileşenlerin seçileceğini belirler. Önceki yöntemlerden birini kullanarak düzeni değiştirdiyseniz, yeni değiştirilen response.json dosyanın 'ekle' bölümündeki içeriklerle daha uygun bir şekilde eşleşmesi için dosyadaki layout.json 'ekle' bölümünü el ile kontrol etmek 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, aşağıda açıklandığı gibi düzeninizi yükleyicinin en sonsürümüne sahip olacak şekilde yapılandırmanız gerekir. İkinci olarak, "removeOos": true dosyasına satır 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ğrula

Paket dosyalarının eksik veya geçersiz olup olmadığını denetleyen ağ düzeninde doğrulama gerçekleştirmek için --verify kullanın. 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 işlemi çalışmaz.

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

Not

--verify seçeneği tarafından gereken bazı önemli meta veri dosyaları düzen klasöründe olmalıdır. 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üncellemeleri düzenli olarak Visual Studio'ya gönderdiğini unutmayın. Bu nedenle, sürekli güncellenen bir önyükleyicikullanıyorsanız, daha yeni bir düzen ilk düzen ile aynı sürümü içermeyebilir. Ancak, sabit bağlantı önyükleyicileri kullanırsanız (neredeyse) her zaman belirleyici bir dosya kümesi alırsınız.

Düzeni düzeltme

--fix ile aynı doğrulamayı gerçekleştirmek için --verify kullanın ve ayrıca tanımlanan sorunları düzeltmeye çalışın. --fix işleminin bir İnternet bağlantısı olması gerektiğinden, --fixçağırmadan ö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 --clean seçeneğini kullanabilirsiniz.

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 "version.txt" dosyasıdır. "catalog.json" dosyası, --clean seçeneğine geçirmeniz gereken eski katalog bildirimidir. 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 kataloglarda karar verdikten sonra, bu katalogların dosya yollarını sağlayarak --clean komutunu çalıştırın.

--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, ayrıca, 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 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 --useLatestInstaller parametresini önyükleyiciye iletebilirsiniz. Bu, düzenin kök dizininde bulunabilen layout.json dosyasında 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 layout.json dosyasını doğrudan düzenleyebilirsiniz.

  {
     "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
  
  }
  

layout.json dosyasında 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 kullanarak 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), layout.json dosyasını düzenleyin ve "UseLatestInstaller": true ayarını kaldırın.

Bu "UseLatestInstaller": true ayarı, düzenin response.json dosyasında da bulabilirsiniz, ancak düzenin her zaman en son yükleyiciye sahip olmasını sağlamak amacıyla orada dikkate alınmaz. response.json dosyası, istemcibir düzenden yüklendiğinde veya güncelleştirdiğinde istemci varsayılan yapılandırma seçeneklerini ayarlamak için kullanılır. "useLatestInstaller": true dosyasındaki bu özel layout.json ayarı, düzeninin içeriğinin en son yükleyiciyi içerdiğinden emin olmak için kullanılır; böylece istemci makineleri daha sonra düzenden en son yükleyiciyi alabilir.

Hata kodları

--wait parametresini kullandıysanız, işlemin sonucuna bağlı olarak %ERRORLEVEL% ortam değişkeni aşağıdaki değerlerden birine ayarlanır:

Değer	Sonuç
0	İşlem başarıyla tamamlandı
740	Yükseklik artırımı gerekiyor
1001	Visual Studio yükleyici işlemi çalışıyor
1003	Visual Studio kullanımda
1602	İşlem iptal edildi
1618	Başka bir yükleme çalışıyor
1641	İşlem başarıyla tamamlandı ve yeniden başlatma başlatıldı
3010	İşlem başarıyla tamamlandı, ancak yüklemenin kullanılabilmesi için yeniden başlatma gerekiyor
5003	Önyükleyici yükleyiciyi indiremedi
5004	İşlem iptal edildi
5005	Önyükleyici komut satırı ayrıştırma hatası
5007	İşlem engellendi - bilgisayar gereksinimleri karşılamıyor
8001	Arm işlemcisi kontrol hatası
8002	Arka plan indirme ön denetimi hatası
8003	Destek dışı seçilebilir hata
8004	Hedef dizin hatası
8005	Kaynak yüklerini doğrulama işlemi başarısız oldu
8006	Çalışan Visual Studio işlemleri
8010	İşletim Sistemi desteklenmiyor. Sistem Gereksinimleri 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

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'nde hem de Visual Studio IDE'de görünen Sorun Bildir aracını kullanmaktır. BT Yöneticisiyseniz ve Visual Studio yüklü değilse,burayaBT Yöneticisi geri bildirimi gönderebilirsiniz. Bu aracı kullandığınızda, sorunu tanılamamıza ve çözmemize yardımcı olabilecek Visual Studio Collect aracı günlükleri 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. Visual Studio Geliştirici Topluluğu'e bakın.

İlgili içerik

• Visual Studio yönetici kılavuzu
• Visual Studio'yu bir kurulum düzeninden istemci bilgisayarına dağıtma
• Visual Studio ağ tabanlı yüklemesini güncelleştirme
• Visual Studio yüklerken veya kullanırken ağ ile ilgili hataları giderme
• Visual Studio kurumsal dağıtımları için ilkeleri yapılandırma
• Visual Studio ürün yaşam döngüsünü ve hizmet
• Visual Studio yüklemek için komut satırı parametrelerini kullanma
• Visual Studio iş yükü ve bileşen kimliklerini
• Visual Studio çevrimdışı yükleme için gereken sertifikaları yükleme