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

  • Makale

Bu makalede, Visual Studio yüklemenizi otomatikleştirmenize yardımcı olacak bir yanıt dosyası oluşturmayı öğreneceksiniz. En yaygın olarak 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:

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önetici istrator'lar 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şturduysanız, düzen klasörünün kökünde varsayılan response.json bir dosya oluşturulur. Yönetici istrator'ların 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 olarak layout.vsconfig düzen dizinine 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ğını yapılandıran 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/16/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.16.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

{
  "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önetici istrator'lar bu dosyayı özel bir 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, aksi takdirde 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, çeşitli ortak iş yüklerini ve bileşenleri seçmek, hem İngilizce hem de Fransızca kullanıcı arabirimi dillerini seçmek ve güncelleştirme konumunun ağ tarafından barındırılan düzendeki kaynakları aramak üzere yapılandırılmasını sağlamak için bir Visual Studio 2019 Enterprise istemci yüklemesini başlatır. Visual Studio 2019 için güncelleştirme konumunun (channelUri) yalnızca ilk yükleme sırasında yapılandırılabildiğini ve en son yükleyicideki işlevselliği kullanmadığınız sürece gerçek sonrasında değiştirilemeyeceğini unutmayın. 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.16.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2019",
  "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 2022 Enterprise istemci yüklemesi başlatır:

{
  "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önetici uzmanıysanız ve Visual Studio yüklü değilse, BT'yi geri bildirim Yönetici buradan gönderebilirsiniz.
  • Visual Studio Geliştirici Topluluğu bir özellik önerin, ürün sorunlarını izleyin ve yanıtlar bulun.

İlgili içerik