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üzeniüzerinden yüklediğinizde görü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 parametreleriniyansı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 kurulum yapılandırması *.vsconfig dosyasına başvurun.
• İstemcinin'dan güncelleştirmeleri alacağı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ındadestek dışı bileşenlerin otomatik olarak kaldırılması.

Yanıt dosyası oluşturma

response.json dosyası 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üzenö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 --in parametresini kullanarak açıkça farklı bir yanıt dosyası belirtmeyi de seçebilir:

shell

\\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 alırsa (örneğin, --installPath <dir>, --config <*.vsconfig file>), 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 görünebilirse (örneğin, --add <id>), yanıt dosyasındaki değer 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

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

response.json dosyasındaki yapılandırma ayarlarına yalnızca önyükleyici yürütü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 dosyası yalnızca kısmi düzene dahil edilen iş yüklerini ve dilleri belirtir.

Düzen bir --config *.vsconfig dosyası geçirilerek oluşturulursa, *.vsconfig dosyası layout.vsconfig olarak düzen dizinine kopyalanır ve bu yapılandırma dosyasına response.json dosyasında 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ı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üncellemelerini düzeninizden almalarını istiyorsanız, önce channelUri değerini değiştirmeniz, ardından bunu 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 modifySettings komutunu çağırarakistemcinin gelecekte güncelleştirmeleri nerede arayabileceğini değiştirebilirsiniz.

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

Uyarı

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

Bir düzendeki temel response.json dosyası, productID'nin düzeninizdeki sürümü yansıtması dışında aşağıdaki örneğe benzer görünmelidir.

Default

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

Default

{
  "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 response.json dosyasına 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ının 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 Enterprise istemci yüklemesini başlatır. Visual Studio 'ın kurumsal dağıtımları için ilkeleri yapılandırma ve Düzeninizi her zaman içerecek şekilde yapılandırma ve bunu yapılandırma hakkında bilgi için en son yükleyici sağlama konusuna bakın.

Example

{
  "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, response.json dosyası şu ş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
• güncelleme konumunu, HTTP üzerinde barındırılan düzende kaynakları aramak için yapılandırır
• İmzalanmamış uzantıların program aracılığıyla yüklenmesine izin verir
• İstemcigüncelleştirilirken destek dışı duruma geçirilmiş bileşenleri kaldırır. Destek dışı bileşenlerin listesini buradagörebilirsiniz.

Example

{
  "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ı bekleyemezsiniz. Bu, http protokolunu devre dışı bırakır ve istemcinin web sitesine erişmesini engeller.

Sorun giderme

Visual Studio önyükleyicisini bir response.json dosyasıyla eşleştirirken bir hata oluşturan bir sorunla karşılaşırsanız, daha fazla bilgi için Visual Studio'yu yüklerken veya kullanırken ağ ile ilgili hataları giderme sayfası ,'ye bakı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 yükleme sohbeti (yalnızca İngilizce) destek seçeneğini kullanın.
• Hem Visual Studio Yükleyicisi'nde hem de Visual Studio IDE'de görünen Sorun Bildir aracını kullanarak ürün sorunlarını bize bildirin. BT Yöneticisiyseniz ve Visual Studio yüklü değilse, BT Yöneticisi geri bildirimi gönderebilirsiniz.
• Visual Studio Geliştirici Topluluğu 'da bir özellik önerin, ürün sorunlarını takip edin ve yanıtlar bulun.

İlgili içerik

• Visual Studio Yöneticileri Kılavuzu
• Visual Studio ağ yüklemesi oluşturma ve sürdürme
• Visual Studio'yu bir kurulumdan istemci bilgisayarına dağıtma
• Kuruluş dağıtımları için ilkeleri yapılandırma
• Visual Studio iş yükü ve bileşen kimliklerini
• Visual Studio yüklerken veya kullanırken ağ ile ilgili hataları giderme