Yanıt dosyası kullanarak yükleme varsayılan ayarlarını yapılandırma

Bu makalede, Visual Studio yüklemenizi otomatikleştirmenize yardımcı olacak bir yanıt dosyası oluşturmayı öğreneceksiniz. En yaygın kullanım, Visual Studio'yu bir düzenden yüklediğinizde kullanılır.

Visual Studio yanıt dosyası, içeriği istemciye Visual Studio'nun ilk yüklenmesi sırasında kullanılan özelleştirmeleri içeren bir JSON dosyasıdır. İçeriği komut satırı bağımsız değişkenlerini ve parametrelerini yansıtır. Aşağıdaki yapılandırma seçenekleri için yanıt dosyasını kullanın:

• İlk yükleme sırasında varsayılan olarak hangi iş yüklerinin, bileşenlerin veya dillerin seçilmesi gerektiğini yapılandırın.
• Ekibinizin standartlaştırdığı bir yükleme yapılandırma *.vsconfig dosyasına başvurun.
• İstemcinin güncelleştirmeleri nereden alacağını belirtin. Örnek olarak, İnternet'te veya yönetici tarafından denetlenen bir ağ düzeni konumundan microsoft tarafından barındırılan varsayılan sunucular verilebilir.
• Güncelleştirmeler sırasında destek dışı bileşenlerin otomatik olarak kaldırılması.

Yanıt dosyası oluşturma

Dosya response.json genellikle bir yönetici bir düzen oluşturduğunda oluşturulur ve düzenin kök klasöründe bulunabilir. Ancak, aşağıdaki örneklerden birini kullanarak kendi yanıt dosyanızı oluşturabilirsiniz.

Yanıt dosyasını belirtme

Bir yönetici bir düzenden önyükleyiciyi çağırarak Visual Studio'yu dağıtırsa, düzenin kök dizininde bulunan yanıt dosyası otomatik olarak kullanılır. Yöneticiler, aşağıdaki örnekte olduğu gibi parametresini --in kullanarak açıkça farklı bir yanıt dosyası belirtmeyi de seçebilir:

\\server\share\layoutdirectory\vs_enterprise.exe --in custom_response_file.json

Yanıt dosyası içeriği

Yanıt dosyası, Visual Studio Yükleyicisi tarafından kullanılan komut satırı parametrelerini kapsüller ve şu genel kuralları izler:

• Komut satırı parametresi bağımsız değişken almazsa (örneğin, --quiet, --passive, includeRecommended, removeOos, useLatestInstaller, , allowUnsignedExtensionsvb.), yanıt dosyasındaki değer true/false olmalıdır.
• Parametre bir bağımsız değişken (örneğin, --installPath <dir>, --config <*.vsconfig file>) alırsa, yanıt dosyasındaki değer bir dize olmalıdır.
• Parametre bir bağımsız değişken alırsa ve komut satırında birden çok kez (örneğin, ) görüntülenebilirse, --add <id>yanıt dosyasındaki değer bir dize dizisi olmalıdır.

Komut satırında belirtilen parametreler, parametrelerin birden çok giriş alması (örneğin, --add) dışında yanıt dosyasına dahil edilen ayarları geçersiz kılar. Birden çok girişiniz olduğunda, komut satırında sağlanan girişler yanıt dosyasındaki ayarlarla birleştirilir.

Bir düzenden yüklerken kullanılan yanıt dosyasını yapılandırma

komutunu kullanarak --layout bir düzen oluşturursanız, düzen klasörünün kökünde varsayılan response.json bir dosya oluşturulur. Yöneticilerin bir istemci makinesine yüklemeden önce yanıt dosyasını uygun şekilde değiştirmesi ve özelleştirmesi beklenir. Bu şekilde istemcinin ilk yapılandırma ayarlarını denetleyebilirler.

Dosyadaki yapılandırma ayarlarına response.json yalnızca önyükleyici yürütülürken başvurulur (örneğin, vs_enterprise.exe). Önyükleyiciler genellikle istemcide ilk yüklemeyi gerçekleştirmek için kullanılır, ancak bazen istemciyi güncelleştirmek için de kullanılırlar. response.json, yükleyiciyi istemcide yerel olarak başlattığınızda hiçbir zaman kullanılmaz.

Yönetici kısmi bir düzen oluşturduysa, düzendeki varsayılan response.json dosya yalnızca kısmi düzene dahil edilen iş yüklerini ve dilleri belirtir.

Düzen bir --config *.vsconfig dosya geçirilerek oluşturulursa, *.vsconfig dosya düzen dizinine olarak layout.vsconfig kopyalanır ve bu yapılandırma dosyasına dosyada response.json başvurulur. Bu şekilde, bir düzenden gelen istemci yüklemelerini başlatmak için yapılandırma dosyalarını kullanabilirsiniz.

İstemcinin güncelleştirmeleri nerede arayacağı yapılandırılan channelUri ayarına özellikle dikkat edin. Varsayılan yapılandırma, istemcinin güncelleştirmeler için İnternet'te Barındırılan Microsoft sunucularına bakmalıdır. İstemcilerin güncelleştirmelerini düzeninizden almalarını istiyorsanız channelUri değerini değiştirmeniz ve düzeninize yönlendirmeniz gerekir. Bunun nasıl yapıldığını gösteren örnekler aşağıda ayrıntılı olarak verilmiştir. İstemcide yükleyiciyi yürütüp komutu çağırarak modifySettings istemcinin gelecekte güncelleştirmeleri nerede arayabileceğini istediğiniz zaman değiştirebilirsiniz.

İstemci yüklemesi veya modu kullanılarak --quiet yapılmazsa, kullanıcılar içinde response.json belirtilen varsayılanları geçersiz kılabilir ve yüklenecek ek iş yüklerini ve bileşenleri daha fazla seçebilir veya --passive seçimini kaldırabilir.

Uyarı

Yükleme için bazı öğeler gerektiğinden, düzen oluşturulduğunda tanımlanan içindeki özellikleri response.json düzenlerken çok dikkatli olun.

Bir düzendeki temel response.json dosya aşağıdaki örneğe benzer görünmelidir, ancak productID düzeninizdeki sürümü yansıtır.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release.ltsc.17.0/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release.LTSC.17.0",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

Bir düzen oluşturduğunuzda veya güncelleştirdiğinizde, bir response.template.json dosyası da oluşturulur. Bu dosya, kullanılabilecek tüm iş yükü, bileşen ve dil kimliklerini içerir. Bu dosya, özel bir yüklemede yer alan tüm dosyalar için bir şablon olarak sağlanır. Yöneticiler bu dosyayı özel yanıt dosyası için başlangıç noktası olarak kullanabilir. Yüklemek istemediğiniz öğelerin kimliklerini kaldırın ve dosyaya response.json veya kendi yanıt dosyanıza kaydedin. response.template.json dosyasını özelleştirmeyin; düzen her güncelleştirildiğinde değişiklikleriniz kaybolur.

Örnek özelleştirilmiş düzen yanıt dosyası içeriği

Aşağıdaki response.json dosya örneği, hem İngilizce hem de Fransızca kullanıcı arabirimi dillerini seçmek ve güncelleştirme konumunun ağ tarafından barındırılan bir düzende kaynakları aramak üzere yapılandırılmasını sağlamak üzere birkaç ortak iş yükü ve bileşeni seçmek için bir Visual Studio Enterprise istemci yüklemesi başlatır. Bunu yapılandırma hakkında bilgi için Visual Studio'nun kurumsal dağıtımları için ilkeleri yapılandırma ve Düzeninizi her zaman dahil etmek ve sağlamak üzere yapılandırma konusuna bakın.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2022",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,
  "useLatestInstaller": true,
  "removeOos": true,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ],

    "add": [
        "Microsoft.VisualStudio.Workload.ManagedDesktop",
        "Microsoft.VisualStudio.Workload.Data",
        "Microsoft.VisualStudio.Workload.NativeDesktop",
        "Microsoft.VisualStudio.Workload.NetWeb",
        "Microsoft.VisualStudio.Workload.Office",
        "Microsoft.VisualStudio.Workload.Universal",
        "Component.GitHub.VisualStudio"
    ]
}

Aşağıdaki örnekte, dosya şu response.json şekilde bir Visual Studio Enterprise istemci yüklemesi başlatır:

• Yüklenecek iş yüklerini, bileşenleri ve uzantıları tanımlayan bir yapılandırma *.vsconfig dosyası kullanır
• hem İngilizce hem de Fransızca kullanıcı arabirimi dillerini seçer
• Http'de barındırılan düzende kaynakları aramak için güncelleştirme konumunu yapılandırıyor
• İmzasız uzantıların program aracılığıyla yüklenmesine izin verir
• İstemci güncelleştirilirken destek dışı durumuna geçiş yapılan bileşenleri kaldırır. Destek dışı bileşenlerin listesine buradan bakın.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "http://MyCompanyIntranetSite/VS2022Enterprise/ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",
  "arch": "x64",
  "config": ".\\Layout.vsconfig"
  "installPath": "C:\\VS2022",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,
  "useLatestInstaller": true,
  "removeOos": true,
  "allowUnsignedExtensions": true,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ]

}

Uyarı

İntranet web barındırma düzenlerini kullanıyorsanız, response.json "noWeb": true ayarını yapamaz ve çalışmasını bekleyebilirsiniz. Bu, http protokolunu devre dışı bırakır ve istemcinin web sitesine erişmesini engeller.

Sorun giderme

Visual Studio önyükleyicisinin bir dosyayla eşleştirirken hata oluşturmasıyla ilgili bir response.json sorunla karşılaşırsanız, daha fazla bilgi için bkz . Visual Studio'yu yüklerken veya kullanırken ağ ile ilgili hataları giderme sayfası.

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.

İlgili içerik

• Visual Studio Yöneticiler Kılavuzu
• Visual Studio'nun ağ yüklemesini oluşturma ve sürdürme
• Visual Studio'yu bir düzenden istemci makinesine dağıtma
• Kurumsal dağıtımlar için ilkeleri yapılandırma
• Visual Studio iş yükü ve bileşen kimlikleri
• Visual Studio'yu yüklerken veya kullanırken ağ ile ilgili hataları giderme