Membuat dan memelihara penginstalan jaringan Visual Studio

Terkadang administrator perusahaan ingin membuat cache penginstalan privat (juga dikenal sebagai "tata letak") yang berisi file Visual Studio yang dapat disebarkan ke komputer klien dalam organisasi.

Membuat tata letak berguna dalam situasi berikut:

  • Pengguna memiliki izin terbatas
  • Komputer klien memiliki akses terbatas ke internet
  • Organisasi ingin menstandarkan pada versi tertentu dari toolset pengembang

Kami merancang Visual Studio sehingga administrator dapat membuat dan memelihara tata letak dan menyimpannya di berbagi jaringan internal dan secara opsional membuatnya tersedia di intranet organisasi. Tata letak berfungsi sebagai lokasi sumber untuk semua file Visual Studio yang diperlukan untuk penginstalan klien awal dan pembaruan berikutnya.

Informasi di halaman ini dikelompokkan menjadi tiga bagian utama:

  • Buat tata letak: menjelaskan cara membuat tata letak dengan konten produk yang benar, mengonfigurasi pengaturan default, menyimpannya di berbagi file jaringan, dan membuatnya tersedia di intranet Anda.
  • Pertahankan tata letak: informasi tentang cara terbaik memperbarui versi produk tata letak, atau mengubah konten produk tata letak, pengaturan saluran, versi penginstal, dan ukuran folder.
  • Bantuan dan Dukungan: tempat meminta bantuan

Membuat tata letak

Menyiapkan lokasi penyimpanan berbagi file jaringan

Pertama, Anda perlu menentukan di mana Anda akan menyimpan paket Visual Studio yang diunduh. Jika Anda memiliki beberapa edisi Visual Studio yang digunakan dalam perusahaan Anda (misalnya, Visual Studio 2022 Professional dan Visual Studio 2022 Enterprise), Anda harus membuat tata letak terpisah untuk setiap edisi. Membuat tata letak terpisah untuk setiap edisi dapat mengonsumsi banyak ruang disk, terutama ketika Anda mempertimbangkan bahwa pembaruan tata letak juga menggunakan ruang disk.

Jalur tata letak harus kurang dari 80 karakter; beberapa organisasi berhasil menggunakan tautan simbolis untuk mengatasi batasan 80 karakter.

Unduh bootstrapper Visual Studio untuk membuat tata letak

Unduh bootstrapper yang benar untuk edisi Visual Studio yang Anda inginkan dan salin ke direktori yang ingin Anda layani sebagai repositori tata letak. Setelah tata letak dibuat, Anda kemudian dapat menggunakannya untuk menginstal Visual Studio ke komputer klien apa pun. Bootstrapper adalah executable yang Anda gunakan untuk membuat, memperbarui, dan melakukan operasi tata letak lainnya. Anda harus memiliki koneksi internet dan izin administrator untuk menyelesaikan langkah ini.

Bootstrapper berikut selalu menginstal versi terbaru visual Studio 2019 yang paling aman, tidak peduli kapan Anda menjalankannya. Atau, jika Anda ingin membuat atau memperbarui tata letak ke versi Visual Studio 2019 tertentu, buka halaman Rilis Visual Studio 2019 yang memiliki tautan ke bootstrapper versi tetap untuk setiap rilis layanan, dan unduh yang Anda inginkan. Salin ke direktori yang ingin Anda layani sebagai lokasi sumber tata letak.

Edisi Bootstrapper
Visual Studio 2019 Enterprise versi 16.11 vs_enterprise.exe
Visual Studio 2019 Professional versi 16.11 vs_professional.exe
Alat Build Visual Studio 2019 versi 16.11 vs_buildtools.exe

Bootstrapper lain yang didukung termasuk vs_teamexplorer.exe, vs_testagent.exe, dan vs_testcontroller.exe.

Bootstrapper berikut selalu menginstal versi terbaru visual Studio 2022 yang paling aman di saluran Saat ini, tidak peduli kapan Anda menjalankannya. Atau, jika Anda ingin membuat atau memperbarui tata letak ke versi tertentu atau saluran tertentu dari Visual Studio 2022, unduh bootstrapper versi hijau dan tetap untuk rilis layanan untuk saluran yang Anda inginkan dari Riwayat Rilis Visual Studio 2022. Salin ke direktori yang ingin Anda layani sebagai lokasi sumber tata letak.

Edisi Bootstrapper
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Komunitas Visual Studio 2022 vs_community.exe
Alat Build Visual Studio 2022 vs_buildtools.exe

Tip

Jika sebelumnya Anda mengunduh file bootstrapper dan ingin memverifikasi versinya, berikut caranya. Di Windows, buka File Explorer, klik kanan file bootstrapper, pilih Properti, pilih tab Detail , lalu lihat Nomor versi produk . Untuk mencocokkan angka tersebut dengan rilis Visual Studio, lihat tabel di bagian bawah halaman Rilis Visual Studio 2019.

Tip

Jika sebelumnya Anda mengunduh file bootstrapper dan ingin memverifikasi versi apa yang akan diinstalnya, berikut caranya. Di Windows, buka File Explorer, klik kanan file bootstrapper, pilih Properti lalu pilih tab Detail . Bidang Versi produk menjelaskan saluran dan versi yang akan diinstal bootstrapper. Nomor versi harus selalu dibaca sebagai "versi layanan terbaru dari apa yang ditentukan", dan saluran diasumsikan sebagai Saat Ini kecuali ditentukan secara eksplisit. Jadi, bootstrapper dengan versi Produk LTSC 17.0 menginstal rilis layanan 17.0.x terbaru yang tersedia di saluran 17.0 LTSC. Bootstrapper dengan versi Produk yang mengatakan Visual Studio 2022 menginstal versi layanan terbaru Visual Studio 2022 di saluran Saat ini.

Mengunduh paket Visual Studio

Anda harus memiliki koneksi internet untuk menyelesaikan langkah ini.

Buka prompt perintah yang ditingkatkan, navigasikan ke direktori tempat Anda mengunduh bootstrapper, dan gunakan parameter bootstrapper seperti yang didefinisikan dalam menggunakan parameter baris perintah untuk menginstal halaman Visual Studio untuk membuat dan memelihara tata letak jaringan Anda. Contoh berikut mengilustrasikan cara umum untuk membuat tata letak awal. Contoh lainnya dapat ditemukan pada contoh parameter baris perintah untuk halaman penginstalan Visual Studio.

Tata letak awal lengkap untuk lokal bahasa tunggal memerlukan sekitar 40 GB ruang disk untuk Komunitas Visual Studio dan sekitar 50 GB untuk Visual Studio Enterprise. Lokal bahasa tambahan memerlukan masing-masing sekitar setengah GB.

Pendekatan yang direkomendasikan adalah membuat tata letak awal Visual Studio dengan semua beban kerja dan bahasa yang sesuai dan menyimpan paket ke direktori tata letak di server jaringan. Dengan begitu, setiap penginstalan klien memiliki akses ke seluruh penawaran produk Visual Studio dan kemampuan untuk menginstal subset apa pun. Untuk membuat tata letak Lengkap Visual Studio, jalankan perintah berikut dari direktori yang Anda rencanakan untuk menghosting tata letak jaringan pada:

vs_enterprise.exe --layout c:\VSLayout

Pastikan tata letak Anda didasarkan pada saluran yang benar

Penting untuk memastikan bahwa tata letak jaringan didasarkan pada saluran yang benar, karena ini adalah salah satu kriteria yang diperbarui administrator, jika disebarkan di seluruh organisasi, gunakan untuk mengidentifikasi instans klien mana yang harus diperbarui. Misalnya, jika tata letak Anda didasarkan pada saluran VisualStudio.17.Release.LTSC.17.0 dan jika klien Anda dikonfigurasi untuk menerima pembaruan dari server yang dihosting Microsoft, pembaruan keamanan apa pun yang tersedia di saluran LTSC 17.0 tersedia untuk klien yang diinstal atau diperbarui dari tata letak tersebut.

Bootstrappers yang tercantum sebelumnya didasarkan pada saluran Saat Ini. Untuk membuat tata letak berdasarkan salah satu saluran LTSC, dapatkan bootstrapper saluran yang benar dari halaman Riwayat Rilis Visual Studio 2022, salin ke folder tata letak Anda, dan gunakan untuk membuat atau memperbarui tata letak.

Mengonfigurasi konten tata letak

Ada beberapa opsi yang dapat Anda gunakan untuk menyesuaikan isi tata letak jaringan Anda. Anda dapat membuat tata letak parsial yang hanya berisi sekumpulan lokal bahasa tertentu, beban kerja, komponen, dan dependensi yang direkomendasikan atau opsional. Tata letak parsial berguna jika Anda tahu bahwa Anda hanya akan menyebarkan subset beban kerja ke stasiun kerja klien. Parameter baris perintah umum untuk menyesuaikan tata letak meliputi:

  • --add untuk menentukan beban kerja atau ID komponen.
    Jika --add digunakan, hanya beban kerja dan komponen yang ditentukan dengan --add yang diunduh. Jika --add tidak digunakan, semua beban kerja dan komponen diunduh.
  • --includeRecommended untuk menyertakan semua komponen yang direkomendasikan untuk ID beban kerja yang ditentukan.
  • --includeOptional untuk menyertakan semua komponen opsional untuk ID beban kerja yang ditentukan.
  • --config untuk menggunakan *.vsconfig file untuk menentukan beban kerja, komponen, atau ekstensi yang harus disertakan atau dirujuk oleh tata letak. Pastikan Anda menentukan jalur lengkap file konfigurasi.
  • --lang untuk menentukan lokal bahasa.

Berikut adalah beberapa contoh cara membuat tata letak jaringan kustom.

  • Untuk membuat tata letak dengan komponen yang diperlukan untuk semua beban kerja hanya dalam satu bahasa, jalankan:

    vs_enterprise.exe --layout C:\VSLayout --lang en-US
    
  • Untuk membuat tata letak dengan komponen yang diperlukan untuk semua beban kerja dalam beberapa bahasa, jalankan:

    vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
    
  • Untuk membuat tata letak dengan satu beban kerja dan semua komponen yang diperlukan dan direkomendasikan untuk beban kerja tersebut dalam semua bahasa, jalankan:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
    
  • Untuk membuat tata letak dengan dua beban kerja dan satu komponen opsional dalam tiga bahasa, jalankan:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
    

Menggunakan file konfigurasi untuk menginisialisasi konten tata letak

Anda dapat menggunakan --config parameter untuk meneruskan *.vsconfig file. Pastikan Anda menentukan jalur lengkap file konfigurasi. *.vsconfig Menggunakan file selama pembuatan tata letak menyesuaikan dan membatasi konten tata letak jaringan ke apa yang ditentukan dalam file konfigurasi. File konfigurasi disalin ke direktori tata letak dan diganti namanya menjadi layout.vsconfig.

Ekstensi apa pun yang ditentukan dalam *.vsconfig file tidak disalin langsung ke tata letak. Sebagai gantinya, file tata letak response.json berisi referensi ke file yang baru dibuat layout.vsconfig , menentukan lokasi penginstalan untuk ekstensi klien. Jika Anda menginstal ekstensi yang tidak ditandatangani secara digital, pastikan untuk mengedit response.json untuk menambahkan "allowUnsignedExtensions": true. Lihat response.json contoh konten.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Menyalin tata letak ke berbagi jaringan

Anda perlu menghosting tata letak pada berbagi jaringan sehingga dapat diakses dari komputer klien. Jika Anda membuat tata letak pada komputer lokal, maka Anda perlu menyalinnya ke lokasi file jaringan. Contoh berikut menggunakan xcopy. Anda juga dapat menggunakan robocopy, jika Anda mau. Contoh:

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Mengonfigurasi default penginstalan klien awal untuk tata letak ini

File yang disebut response.json dibuat di folder akar tata letak. File yang dapat disesuaikan ini menyediakan pengaturan default awal untuk dikonfigurasi pada klien, ketika klien awalnya menginstal dari tata letak. Opsi konfigurasi umum mencakup kemampuan untuk mengonfigurasi:

  • Beban kerja, komponen, atau bahasa mana yang harus diinstal secara default pada klien
  • Jika komponen yang direkomendasikan juga harus diinstal
  • Jika klien harus menghormati file penginstalan *.vsconfig
  • Dari mana klien harus menerima pembaruan
  • Jika komponen di luar dukungan harus dihapus selama pembaruan
  • Jika ekstensi yang tidak ditandatangani diizinkan untuk memuat secara diam-diam & terprogram

Informasi selengkapnya dapat ditemukan di halaman Mengotomatiskan penginstalan Visual Studio dengan file respons.

Membuat tata letak Anda dapat diakses melalui situs intranet

Mulai Juni 2023, Anda dapat membuat tata letak tersedia di situs intranet internal, yang memungkinkan Anda memanfaatkan kemampuan penembolokan file server web dan performa georeplikasi. Untuk menggunakan fitur baru ini, Anda perlu menggunakan bootstrapper Visual Studio terbaru dan Alat Penginstal Visual Studio terbaru. Administrator TI harus melakukan hal berikut untuk memanfaatkan kemampuan hosting web intranet ini:

  1. Pertama, buat dan pertahankan tata letak jaringan dan pastikan bahwa bit ada dan diperbarui secara teratur pada berbagi jaringan. Selain itu, ingatlah untuk mengonfigurasi nilai channelUri di response.json tata letak jika Anda ingin klien Anda mendapatkan pembaruan mereka dari lokasi tata letak intranet.

  2. Selanjutnya, admin harus menyiapkan situs web internal dan mengikat sumber situs web ke lokasi file jaringan tata letak. Mereka juga perlu memastikan bahwa server web menghormati jenis MIME berikut:

    Ekstensi File Jenis MIME
    .Cab application/vnd.ms-cab-compressed
    .Exe application/octet-stream
    .Json application/json
    .Msi application/octet-stream
    .Msu application/octet-stream
    .nupkg application/octet-stream
    .Opc application/octet-stream
    .ps1 application/postscript
    .vsix application/octet-stream
    .xml text/xml
    .Zip application/x-zip-compressed
  3. Terakhir, untuk menyebarkan tata letak ini pada klien, jalankan skrip PowerShell pada klien untuk melakukan penginstalan awal. Setelah Visual Studio berhasil diinstal ke klien dari tata letak yang dihosting web, maka pembaruan klien untuk tata letak webhosted dapat diperbarui melalui metode standar.

Pastikan tata letak Anda menggunakan alat penginstal terbaru

Catatan

Pada Juni 2023, alat penginstal terbaru dikirim secara default dengan setiap pembaruan ke semua versi Visual Studio 2017, Visual Studio 2019, dan Visual Studio 2022 yang didukung. Jadi, jika Anda menggunakan salah satu versi produk ini, Anda tidak perlu melakukan apa pun secara eksplisit untuk mendapatkan versi terbaru alat penginstal dengan fungsionalitas terbaru dan perbaikan bug.

Jika Anda menggunakan versi Visual Studio yang dikirim sebelum Juni 2023, kami sarankan Anda selalu menggunakan Alat Penginstal Visual Studio terbaru di tata letak Anda dan mendistribusikannya ke klien Anda. Misalnya, jika Anda mendistribusikan alat penginstal Visual Studio 2022 di tata letak Visual Studio 2019, maka klien Visual Studio 2019 berdasarkan tata letak tersebut memiliki kemampuan untuk mengubah lokasi sumber untuk pembaruan atau menghapus komponen di luar dukungan dengan mudah. Detail lebih lanjut dijelaskan di bagian berikut.

Kemampuan untuk memastikan bahwa Anda menggunakan alat penginstal terbaru secara terprogram hanya tersedia untuk bootstrapper Visual Studio 2019 yang dibangun setelah Visual Studio 2022 awalnya dikirim. Jadi, vs_enterprise.exe dalam contoh berikut harus merupakan versi yang dikirim setelah 10 November 2021.

Untuk membuat tata letak seluruh produk yang menggunakan alat penginstal terbaru dan terbesar yang tersedia, jalankan

vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller

Mempertahankan tata letak Anda

Ini adalah praktik terbaik untuk memperbarui tata letak Visual Studio Anda secara berkala ke versi produk aman terbaru. Ini memastikan bahwa tata letak dapat digunakan sebagai titik penginstalan dan sumber pembaruan untuk penginstalan klien. Bagian berikut menjelaskan operasi pemeliharaan tata letak yang paling umum atau berguna.

Jika Anda menghosting tata letak pada berbagi file jaringan, Anda mungkin ingin mengunduh tata letak yang diperbarui ke berbagi lokal privat (misalnya, c:\VSLayoutUpdate) lalu, setelah semua konten yang diperbarui diunduh, salin ke berbagi file jaringan tata letak Anda (misalnya, \server\products\VS). Jika Anda tidak melakukan ini, pengguna yang kebetulan menjalankan penyiapan saat Anda memperbarui tata letak mungkin mendapatkan ketidakcocokan konten dari tata letak karena belum sepenuhnya diperbarui.

Memperbarui tata letak ke versi produk terbaru

Microsoft sering merilis versi produk yang diperbarui untuk memperbaiki masalah fungsionalitas atau keamanan. Kami sangat menyarankan agar Anda terus memperbarui tata letak Anda dengan versi terbaru produk sehingga klien Anda selalu memiliki akses ke versi terbaru yang paling aman dari produk. Ini sangat penting jika klien Anda tidak memiliki akses internet dan hanya dapat menerima pembaruan produk dari tata letak. Visual Studio biasanya merilis pembaruan keamanan pada hari Selasa kedua dalam sebulan, yang dikenal sebagai "patch Selasa", jadi strategi yang baik adalah memperbarui semua tata letak Anda pada patch Selasa sore.

Saat Anda membuat tata letak awal, opsi yang ditentukan, seperti beban kerja dan bahasa mana yang akan disertakan dalam tata letak, disimpan dalam file layout.jsonkonfigurasi tata letak . Kemudian, ketika Anda memperbarui tata letak tersebut ke versi produk yang lebih baru, Anda tidak perlu menentukan kembali komponen produk mana yang Anda inginkan dalam tata letak. Pembaruan tata letak hanya memperbarui komponen yang ada dalam tata letak ke versi terbarunya.

Misalkan Anda sudah membuat tata letak parsial ini menggunakan salah satu bootstrapper hijau dalam tabel di atas.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

Memperbarui tata letak ini ke versi terbaru produk yang ditawarkan oleh Microsoft dan dihosting di server Microsoft mudah. Anda hanya perlu menggunakan bootstrapper evergreen yang ada di tata letak, dan menjalankan --layout perintah dalam prompt yang ditinggikan untuk mengunduh paket terbaru ke tata letak Anda, sebagai berikut:

vs_enterprise.exe --layout c:\VSLayout

Anda juga dapat memperbarui tata letak ke versi yang diperbarui dengan cara yang tidak dijaga. Operasi tata letak menjalankan proses penyiapan di jendela konsol baru. Jendela dibiarkan terbuka sehingga admin dapat melihat hasil pembaruan tata letak akhir dan ringkasan kesalahan apa pun yang mungkin telah terjadi. Jika Anda ingin melakukan operasi pembaruan tata letak dengan cara yang tidak dijaga (misalnya, Anda memiliki skrip yang dijalankan secara teratur untuk memperbarui tata letak Anda ke versi terbaru), maka gunakan --passive parameter dan prosesnya akan secara otomatis menutup jendela.

vs_enterprise.exe --layout c:\VSLayout --passive

Memperbarui tata letak ke versi produk tertentu

Terkadang Anda mungkin ingin memperbarui tata letak Anda ke versi produk tertentu. Misalnya, Anda mungkin ingin membuat tata letak Anda cocok dengan versi aman terbaru dari garis besar layanan yang telah Anda standarkan organisasi Anda. Berikut cara melakukannya:

Anda dapat membuka halaman Rilis Visual Studio 2019 dan mengunduh bootstrapper versi tetap tertentu, menyalinnya ke tata letak Anda, dan menggunakannya untuk memperbarui tata letak ke versi yang tepat yang ditentukan dalam bootstrapper. Anda akan menggunakan sintaks yang sama persis seperti di atas.

Anda dapat menggunakan pembaruan administrator untuk memperbarui tata letak Anda ke versi produk tertentu. Untuk mendapatkan pembaruan administrator, buka Katalog Pembaruan Microsoft dan cari versi pembaruan yang ingin Anda perbarui tata letaknya. Unduh update.exe ke komputer yang menghosting tata letak, membuka prompt perintah yang ditingkatkan, dan jalankan perintah seperti ini:

visualstudioupdate-16.0.0to16.11.23.exe layout --layoutPath c:\VSLayout

Perhatikan bahwa pembaruan administrator tidak memulai pembuatan tata letak baru; ini hanya memperbarui tata letak yang ada. Anda perlu menggunakan bootstrapper untuk membuat tata letak awal.

Anda dapat membuka halaman Riwayat Rilis Visual Studio 2022 dan mengunduh bootstrapper versi tetap tertentu, menyalinnya ke tata letak Anda, dan menggunakannya untuk memperbarui tata letak ke versi yang tepat yang ditentukan dalam bootstrapper. Anda akan menggunakan sintaks yang sama persis seperti di atas.

Anda dapat menggunakan pembaruan administrator untuk memperbarui tata letak Anda ke versi produk tertentu. Untuk mendapatkan pembaruan administrator, buka Katalog Pembaruan Microsoft, dan cari pembaruan yang ingin Anda perbarui tata letaknya. Unduh update.exe ke komputer yang menghosting tata letak, buka prompt perintah yang ditingkatkan di komputer tersebut dan jalankan perintah seperti ini:

visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout

Perhatikan bahwa pembaruan administrator tidak akan memulai pembuatan tata letak baru; ini hanya akan memperbarui tata letak yang ada. Anda harus menggunakan bootstrapper untuk membuat tata letak awal.

Memastikan tata letak jaringan Anda didasarkan pada versi yang didukung

Terkadang, karena transisi saluran tidak didukung, Anda harus memastikan bahwa tata letak jaringan terus didasarkan pada saluran yang didukung sehingga klien Anda dapat terus menerima pemberitahuan pembaruan keamanan. Jika tata letak Anda didasarkan pada saluran VisualStudio.17.Release.LTSC.17.0, maka setelah saluran 17.0 LTSC tidak didukung pada Juli 2023, kami tidak akan merilis pembaruan keamanan lagi untuk itu dan tata letak dan klien Anda akan menjadi tidak aman. Tanggal dukungan untuk berbagai saluran Visual Studio 2022 dapat ditemukan di sini.

Untuk mengubah saluran yang didasarkan pada tata letak, dapatkan bootstrapper saluran yang diinginkan dari halaman Riwayat Rilis Visual Studio 2022, salin ke folder tata letak Anda, dan lakukan pembaruan normal. Klien Anda kemudian harus diberi tahu dengan tepat tentang pembaruan sehingga mereka akan dapat tetap aman juga.

Mengubah konten tata letak

Dimungkinkan untuk memodifikasi tata letak parsial dan menambahkan beban kerja, komponen, atau bahasa tambahan. Tidak dimungkinkan untuk menghapus komponen dengan andal dari tata letak.

Dalam contoh di bawah ini, kita akan menambahkan beban kerja Azure dan bahasa yang dilokalkan ke tata letak yang sebelumnya dibuat hanya dengan beban kerja Desktop Terkelola dan bahasa Inggris. Setelah kami melakukan modifikasi, beban kerja Desktop Terkelola dan Azure, dan sumber daya Bahasa Inggris dan Jerman akan disertakan dalam tata letak ini. Selain menambahkan komponen, --layout perintah juga akan menyebabkan tata letak diperbarui ke versi yang ditentukan oleh bootstrapper. Jadi, jika Anda menggunakan bootstrapper evergreen, maka tata letak yang dihasilkan akan memiliki komponen baru, bahasa baru, dan semua konten tata letak akan diperbarui ke versi terbaru di saluran bootstrapper.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

Jika Anda ingin mengubah tata letak parsial yang ada sehingga menjadi tata letak lengkap, gunakan opsi --all, seperti yang ditunjukkan dalam contoh berikut. Sekali lagi, perintah ini akan menyebabkan konten tata letak diperbarui ke versi yang ditentukan oleh bootstrapper.

vs_enterprise.exe --layout c:\VSLayout --all

Anda dapat menambahkan komponen ke tata letak dengan meneruskan *.vsconfig file yang berisi komponen tambahan yang Anda inginkan di tata letak Anda. Jika Anda melakukan ini, konten baru *.vsconfig akan menimpa konten yang ada layout.vsconfig . Untuk informasi selengkapnya, lihat bagian sebelumnya Menggunakan file konfigurasi untuk menginisialisasi konten tata letak.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Terakhir, Anda dapat langsung mengedit layout.json file konfigurasi di folder tata letak dan memperbarui bagian "tambahkan" dari file ini untuk menyertakan komponen tambahan yang ingin Anda sertakan dalam tata letak Anda. Anda kemudian perlu memperbarui tata letak menggunakan --layout seperti yang dijelaskan sebelumnya untuk mengunduh komponen terbaru.

Catatan

Cara term mudah untuk menginstal komponen tata letak yang baru ditambahkan ke komputer klien adalah dengan menjalankan bootstrapper dalam tata letak dari komputer klien. Bagian 'tambahkan' file response.json dalam tata letak akan menentukan komponen mana yang dipilih secara default di UI penginstal klien. Jika Anda telah memodifikasi tata letak menggunakan salah satu metode di atas, Anda mungkin ingin memeriksa kembali secara manual dan mungkin menyesuaikan bagian 'tambahkan' dalam response.json file sehingga lebih cocok dengan konten di bagian 'tambahkan' dari file yang baru dimodifikasi layout.json .

Konfigurasikan tata letak untuk menghapus komponen di luar dukungan pada komputer klien.

Beberapa perusahaan akan ingin memanfaatkan fitur yang diperkenalkan di Visual Studio 2022 versi 17.4 yang menghapus komponen yang telah beralih ke status di luar dukungan. Ini relatif mudah disiapkan jika Anda mengelola tata letak dan jika klien Anda menerima pembaruan administrator. Pertama, Anda harus mengonfigurasi tata letak agar memiliki versi penginstal terbaru seperti yang dijelaskan di bawah ini. Kedua, Anda harus menambahkan baris "removeOos": true ke response.json file. Jika tata letak Anda mengatur kedua detail ini dengan benar, pembaruan administrator berikutnya akan menghormati pengaturan ini dan akan menghapus komponen yang tidak didukung dari komputer klien.

Memverifikasi tata letak

Gunakan --verify untuk melakukan verifikasi pada tata letak jaringan yang memeriksa apakah file paket hilang atau tidak valid. Di akhir verifikasi, ia mencetak daftar file yang hilang dan tidak valid.

Verifikasi hanya berfungsi untuk versi terbaru visual Studio versi minor tertentu. Segera setelah versi baru dirilis, verifikasi tidak akan berfungsi untuk tata letak yang berisi rilis sebelumnya.

vs_enterprise.exe --layout <layoutDir> --verify

Catatan

Beberapa file metadata penting yang diperlukan oleh --verify opsi harus berada di folder tata letak. Jika file metadata ini hilang, "--verifikasi" tidak dapat berjalan dan Penyetelan memberi Anda kesalahan. Jika Anda mengalami kesalahan ini, coba perbarui tata letak lagi, atau buat ulang tata letak jaringan baru di folder lain.

Ingatlah bahwa Microsoft mengirimkan pembaruan ke Visual Studio secara berkala, jadi, jika Anda menggunakan bootstrapper evergreen, maka tata letak yang lebih baru mungkin tidak berisi versi yang sama dengan tata letak awal. Namun, jika Anda menggunakan bootstrapper tautan tetap, maka Anda akan (hampir) selalu mendapatkan set file deterministik.

Memperbaiki tata letak

Gunakan --fix untuk melakukan verifikasi yang sama seperti --verify dan juga mencoba memperbaiki masalah yang diidentifikasi. Proses ini --fix membutuhkan koneksi internet, jadi pastikan komputer Anda terhubung ke internet sebelum Anda memanggil --fix.

vs_enterprise.exe --layout <layoutDir> --fix

Menghapus versi lama dari tata letak

Setelah Anda melakukan pembaruan tata letak ke cache jaringan, folder tata letak mungkin memiliki beberapa paket usang yang tidak lagi diperlukan oleh penginstalan Visual Studio terbaru. Anda dapat menggunakan --clean opsi untuk menghapus paket usang dari folder tata letak jaringan.

Untuk melakukan ini, Anda memerlukan jalur file ke manifes katalog yang berisi paket usang tersebut. Anda dapat menemukan manifes katalog di folder "Arsip" di cache tata letak jaringan. Mereka disimpan di sana saat Anda memperbarui tata letak. Di folder "Arsip", ada satu atau beberapa folder bernama "GUID", yang masing-masing berisi manifes katalog usang. Jumlah folder "GUID" harus sama dengan jumlah pembaruan yang dibuat pada tata letak Anda.

Beberapa file disimpan di dalam setiap folder "GUID". Dua file yang paling menarik adalah file "catalog.json" dan file "version.txt". File "catalog.json" adalah manifes katalog usang yang harus Anda teruskan ke --clean opsi . File version.txt lainnya berisi versi manifes katalog usang ini. Berdasarkan nomor versi, Anda dapat memutuskan apakah Anda ingin menghapus paket usang dari manifes katalog ini. Anda dapat melakukan hal yang sama seperti Anda melalui folder "GUID" lainnya. Setelah Anda membuat keputusan pada katalog yang ingin Anda bersihkan, jalankan --clean perintah dengan menyediakan jalur file ke katalog ini.

Berikut adalah contoh cara menggunakan opsi --clean:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Ketika Anda menjalankan perintah ini, Penyetelan menganalisis folder tata letak jaringan Anda untuk menemukan daftar file yang akan dihapusnya. Anda kemudian akan memiliki kesempatan untuk meninjau file yang akan dihapus dan mengonfirmasi penghapusan.

Mengonfigurasi tata letak untuk selalu menyertakan dan menyediakan alat penginstal terbaru

Catatan

Pada Juni 2023, alat penginstal terbaru dikirim secara default dengan setiap pembaruan ke versi Visual Studio 2017, Visual Studio 2019, dan Visual Studio 2022 yang didukung. Jadi Anda tidak perlu melakukan apa pun secara eksplisit untuk mendapatkan versi terbaru alat penginstal dengan fungsionalitas terbaru dan perbaikan bug ke tata letak Anda dan ke klien Anda.

Namun, jika Anda menggunakan tata letak yang dibuat sebelum Juni 2023, maka Anda juga dapat secara eksplisit mengonfigurasi tata letak Anda untuk selalu menyertakan dan menyediakan alat penginstal terbaru kepada klien Anda, bahkan jika alat penginstal dianggap sebagai bagian dari versi Visual Studio yang lebih baru. Dengan demikian, ketika klien Anda memperbarui dari tata letak ini, klien akan memperoleh alat penginstal terbaru yang disertakan dan disediakan oleh tata letak ini. Manfaatnya adalah setelah penginstal terbaru ada di klien Anda, penginstalan klien Anda akan dapat memanfaatkan perbaikan bug dan fungsionalitas baru yang terus kami tambahkan ke penginstal.

Tip

Jika Anda ingin mengubah lokasi tempat penginstalan Visual Studio 2019 klien Anda mencari pembaruan atau jika Anda ingin menghapus semua komponen di luar dukungan, maka Anda harus mendapatkan penginstal Visual Studio 2022 terbaru di komputer klien Anda. Salah satu cara untuk melakukan ini adalah dengan menyertakan alat penginstal Visual Studio 2022 dalam tata letak Visual Studio 2019 Anda menggunakan parameter yang dijelaskan di bawah ini. Kemampuan untuk menggunakan penginstal terbaru hanya tersedia untuk bootstrapper Visual Studio 2019 yang dibangun setelah Visual Studio 2022 awalnya dikirim. Jadi, vs_enterprise.exe dalam contoh di bawah ini harus merupakan versi yang dikirim setelah 10 November 2021.

Ada beberapa cara untuk mengaktifkan tata letak Anda untuk menyertakan dan menyediakan alat penginstal terbaru:

  • Anda dapat menggunakan versi Visual Studio yang dibangun pada atau setelah Juni 2023.

  • Anda dapat meneruskan --useLatestInstaller parameter ke bootstrapper saat membuat atau memperbarui tata letak. Ini akan menyebabkan pengaturan diatur dalam layout.json file, yang dapat ditemukan di direktori akar tata letak. Berikut adalah contoh cara memperbarui tata letak dan mengonfigurasinya untuk menggunakan alat penginstal terbaru dan terbesar yang tersedia.

    vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
    
  • Anda dapat mengedit file secara layout.json langsung untuk menambahkan pengaturan ini.

    {
       "installChannelUri": ".\\ChannelManifest.json",
       "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
       "installCatalogUri": ".\\Catalog.json",
       "channelId": "VisualStudio.16.Release",
       "productId": "Microsoft.VisualStudio.Product.Enterprise",
    
       "useLatestInstaller": true,
       "removeOos": true
    
    }
    

Tidak ada cara untuk menghapus pengaturan ini secara terprogram dalam layout.json file, jadi jika Anda ingin tata letak Anda berhenti menggunakan alat penginstal terbaru yang disediakan Microsoft, dan sebaliknya menggunakan versi penginstal yang sesuai dengan bootstrapper (yang kemungkinan besar lebih lama dari alat penginstal terbaru), edit layout.json file dan hapus "UseLatestInstaller": true pengaturan.

Perhatikan bahwa Anda mungkin menemukan pengaturan ini "UseLatestInstaller": true dalam file tata letak response.json juga, tetapi diabaikan di sana untuk tujuan memastikan tata letak selalu memiliki alat penginstal terbaru. File response.json digunakan untuk mengatur opsi konfigurasi default pada klien saat klien menginstal atau memperbarui dari tata letak. Pengaturan khusus "useLatestInstaller": true ini dalam layout.json file digunakan untuk memastikan bahwa konten tata letak berisi alat penginstal terbaru, sehingga komputer klien kemudian dapat memperoleh alat penginstal terbaru dari tata letak.

Kode kesalahan

Jika Anda menggunakan --wait parameter , maka tergantung pada hasil operasi, %ERRORLEVEL% variabel lingkungan diatur ke salah satu nilai berikut:

Nilai Hasil
0 Operasi berhasil diselesaikan
740 Elevasi diperlukan
1001 Proses penginstal Visual Studio sedang berjalan
1003 Visual Studio sedang digunakan
1602 Operasi dibatalkan
1618 Penginstalan lain yang berjalan
1641 Operasi berhasil diselesaikan, dan boot ulang dimulai
3010 Operasi berhasil diselesaikan, tetapi penginstalan memerlukan boot ulang sebelum dapat digunakan
5003 Bootstrapper gagal mengunduh alat penginstal
5004 Operasi dibatalkan
5005 Kesalahan penguraian baris perintah Bootstrapper
5007 Operasi diblokir - komputer tidak memenuhi persyaratan
8001 Kegagalan pemeriksaan mesin arm
8002 Kegagalan pra-pemeriksaan pengunduhan latar belakang
8003 Kegagalan yang dapat dipilih di luar dukungan
8004 Kegagalan direktori target
8005 Memverifikasi kegagalan payload sumber
8006 Proses Visual Studio yang berjalan
8010 Sistem Operasi tidak didukung. Lihat Persyaratan Sistem
-1073720687 kegagalan Koneksi ivitas
-1073741510 Penginstal Microsoft Visual Studio dihentikan (oleh pengguna atau proses eksternal)
Lainnya
(misalnya:
-1, 1, 1603)
Kondisi kegagalan terjadi - periksa log untuk informasi selengkapnya

Mendapatkan dukungan untuk tata letak jaringan Anda

Jika Anda mengalami masalah dengan tata letak jaringan Anda, kami ingin mengetahuinya. Cara terbaik untuk memberi tahu kami adalah dengan menggunakan alat Laporkan Masalah yang muncul baik di Penginstal Visual Studio maupun di Visual Studio IDE. Jika Anda adalah Administrator TI dan belum menginstal Visual Studio, Anda dapat mengirimkan umpan balik Admin TI di sini. Ketika Anda menggunakan alat ini, akan sangat membantu jika Anda dapat mengirim log oleh alat Visual Studio Collect yang dapat membantu kami mendiagnosis dan memperbaiki masalah.

Kami juga menawarkan opsi dukungan obrolan penginstalan (hanya bahasa Inggris) untuk masalah terkait penginstalan.

Kami juga memiliki opsi dukungan lain yang tersedia. Lihat Komunitas Pengembang Visual Studio kami.