Mengonfigurasi pengaturan default penginstalan menggunakan file respons
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:
- Konfigurasikan beban kerja, komponen, atau bahasa mana yang harus dipilih secara default selama penginstalan awal.
- Referensikan file konfigurasi
*.vsconfig
penginstalan yang telah distandarkan oleh tim Anda. - Tentukan dari mana klien harus menerima pembaruan. Contohnya termasuk server default yang dihosting Microsoft di internet atau dari lokasi tata letak jaringan yang dikontrol admin.
- Penghapusan otomatis komponen di luar dukungan selama pembaruan.
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
, , ,--passive
includeRecommended
,removeOos
useLatestInstaller
,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:
- Menggunakan file konfigurasi *.vsconfig yang menentukan beban kerja, komponen, dan ekstensi apa yang akan diinstal
- Memilih bahasa UI Bahasa Inggris dan Prancis
- Mengonfigurasi lokasi pembaruan untuk mencari sumber dalam tata letak yang dihosting http
- Memungkinkan pemuatan terprogram ekstensi yang tidak ditandatangani
- Menghapus komponen yang telah beralih ke status di luar dukungan pada saat memperbarui klien. Lihat daftar komponen di luar dukungan di sini.
{
"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
- Panduan Administrator Visual Studio
- Membuat dan memelihara penginstalan jaringan Visual Studio
- Menyebarkan Visual Studio dari tata letak ke komputer klien
- Mengonfigurasi kebijakan untuk penyebaran perusahaan
- Beban kerja Visual Studio dan ID komponen
- Memecahkan masalah kesalahan terkait jaringan saat Anda menginstal atau menggunakan Visual Studio