Mengimpor atau mengekspor konfigurasi penginstalan

Anda dapat menggunakan file konfigurasi penginstalan untuk mengonfigurasi penginstalan Visual Studio apa. Untuk melakukannya, ekspor beban kerja, komponen, dan informasi ekstensi Marketplace ke dalam file .vsconfig dengan menggunakan Alat Penginstal Visual Studio. Setelah Anda memiliki file .vsconfig, Anda dapat lebih menyempurnakannya secara manual dan menambahkan atau menghapus item tambahan. Struktur dan sintaks file .vsconfig dijelaskan di bagian format file vsconfig.

Anda juga dapat mengimpor file konfigurasi ke penginstalan Visual Studio baru atau yang sudah ada, menggunakannya untuk membuat atau memodifikasi tata letak atau penginstalan offline, memasukkannya ke direktori solusi atau repositori dan memicu penginstalan komponen yang hilang, dan membagikannya dengan orang lain.

Mengekspor konfigurasi menggunakan Alat Penginstal Visual Studio

Anda dapat mengekspor file konfigurasi penginstalan dari instans Visual Studio yang diinstal sebelumnya.

Nota

Dimulai dengan Pratinjau Visual Studio 2022 versi 17.10, Anda dapat mengekspor ekstensi Visual Studio Marketplace yang dimuat dalam konteks seluruh instans ke dalam file .vsconfig. Jika Anda ingin fungsionalitas export dapat mengekspor jenis ekstensi lain seperti yang dimuat dari berbagi jaringan atau yang dimuat dalam konteks pengguna, beri tahu kami.

Menggunakan UI Alat Penginstal Visual Studio

1. Dari menu Mulai, buka Penginstal Visual Studio.

2. Pada kartu produk, pilih tombol lainnya, lalu pilih Ekspor konfigurasi.

   

3. Telusuri ke atau ketik lokasi di mana Anda ingin menyimpan file .vsconfig, lalu pilih Tinjau detail.

   

4. Pastikan bahwa pilihan Anda akurat, lalu pilih Ekspor.

   

Mengekspor file konfigurasi secara terprogram

Anda dapat mengekspor file konfigurasi instans Visual Studio tertentu secara terprogram dengan menggunakan kata kerja export. Untuk informasi selengkapnya, lihat Menggunakan parameter baris perintah untuk menginstal, memperbarui, dan mengelola Visual Studio.

Mengimpor konfigurasi menggunakan Alat Penginstal Visual Studio

Anda dapat mengimpor file konfigurasi penginstalan ke dalam instans Visual Studio yang diinstal sebelumnya, atau Anda dapat menggunakannya untuk menginisialisasi penginstalan baru Visual Studio. Mengimpor file konfigurasi ke Visual Studio menginstal apa pun yang tercantum dalam file konfigurasi yang belum diinstal.

Menggunakan UI Alat Penginstal Visual Studio

Saat Anda siap mengimpor file konfigurasi penginstalan, ikuti langkah-langkah berikut.

1. Buka Alat Penginstal Visual Studio dan tutup Visual Studio. Sebagian besar operasi Alat Penginstal mengharuskan produk Visual Studio itu sendiri ditutup.

2. Pada tab Terinstal atau tab Tersedia, pilih Lebih>Impor konfigurasi pada kartu produk Visual Studio.

3. Temukan file .vsconfig yang ingin Anda impor, lalu pilih Tinjau detail.

4. Verifikasi bahwa pilihan Anda akurat, lalu pilih Ubah.

Gunakan file konfigurasi secara terprogram untuk menambahkan komponen ke penginstalan yang ada

Anda dapat menggunakan parameter --config untuk menginisialisasi atau mengubah penginstalan yang ada dan menambahkan komponen. Contoh berikut menggunakan alat penginstal pada perangkat klien untuk modify instalasi yang sudah ada.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

Nota

Untuk menambahkan komponen ke penginstalan yang ada dengan menggunakan file .vsconfig, Anda perlu menggunakan modify dan tidakupdate. Perintah update hanya memperbarui komponen yang terinstal yang ada ke versi terbaru. Untuk mempelajari selengkapnya tentang berbagai operasi penginstal, lihat dokumentasi Instal Visual Studio dari baris perintah.

Menggunakan file konfigurasi untuk menginisialisasi konten tata letak

Gunakan bootstrapper yang benar yang sesuai dengan versi dan edisi Visual Studio yang Anda inginkan, buka Command Prompt sebagai administrator dan jalankan perintah berikut untuk menggunakan parameter --config untuk mengonfigurasi konten tata letak. Untuk informasi selengkapnya tentang menggunakan file .vsconfig untuk menginisialisasi dan menginstal dari tata letak, lihat Menggunakan file konfigurasi untuk menginisialisasi konten tata letak.

vs_enterprise.exe --layout "c:\localVSlayout" --config "c:\myconfig.vsconfig" --lang en-US

Menggunakan file konfigurasi untuk menginstal komponen yang hilang secara otomatis

Jika Anda menyimpan file .vsconfig ke direktori akar solusi Anda lalu membuka solusi, Visual Studio secara otomatis mendeteksi komponen yang hilang dan meminta Anda untuk menginstalnya.

Nota

Jika file .vsconfig Anda berisi ekstensi, maka saat ini, hanya ekstensi yang dihosting di Visual Studio Marketplace memicu otomatis yang hilang deteksi dan penginstalan. Jika Anda ingin logika ini menyertakan ekstensi yang diinstal dari lokasi non-Marketplace, silakan memberikan detail tentang skenario Anda di sini.

Anda juga dapat membuat file .vsconfig langsung dari Solution Explorer.

1. Klik kanan pada file solusi Anda.

2. Pilih Tambahkan File Konfigurasi Penginstalan>.

3. Konfirmasikan lokasi tempat Anda ingin menyimpan file .vsconfig, lalu pilih Tinjau detail.

4. Pastikan Anda sudah memiliki beban kerja dan komponen yang diinginkan, lalu pilih Ekspor.

Kami juga membuat utilitas sumber terbuka yang menemukan file konfigurasi penginstalan Visual Studio .vsconfig secara rekursif di hilir dan menggabungkannya semua. Untuk mempelajari selengkapnya tentang utilitas ini, lihat VSConfigFinder di GitHub.

format file vsconfig yang dimaksud

File .vsconfig adalah format file json yang berisi bagian komponen dan secara opsional bagian ekstensi. Bagian komponen berisi beban kerja dan komponen dan terlihat seperti ini:

{
  "version": "1.0", 
  "components": [ 
    "Microsoft.VisualStudio.Component.CoreEditor", 
    "Microsoft.VisualStudio.Workload.CoreEditor", 
    "Microsoft.VisualStudio.Component.NuGet" 
    ] 
}

Ekstensi

Mulai Visual Studio 2022 versi 17.9, Anda dapat menentukan ekstensi dalam file .vsconfig dan menggunakan Alat Penginstal Visual Studio untuk memuatnya di seluruh komputer sehingga tersedia untuk semua pengguna. Mulai dari Visual Studio 2022 versi Pratinjau 17.10, Anda dapat menggunakan Penginstal Visual Studio untuk export ekstensi Visual Studio Marketplace ke dalam file .vsconfig yang dimuat dalam konteks luas instans seperti yang dijelaskan sebelumnya .

Ada beberapa kekurangan yang diketahui dengan dukungan ekstensi dalam file konfigurasi.

• Karena ekstensi yang dimuat melalui file konfigurasi diinstal ke seluruh instans, Anda harus memiliki izin admin atau telah diberikan kontrol penginstal melalui kebijakan AllowStandardUserControl untuk dapat menginstalnya. Ekstensi apapun yang sebelumnya diinstal oleh Visual Studio Extension Manager memiliki kemampuan untuk diinstal per pengguna, bukan untuk seluruh instans, dan pengguna tidak perlu memiliki izin admin untuk menginstal.
• Alat Penginstal Visual Studio saat ini hanya mendukung impor jenis ekstensi tertentu, seperti yang terkandung dalam paket *.vsix atau yang tidak terlalu rumit. Jika Anda memiliki ekstensi yang tidak dimuat dengan benar melalui file konfigurasi, harap beri tahu kami melalui usulan baru di Komunitas Pengembang .
• Hanya ekstensi yang dihosting di Visual Studio Marketplace memicu otomatis yang hilang deteksi dan penginstalan jika file .vsconfig berada dalam direktori solusi. Jika Anda ingin logika ini menyertakan ekstensi yang diinstal dari lokasi non-Marketplace, harap berikan detail tentang skenario Anda di sini.
• Jika Anda secara terprogram menggunakan file .vsconfig untuk menambahkan ekstensi, maka Anda juga perlu menggunakan parameter --allowUnsignedExtensions untuk memungkinkan ekstensi yang tidak ditandatangani dimuat dalam konteks --passive atau --quiet. Jika Anda menginstal dari tata letak, Anda dapat menambahkan sintaks "allowUnsignedExtensions" : true ke dalam file response.json Anda untuk mencapai efek yang sama.

Semua ekstensi di seluruh instans diperbarui secara otomatis sekitar sekali sehari melalui tugas terjadwal. Untuk informasi selengkapnya, lihat Pembaruan ekstensi otomatis.

Format file .vsconfig yang menyertakan ekstensi akan terlihat seperti ini.

{
  "version": "1.0", 
  "components": [ 
    // Whatever components you want to install come here, in quotes, separated by commas.
    // You can use the installer to select the components you want to install and then export them,
    // Or you can specify the ones you want according to the [component-id's](https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids).
    // This array should not be null! If you don't want to install any component, just leave the array empty.
  ],
  "extensions": [
    // The extensions you want to install are specified in this section, in quotes, separated by commas.
    // Extensions are optional in .vsconfig, so if you don't want any, you can delete the entire extensions section.
    // The extensions must be in a *.vsix package
    // Make sure that the extensions you specify are designed to work with that version of Visual Studio.
    // examples below
    "https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ImageOptimizer64bit",   //unsigned extension
    "https://marketplace.visualstudio.com/items?itemName=vsext.RegexMatchVisualizer",  //signed extension
    "c:\\mylocaldrive\\someextension.vsix",
    "\\\\server\\share\\myextension.vsix",
    "https://myweb/anotherextension.vsix"
  ]
}

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:

• Gunakan opsi dukungan obrolan penginstalan (hanya bahasa Inggris) untuk masalah terkait penginstalan.
• Laporkan masalah produk kepada kami dengan menggunakan 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 .
• Sarankan fitur, lacak masalah produk, dan temukan jawaban di Komunitas Pengembang Visual Studio.

Konten terkait

• Mengonfigurasi Visual Studio di seluruh organisasi Anda dengan .vsconfig
• Membuat penginstalan jaringan Visual Studio
• Memperbarui klien Visual Studio yang diinstal dari tata letak
• Mengontrol pembaruan untuk penyebaran Visual Studio berbasis jaringan
• Mengonfigurasi kebijakan-kebijakan untuk implementasi perusahaan