Mengonfigurasi pengaturan default penginstalan menggunakan file respons

  • Artikel

Dalam artikel ini, Anda akan mempelajari cara membuat file respons yang membantu Mengotomatiskan penginstalan Visual Studio. Ini paling umum digunakan saat Anda menginstal Visual Studio dari tata letak.

File respons Visual Studio adalah file JSON yang kontennya berisi kustomisasi yang digunakan selama penginstalan awal Visual Studio ke klien. Isinya mencerminkan argumen dan parameter baris perintah. Gunakan file respons untuk opsi konfigurasi berikut:

Membuat file respons

File response.json biasanya dibuat ketika administrator membuat tata letak dan dapat ditemukan di folder akar tata letak. Namun, Anda dapat membuat file respons Anda sendiri menggunakan salah satu contoh di bawah ini.

Menentukan file respons

Jika administrator menyebarkan Visual Studio dengan memanggil bootstrapper dari tata letak, file respons yang ditemukan di direktori akar tata letak akan digunakan secara otomatis. Administrator juga dapat memilih untuk secara eksplisit menentukan file respons yang berbeda dengan menggunakan --in parameter , seperti dalam contoh berikut:

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

Konten file respons

File respons merangkum parameter baris perintah yang digunakan oleh Alat Penginstal Visual Studio, dan mengikuti aturan umum ini:

  • Jika parameter baris perintah tidak mengambil argumen (misalnya, --quiet, , , --passiveincludeRecommended, removeOosuseLatestInstaller, allowUnsignedExtensions, dll.), nilai dalam file respons harus true/false.
  • Jika parameter mengambil argumen (misalnya, --installPath <dir>, ), --config <*.vsconfig file>maka nilai dalam file respons harus berupa string.
  • Jika parameter mengambil argumen dan dapat muncul di baris perintah lebih dari sekali (misalnya, --add <id>), nilai dalam file respons harus berupa array string.

Parameter yang ditentukan pada baris perintah mengambil alih pengaturan yang disertakan dalam file respons, kecuali ketika parameter mengambil beberapa input (misalnya, --add). Ketika Anda memiliki beberapa input, input yang disediakan pada baris perintah digabungkan dengan pengaturan dari file respons.

Mengonfigurasi file respons yang digunakan saat menginstal dari tata letak

Jika Anda membuat tata letak dengan menggunakan --layout perintah , maka file default response.json akan dibuat di akar folder tata letak. Administrator diharapkan untuk memodifikasi dan menyesuaikan file respons dengan tepat sebelum menginstal ke komputer klien. Dengan begitu, mereka dapat mengontrol pengaturan konfigurasi awal klien.

Pengaturan konfigurasi dalam file hanya dirujuk response.json saat menjalankan bootstrapper (misalnya vs_enterprise.exe). Bootstrappers biasanya digunakan untuk melakukan penginstalan awal pada klien, tetapi terkadang mereka juga digunakan untuk memperbarui klien. response.json tidak pernah digunakan saat Anda meluncurkan alat penginstal secara lokal pada klien.

Jika administrator membuat tata letak parsial, maka file default response.json dalam tata letak hanya akan menentukan beban kerja dan bahasa yang disertakan dalam tata letak parsial.

Jika tata letak dibuat dengan meneruskan --config *.vsconfig file, maka *.vsconfig file akan disalin ke direktori tata letak sebagai layout.vsconfig dan file konfigurasi ini akan direferensikan dalam response.json file. Dengan cara ini, Anda dapat menggunakan file konfigurasi untuk menginisialisasi penginstalan klien yang berasal dari tata letak.

Pastikan untuk memberikan perhatian khusus pada pengaturan channelUri, yang mengonfigurasi di mana klien akan mencari pembaruan. Konfigurasi default adalah agar klien melihat server yang dihosting Microsoft di internet untuk pembaruan. Anda harus mengubah nilai channelUri dan mengarahkannya ke tata letak jika Anda ingin klien mendapatkan pembaruannya dari tata letak Anda. Contoh cara melakukannya dirinci di bawah ini. Anda selalu dapat mengubah di mana klien mencari pembaruan di masa mendatang dengan menjalankan alat penginstal pada klien dan memanggil modifySettings perintah.

Jika penginstalan klien tidak dilakukan menggunakan --quiet mode atau --passive , pengguna dapat mengambil alih default yang ditentukan dalam response.json dan selanjutnya memilih atau membatalkan pilihan beban kerja dan komponen tambahan untuk diinstal.

Peringatan

Berhati-hatilah saat mengedit properti dalam response.json yang ditentukan ketika tata letak dibuat, karena beberapa item diperlukan untuk penginstalan.

File dasar response.json dalam tata letak akan terlihat mirip dengan contoh berikut, kecuali bahwa productID akan mencerminkan edisi dalam tata letak Anda.

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

Saat Anda membuat atau memperbarui tata letak, file response.template.json juga dibuat. File ini berisi semua beban kerja, komponen, dan ID bahasa yang dapat digunakan. File ini disediakan sebagai templat untuk apa semua dapat disertakan dalam penginstalan kustom. Administrator dapat menggunakan file ini sebagai titik awal untuk file respons kustom. Cukup hapus ID untuk hal-hal yang tidak ingin Anda instal dan simpan dalam response.json file atau file respons Anda sendiri. Jangan sesuaikan file response.template.json atau perubahan Anda akan hilang setiap kali tata letak diperbarui.

Contoh konten file respons tata letak yang dikustomisasi

Contoh file berikut response.json akan menginisialisasi penginstalan klien Visual Studio 2019 Enterprise untuk memilih beberapa beban kerja dan komponen umum, untuk memilih bahasa UI Bahasa Inggris dan Prancis, dan agar lokasi pembaruan dikonfigurasi untuk mencari sumber dalam tata letak yang dihosting jaringan. Perhatikan bahwa untuk Visual Studio 2019, lokasi pembaruan (channelUri) hanya dapat dikonfigurasi selama penginstalan awal dan tidak dapat diubah setelah fakta kecuali Anda menggunakan fungsionalitas di penginstal terbaru. Lihat Konfigurasikan kebijakan untuk penyebaran perusahaan Visual Studio dan Konfigurasikan tata letak Anda untuk selalu menyertakan dan menyediakan penginstal terbaru untuk informasi tentang cara mengonfigurasi ini.

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

Dalam contoh berikut, response.json file menginisialisasi penginstalan klien Visual Studio 2022 Enterprise yang:

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

}

Peringatan

Jika Anda menggunakan tata letak intranet webhosted, Anda tidak dapat mengatur "noWeb": true dalam response.json dan mengharapkannya berfungsi. Ini akan menonaktifkan protokol http dan mencegah klien mengakses situs web.

Pemecahan Masalah

Jika Anda mengalami masalah dengan bootstrapper Visual Studio yang melemparkan kesalahan saat Anda memasangkannya dengan response.json file, lihat Memecahkan masalah kesalahan terkait jaringan saat Menginstal atau menggunakan halaman Visual Studio untuk informasi selengkapnya.

Dukungan atau pemecahan masalah

Kadang-kadang, hal-hal bisa salah. Jika penginstalan Visual Studio Anda gagal, lihat Memecahkan masalah penginstalan dan peningkatan Visual Studio untuk panduan langkah demi langkah.

Berikut adalah beberapa opsi dukungan lainnya:

  • Kami menawarkan opsi dukungan obrolan penginstalan (hanya bahasa Inggris) untuk masalah terkait penginstalan.
  • Laporkan masalah produk kepada kami melalui alat Laporkan Masalah yang muncul baik di Penginstal Visual Studio maupun di Ide Visual Studio. Jika Anda adalah Administrator TI dan belum menginstal Visual Studio, Anda dapat mengirimkan umpan balik Admin TI di sini.
  • Sarankan fitur, lacak masalah produk, dan temukan jawaban di Komunitas Pengembang Visual Studio.

Konten terkait