Konfigurasikan kebijakan untuk penyebaran di lingkungan perusahaan Visual Studio

Anda dapat mengonfigurasi aspek tertentu dari perilaku penyebaran dan pembaruan Visual Studio melalui kebijakan. Beberapa konfigurasi ini khusus untuk instans Visual Studio yang diinstal, dan beberapa konfigurasi dapat bersifat global dan berlaku untuk semua instans Visual Studio pada komputer klien. Anda dapat mengonfigurasi hal berikut:

• Jika pengguna tanpa izin administrator diizinkan untuk memperbarui atau mengubah Visual Studio
• Haruskah komponen yang tidak didukung dihapus dari komputer
• Di mana beberapa paket yang dibagikan dengan versi atau instans lain diinstal
• Di mana dan apakah paket di-cache
• Haruskah pembaruan administrator diaktifkan dan bagaimana pembaruan tersebut harus diterapkan
• Saluran pembaruan mana yang tersedia dan bagaimana saluran tersebut disajikan kepada klien
• Bagaimana pemberitahuan muncul atau tidak muncul

Konfigurasikan dan sebarkan kebijakan perangkat global di seluruh organisasi Anda dengan menggunakan katalog pengaturan Microsoft Intune atau mengimpor Templat Administratif (ADMX) Visual Studio ke dalam alat yang lebih lama seperti editor Group Policy. Anda juga dapat mengatur nilai registri langsung di komputer klien. Perilaku per instans biasanya dikontrol dengan menggunakan opsi baris perintah pada komputer klien.

Kunci registri

Ada beberapa lokasi di registri tempat Anda dapat mengatur kebijakan ini. Visual Studio memeriksa secara berurutan, dalam urutan berikut, untuk melihat apakah ada kebijakan perusahaan yang diterapkan. Segera setelah nilai kebijakan ditemukan, kunci yang tersisa diabaikan.

1. HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\VisualStudio\Setup
2. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup
3. HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\VisualStudio\Setup (pada sistem operasi 64-bit)

Beberapa nilai registri diatur secara otomatis saat pertama kali digunakan jika belum diatur. Praktik ini memastikan bahwa penginstalan berikutnya menggunakan nilai yang sama. Nilai-nilai ini disimpan dalam kunci registri kedua, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup.

Anda dapat mengatur nilai registri berikut:

Mengontrol perilaku penginstalan, pengunduhan, dan pembaruan

Pengaturan registri di bagian ini mengontrol bagaimana dan di mana produk Visual Studio diunduh dan diinstal ke komputer klien.

Nama	Type	Default	Deskripsi
AllowStandardUserControl	REG_DWORD	0	Perbolehkan pengguna tanpa izin administrator untuk mengelola penginstalan Visual Studio mereka secara manual menggunakan UI Penginstal: jika diatur ke 1, pengguna tanpa izin administrator dapat memperbarui atau mengembalikan pembaruan secara manual tanpa perlu menyediakan kata sandi administrator. Jika diatur ke 2, pengguna tanpa izin administrator dapat menggunakan semua fungsionalitas di Visual Studio Installer secara manual, termasuk Modify dan Install dari tab Available. Pengguna Standar tidak dapat menjalankan perintah penginstal Visual Studio apa pun secara terprogram dengan parameter --passive atau --quiet, terlepas dari apa kebijakan ini diatur ke. Kebijakan ini mengharuskan penginstal Visual Studio versi terbaru diinstal pada komputer klien.
CachePath	REG_SZ atau REG_EXPAND_SZ	%ProgramData% \Microsoft \VisualStudio \Paket	Package manifest dan jalur cache payload: Visual Studio Installer memberlakukan batas 50 karakter untuk jalur direktori penyimpanan cache ini. Untuk informasi selengkapnya, lihat halaman Menonaktifkan atau memindahkan cache paket
KeepDownloadedPayloads	REG_DWORD	1	Menyimpan payload paket setelah penginstalan: Dengan menonaktifkan kebijakan ini akan menghapus cache payload paket untuk instans yang Anda modifikasi atau perbaiki. Anda dapat mengubah nilai kapan saja. Untuk informasi selengkapnya, lihat halaman Menonaktifkan atau memindahkan cache paket.
SharedInstallationPath	REG_SZ atau REG_EXPAND_SZ	%ProgramFiles(x86)% \Microsoft Visual Studio \Dibagikan	Folder instalasi bersama: direktori tempat beberapa paket yang digunakan bersama di berbagai versi Visual Studio diinstal. Anda dapat mengubah nilai kapan saja, tetapi hanya akan memengaruhi penginstalan di masa mendatang. Produk apa pun yang sudah diinstal ke lokasi lama tidak boleh dipindahkan atau mungkin tidak berfungsi dengan benar. Penginstal Visual Studio memberlakukan batas 150 karakter untuk jalur tersebut.
BackgroundDownloadDisabled	REG_DWORD	0	Nonaktifkan mengunduh pembaruan secara otomatis: jika diatur ke 1, maka penyiapan akan dicegah dari mengunduh pembaruan secara otomatis untuk semua produk Visual Studio yang terpasang. Anda dapat mengubah nilai kapan saja.
RemoveOos	REG_DWORD	0	Hapus komponen yang tidak didukung selama pembaruan: jika diatur ke 1, maka Penginstal Visual Studio akan menghapus semua komponen terinstal yang telah berubah status menjadi tidak didukung selama semua pembaruan berikutnya. Jika diatur ke 0 atau hilang sepenuhnya, perilaku removeOos menghormati lokasi lain di mana pengaturan ini dapat dikonfigurasi, seperti parameter commandline atau dialog Perbarui Pengaturan. Untuk informasi selengkapnya, lihat posting blog Menghapus komponen yang tidak didukung. Fungsionalitas ini memerlukan versi terbaru Visual Studio untuk diinstal pada komputer klien.
DisableRollback	REG_DWORD	0	Disable kemampuan untuk memutar kembali atau membatalkan pembaruan Visual Studio: jika diatur ke 1, maka pengguna akan dicegah mengakses kemampuan putar kembali, yang mencegah Visual Studio mengembalikan pembaruan terbaru, yang mungkin berisi perbaikan keamanan. Jika diatur ke 0 atau hilang sepenuhnya, pengguna dapat mengakses fitur rollback di Visual Studio, dan membatalkan pembaruan serta mengembalikan instans Visual Studio mereka ke versi yang diinstal sebelumnya. Untuk informasi selengkapnya, lihat posting blog Rollback.
HideAvailableTab	REG_DWORD	0	Sembunyikan tab Tersedia: jika diatur ke 1, maka administrator dapat menyembunyikan tab Tersedia, yang dapat mencegah pengguna organisasi secara tidak sengaja menginstal produk yang salah.
DisableSound	REG_DWORD	0	Menonaktifkan suara di alat penginstal: jika diatur ke 1, maka pengguna dapat menonaktifkan suara di Penginstal Visual Studio, yang akan mencegah sinyal audio ketika operasi penginstal selesai dilakukan atau ketika terjadi kesalahan. Operasi penginstal termasuk menginstal, memperbarui, memodifikasi, dan banyak operasi lain yang dilakukan oleh alat penginstal atau dialog kesalahan apa pun saat mencoba operasi yang diminta. Jika diatur ke 0 atau hilang sepenuhnya, maka pengguna dapat mengaktifkan kembali suara di alat penginstal. Untuk informasi selengkapnya, lihat posting blog DisableSound.
DisableMigrationDialog	REG_DWORD	0	Disable dialog migrasi stale-build: jika diatur menjadi 1, ini mencegah pengguna melihat dialog yang meminta mereka untuk memperbarui ke versi terbaru dari Visual Studio IDE. Kebijakan ini berlaku untuk Visual Studio 2026 dan yang lebih baru. Skenario Insider dan Community tidak didukung.

Penting

Jika Anda mengubah kebijakan registri CachePath setelah penginstalan apa pun, Anda harus memindahkan cache paket yang ada ke lokasi baru serta memastikan keamanannya sehingga SYSTEM dan Administrators memiliki Kontrol Penuh dan Everyone memiliki akses Baca. Kegagalan untuk memindahkan cache yang ada atau mengamankannya dapat menyebabkan masalah dengan penginstalan di masa mendatang.

Mengontrol Pembaruan Administrator

Pengaturan registri di bagian ini mengontrol apakah dan bagaimana pembaruan administrator diterapkan ke komputer klien.

Nama	Type	Default	Deskripsi
AdministratorUpdatesEnabled	REG_DWORD	0	Aktifkan pembaruan administrator: memungkinkan pembaruan administrator diterapkan ke komputer klien. Jika nilai ini hilang atau diatur ke 0, pembaruan administrator akan diblokir. Nilai 1 membuat komputer klien tersedia untuk pembaruan yang disebarkan melalui saluran WSUS/SCCM. Nilai yang direkomendasikan 2 membuat komputer klien tersedia untuk menerima pembaruan yang disebarkan melalui saluran WSUS/SCCM atau saluran Windows Update untuk Bisnis/Intune/Microsoft Endpoint manager. Kunci registri ini adalah untuk pengguna administrator. Untuk informasi selengkapnya, lihat Mengaktifkan Pembaruan Administrator.
AdministratorUpdatesNotifications	REG_DWORD	0	Memungkinkan admin untuk memberi tahu pengguna agar menutup Visual Studio untuk membuka blokir pembaruan administrator: Jika Visual Studio terbuka atau sedang digunakan, pembaruan administrator gagal diterapkan. Dengan mengatur kunci registri ini, administrator dapat menyebabkan permintaan pemberitahuan toast Windows yang meminta pengguna untuk menutup Visual Studio dan menyimpan pekerjaan mereka sehingga pembaruan yang tertunda dapat berlaku. Kunci registri ini adalah untuk pengguna administrator. Untuk informasi selengkapnya, lihat pengumuman posting blog .
AdministratorUpdatesOptOut	REG_DWORD	0	Menolak pembaruan administrator: menunjukkan bahwa pengguna tidak ingin menerima pembaruan dari administrator di Visual Studio. Tidak adanya nilai registri, atau nilai yang ditetapkan 0, berarti bahwa pengguna Visual Studio ingin menerima pembaruan administrator untuk Visual Studio. Kebijakan ini agar pengguna pengembang mengonfigurasi jika mereka memiliki izin admin pada komputer klien. Kunci AdministratorUpdatesOptOut untuk mengodekan preferensi pengguna diprioritaskan melalui kunci AdministratorUpdatesEnabled, yang mengodekan niat admin TI. Jika AdministratorUpdatesOptOut diatur ke 1, pembaruan diblokir pada klien, bahkan jika kunci AdministratorUpdatesEnabled juga diatur ke 1. Tindakan ini mengasumsikan bahwa admin TI dapat mengakses dan memantau pengembang mana yang memilih untuk menolak. Kedua belah pihak kemudian dapat mendiskusikan kebutuhan siapa yang lebih penting. Admin TI selalu dapat mengubah salah satu kunci kapan pun mereka mau.
UpdateConfigurationFile	REG_SZ atau REG_EXPAND_SZ	%ProgramData% \Microsoft \VisualStudio \updates.config	Jalur kustom ke file konfigurasi pembaruan: jalur ke file pada klien yang dapat digunakan untuk mengonfigurasi Pembaruan Administratif. Secara default, file ini tidak ada dan kebijakan tidak diatur. Jika Anda memilih untuk menambahkan kebijakan ke komputer klien dan menentukan lokasi file konfigurasi kustom, maka pembaruan Administrator akan mencari file ini. Jika file tidak ada, maka pengecualian akan dilemparkan dan pembaruan gagal. Untuk informasi selengkapnya, lihat Metode untuk mengonfigurasi pembaruan administrator.

Penting

Komputer klien yang terhubung ke cloud yang dikelola oleh Intune harus dikonfigurasi untuk Windows Update untuk Bisnis dan memilih "Aktifkan Pembaruan untuk Produk Microsoft lainnya" untuk menerima pembaruan administrator Visual Studio melalui saluran Windows Update untuk Pembaruan Microsoft Bisnis.

Mengonfigurasi lokasi sumber untuk pembaruan

Pengaturan di bagian ini memungkinkan administrator untuk menyesuaikan dan mengontrol saluran pembaruan apa yang tersedia dan bagaimana saluran tersebut muncul untuk klien di organisasi perusahaan. Untuk informasi tentang apa itu pengaturan pembaruan dan cara kerjanya, lihat dokumentasi mengenai mengonfigurasi lokasi sumber pembaruan. Fungsionalitas ini mengharuskan klien untuk menggunakan Visual Studio 2022 Installer dan agar tata letak menggunakan versi bootstrapper 2019 yang dirilis pada atau setelah 10 November 2021. Lihat dokumentasi cara mendapatkan penginstal Visual Studio 2022 di komputer klien Anda melalui tata letak Visual Studio 2019 untuk panduan.

Kunci di bagian ini hanya berlaku untuk jalur registri Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup

Nama	Type	Deskripsi
Channels	Key	Jalur sub-kunci untuk menyimpan informasi saluran tata letak kustom. Nama kunci ini dianggap sebagai Nama saluran, dan itulah yang muncul di menu dropdown saluran Update. Nilai ChannelURI harus ada di bawah subkunji Channels.
DisabledChannels	Key	Jalur sub-kunci untuk menyembunyikan saluran dan mencegahnya muncul dalam dialog Saluran Pembaruan. Jika saluran didefinisikan di sini (bersama dengan nilai ChannelURI), saluran difilter keluar dari dialog.
ChannelURI	REG_SZ	ChannelURI untuk menambahkan ke daftar nilai saluran pembaruan dengan menambahkan ke sarang Channels, atau menekan dari daftar saluran pembaruan dengan menambahkan ke sarang registri DisabledChannels. Untuk saluran yang dihosting Microsoft, channelURI https://aka.ms/vs/stable/channel atau https://aka.ms/vs/insiders/channel. Untuk tata letak, nilai ini perlu menunjuk ke tata letak ChannelManifest.json. Lihat contoh.
Description	REG_SZ	Deskripsi dua baris kustom dari saluran. Jika Anda sudah menginstal dari tata letak, maka antarmuka Pengaturan Pembaruan diatur ke "Saluran Privat" dan Anda dapat mengubahnya melalui bagian Deskripsi.

Beberapa contoh file registri yang menggambarkan bagaimana Admin TI mungkin ingin mengkustomisasi antarmuka pengguna Pengaturan Pembaruan :

Contoh registri pertama dapat digunakan dalam situasi di mana klien sebelumnya diinstal dari tata letak jaringan yang terletak di \\vslayoutserver3\vs\18_Enterprise. Seperti disebutkan sebelumnya, Visual Studio default nama saluran untuk tata letak ini ke "Saluran Privat". Berikut adalah cara Anda menyesuaikan nama dan deskripsi saluran untuk tata letak ini.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels]

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels\More meaningful name of my existing layout]
"channelUri"="\\\\vslayoutserver3\\vs\\18_Enterprise\\ChannelManifest.json"
"Description"="Dev Tools based on VS 2026 18.x.Spring.2026 servicing baseline"

Berikut cara menambahkan beberapa entri tata letak tambahan untuk saluran pembaruan yang disesuaikan lainnya yang tersedia sebagai sumber untuk pembaruan, dan juga cara menghilangkan saluran Pratinjau agar tidak muncul.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels]

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels] [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels\Spring 2026 dev toolset] "channelUri"="\\\\newVS18layoutserver\\share\\newVS18layout\\ChannelManifest.json"
"Description"="Dev Tools based on VS 2026 18.x.Spring.2026 servicing baseline" 

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Channels\Next gen dev tools using VS 2026 toolset]
"channelUri"="\\\\vs18Layoutserver\\share\\2026Enterprise\\ChannelManifest.json"
"Description"="Developer Tools based on the VS 2026 18.0.Winter.2026 LSTC servicing baseline"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\DisabledChannels\Preview]
"channelUri"="[https://aka.ms/vs/insiders/channel"](https://aka.ms/vs/insiders/channel%22)

Mengontrol pemberitahuan di IDE Visual Studio

Seperti yang dijelaskan sebelumnya, Visual Studio memeriksa lokasi asal pemasangannya, seperti berbagi jaringan atau internet, untuk melihat apakah ada pembaruan yang tersedia. Saat pembaruan tersedia, Visual Studio memberi tahu pengguna dengan ikon pemberitahuan di sudut kanan bawah jendela.

Anda dapat menonaktifkan pemberitahuan jika Anda tidak ingin pengguna akhir diberi tahu tentang pembaruan. (Misalnya, Anda mungkin ingin menonaktifkan pemberitahuan jika Anda memberikan pembaruan melalui mekanisme distribusi perangkat lunak pusat.)

Karena Visual Studio stores entri registri dalam registri privat, Anda tidak dapat langsung mengedit registri dengan cara yang khas. Namun, Visual Studio menyertakan utilitas vsregedit.exe yang dapat Anda gunakan untuk mengubah pengaturan Visual Studio. Anda dapat menonaktifkan pemberitahuan dengan perintah berikut:

vsregedit.exe set "C:\Program Files\Microsoft Visual Studio\18\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword 0

Anda dapat mengaktifkan kembali pemberitahuan dengan perintah berikut:

vsregedit.exe set "C:\Program Files\Microsoft Visual Studio\18\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword 1

Untuk kembali ke perilaku default, Anda juga dapat menghapus nilai dengan perintah berikut:

vsregedit.exe remove "c:\Program Files\Microsoft Visual Studio\18\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override

Setelah Anda menjalankan perintah untuk mengubah pengaturan Visual Studio, mulai Visual Studio. Setiap instans Visual Studio yang sudah berjalan tidak mengubah perilaku hingga Visual Studio dimatikan dan dimulai ulang. Sebagai opsi lain, Anda dapat menghidupkan ulang komputer untuk memastikan pengaturan berlaku.

Anda dapat mengonfirmasi pengaturan dengan perintah berikut:

vsregedit.exe read "c:\Program Files\Microsoft Visual Studio\18\Enterprise" HKCU ExtensionManager AutomaticallyCheckForUpdates2Override dword

Jika nilai tidak ada (kondisi default), perintah sebelumnya menunjukkan bahwa nilai gagal dibaca. Jika Anda mengatur nilai, maka perintah sebelumnya mencerminkan nilai dalam konfigurasi Visual Studio (ini menunjukkan 0 atau 1, atau nilai apa pun yang diatur ke - hanya 0 atau 1 yang diharapkan).

(Pastikan untuk mengganti direktori agar sesuai dengan instans terinstal yang ingin Anda edit.)

Ujung

Gunakan vswhere.exe untuk menemukan instans Visual Studio tertentu di stasiun kerja klien.

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 pilihan dukungan obrolan penginstalan (hanya dalam bahasa Inggris) untuk masalah yang berhubungan dengan penginstalan.
• Laporkan masalah produk kepada kami dengan menggunakan alat Laporkan Masalah yang muncul baik di Alat Penginstal Visual Studio maupun di IDE Visual Studio. Jika Anda adalah Administrator TI dan belum menginstal Visual Studio, Anda dapat mengirimkan umpan balik admin IT.
• Sarankan fitur, lacak masalah produk, dan temukan jawaban di Visual Studio Developer Community.

Konten terkait

• Menginstal Visual Studio
• panduan administrator Visual Studio
• Menerapkan pembaruan administrator
• Nonaktifkan atau pindahkan cache paket
• Menggunakan parameter baris perintah untuk menginstal Visual Studio