kelas Win32_WMISetting
Kelas WMI singleton Win32_WMISetting berisi parameter operasional untuk layanan WMI. Kelas ini hanya dapat memiliki satu instans, yang selalu ada untuk setiap sistem Windows dan tidak dapat dihapus. Instans tambahan tidak dapat dibuat.
Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti dan metode dalam urutan alfabet, bukan urutan MOF.
Sintaks
[Singleton, Dynamic, Provider("WBEMCORE"), UUID("{A83EF166-CA8D-11d2-B33D-00104BCC4B4A}"), AMENDMENT]
class Win32_WMISetting : CIM_Setting
{
string Caption;
string Description;
string SettingID;
string ASPScriptDefaultNamespace = "\\\\root\\cimv2";
boolean ASPScriptEnabled;
string AutorecoverMofs[];
uint32 AutoStartWin9X;
uint32 BackupInterval;
datetime BackupLastTime;
string BuildVersion;
string DatabaseDirectory;
uint32 DatabaseMaxSize;
boolean EnableAnonWin9xConnections;
boolean EnableEvents;
boolean EnableStartupHeapPreallocation;
uint32 HighThresholdOnClientObjects;
uint32 HighThresholdOnEvents;
string InstallationDirectory;
uint32 LastStartupHeapPreallocation;
string LoggingDirectory;
uint32 LoggingLevel;
uint32 LowThresholdOnClientObjects;
uint32 LowThresholdOnEvents;
uint32 MaxLogFileSize;
uint32 MaxWaitOnClientObjects;
uint32 MaxWaitOnEvents;
string MofSelfInstallDirectory;
};
Anggota
Kelas Win32_WMISetting memiliki jenis anggota ini:
Properti
Kelas Win32_WMISetting memiliki properti ini.
-
ASPScriptDefaultNamespace
-
-
Jenis data: string
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|Namespace Default")
Namespace layanan skrip default. Properti ini berisi namespace yang digunakan oleh panggilan dari Scripting API untuk WMI jika tidak ada yang ditentukan oleh pemanggil.
Properti ini mencerminkan nilai dalam kunci registri.
HKEY_LOCAL_MACHINE scripting Microsoft\WBEM\ Software|\\Default Namespace
Contoh: root\cimv2
Untuk contoh skrip yang menggunakan properti ini, lihat bagian Keterangan.
-
-
ASPScriptEnabled
-
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|Aktifkan untuk ASP")
Jika True, pembuatan skrip WMI dapat digunakan pada Halaman Server Aktif (ASP). Properti ini valid pada sistem yang menjalankan versi Windows yang tidak didukung saja. Untuk sistem Windows yang didukung, pembuatan skrip WMI selalu diizinkan di ASP.
-
-
AutorecoverMofs
-
-
Jenis data: array string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Pulihkan otomatis MOF")
Daftar nama file MOF yang sepenuhnya memenuhi syarat yang digunakan untuk menginisialisasi atau memulihkan repositori WMI. Daftar menentukan urutan di mana file MOF dikompilasi.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\ CIMOM|Pulihkan otomatis MOF
-
-
AutoStartWin9X
-
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|AutostartWin9X")
Tidak didukung.
-
-
Jangan mulai (0)
-
Mulai Otomatis (1)
-
Mulai reboot (2)
BackupInterval
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Ambang Interval Pencadangan"), Unit ("menit")
Tidak didukung. Sebagai gantinya, cadangkan repositori WMI secara manual.
BackupLastTime
-
Jenis data: tanggalwaktu
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32API|Fungsi Waktu|GetTimeZoneInformation")
Tanggal dan waktu pencadangan terakhir dilakukan.
BuildVersion
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|Build")
Informasi versi untuk layanan WMI yang saat ini diinstal.
Lamanya waktu yang berlalu di antara cadangan database WMI.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|Membangun
Caption
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (64)
Deskripsi tekstual pendek dari objek saat ini.
Properti ini diwarisi dari CIM_Setting.
DatabaseDirectory
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Direktori Repositori")
Jalur direktori yang berisi repositori WMI.
DatabaseMaxSize
-
Jenis data: uint32
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Ukuran DB Maks"), Unit ("kilobyte")
Ukuran maksimum repositori WMI.
Keterangan
-
Jenis data: string
-
Jenis akses: Baca-saja
Deskripsi tekstual objek saat ini.
Properti ini diwarisi dari CIM_Setting.
EnableAnonWin9x Koneksi ions
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableAnon Koneksi ions")
Tidak didukung.
EnableEvents
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableEvents")
Jika True, subsistem peristiwa WMI harus diaktifkan.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|CIMOM|EnableEvents
AktifkanStartupHeapPreallocation
-
Jenis data: boolean
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableStartupHeapPreallocation")
Jika True, WMI membuat timbunan yang telah dialokasikan sebelumnya dengan ukuran nilai LastStartupHeapPreallocation saat WMI diinisialisasi.
HighThresholdOnClientObjects
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Ambang Batas Tinggi Pada Objek Klien"), Unit ("objek per detik")
Tingkat maksimum di mana objek yang dibuat penyedia dapat dikirimkan ke klien. Untuk mengakomodasi diferensial kecepatan antara penyedia dan klien, WMI menyimpan objek dalam antrean sebelum mengirimkannya kepada konsumen. Untuk efisiensi yang lebih baik, konsumen harus mengumpulkan objek dengan kecepatan yang sesuai dengan penyedia. Jika memori yang dipegang oleh objek yang tidak dikenal mencapai LowThresholdOnObjects, maka WMI memperlambat penambahan objek baru ke dalam antrean. Jika peristiwa yang tidak terungkap terus menumpuk dan penantian maksimum untuk mengirimkan peristiwa di MaxWaitOnClientObjects tercapai saat memori yang digunakan berada pada nilai di HighThresholdOnClientObjects, maka WMI tidak menerima objek lagi dari penyedia dan mengembalikan WBEM_E_OUT_OF_MEMORY ke klien.
HighThresholdOnEvents
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Ambang Batas Tinggi Pada Peristiwa"), Unit ("peristiwa per detik")
Tingkat maksimum di mana peristiwa akan dikirimkan ke klien. Untuk mengakomodasi diferensial kecepatan antara penyedia dan klien, WMI mengantre peristiwa sebelum mengirimkannya kepada konsumen. Untuk efisiensi yang lebih tinggi, konsumen harus mengumpulkan peristiwa dengan kecepatan yang sesuai dengan penyedia. Jika memori yang dipegang oleh peristiwa yang tidak terungkap mencapai LowThresholdOnObjects, maka WMI memperlambat penambahan peristiwa baru ke dalam antrean. Jika peristiwa yang tidak terungkap terus menumpuk dan penantian maksimum untuk mengirimkan peristiwa di MaxWaitOnEvents tercapai saat memori yang digunakan berada pada nilai di HighThresholdOnEvents, WMI tidak menerima lagi peristiwa dari penyedia dan mengembalikan WBEM_E_OUT_OF_MEMORY kepada klien.
Catatan
Pembatasan hanya dilakukan untuk konsumen Peristiwa Permanen, sehingga konsumen sementara tidak boleh mengharapkan pembatasan ketika peristiwa dicadangkan dalam antrean peristiwa internal WMI.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\ CIMOM|Ambang Batas Tinggi Pada Objek Klien (B)
PenginstalanDirektori
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|Direktori Penginstalan")
Jalur direktori tempat perangkat lunak WMI telah diinstal. Lokasi defaultnya adalah \System32\Wbem.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|Direktori Penginstalan
LastStartupHeapPreallocation
-
Jenis data: uint32
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|LastStartupHeapPreallocation"), Unit ("byte")
Ukuran timbunan yang telah dialokasikan sebelumnya yang dibuat oleh WMI selama inisialisasi.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|CIMOM|LastStartupHeapPreallocation
LoggingDirectory
-
Jenis data: string
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Direktori Pengelogan")
Jalur direktori yang berisi lokasi file log sistem WMI.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|CIMOM|Direktori Pengelogan
LoggingLevel
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Pengelogan")
Mengaktifkan pengelogan peristiwa dan tingkat verbositas pengelogan yang digunakan.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|CIMOM|Penebangan
Nonaktif (0)
Pengelogan kesalahan (1)
Pengelogan Kesalahan Verbose (2)
LowThresholdOnClientObjects
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Ambang Batas Rendah Pada Objek Klien"), Unit ("objek per detik")
Laju di mana WMI mulai memperlambat pembuatan objek baru yang dibuat untuk klien. Untuk mengakomodasi diferensial kecepatan antara penyedia dan klien, WMI menyimpan objek dalam antrean sebelum mengirimkannya kepada konsumen. Untuk efisiensi yang lebih baik, konsumen harus mengumpulkan objek dengan kecepatan yang sesuai dengan penyedia. Jika tingkat permintaan untuk objek mencapai LowThresholdOnClientObjects, maka WMI secara bertahap memperlambat pembuatan objek baru agar sesuai dengan tingkat penggunaan klien. Perlambatan ini dimulai ketika laju saat objek dibuat melebihi nilai properti ini. Lihat HighThresholdOnClientObjects.
Properti ini mencerminkan nilai registri.
\KEY_LOCAL_MACHINE Software\Microsoft\WBEM\ CIMOM|Ambang Batas Tinggi Pada Objek Klien (B)
LowThresholdOnEvents
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Ambang Batas Rendah Pada Peristiwa"), Unit ("peristiwa per detik")
Tingkat di mana WMI mulai memperlambat pengiriman peristiwa baru. Untuk mengakomodasi diferensial kecepatan antara penyedia dan klien, WMI mengantre peristiwa sebelum mengirimkannya kepada konsumen. Untuk efisiensi yang lebih baik, konsumen harus mengumpulkan objek dengan kecepatan yang sesuai dengan penyedia. Jika antrean tumbuh di luar kendali, WMI akan melambat—melambat—pengiriman peristiwa secara bertahap agar selaras dengan tingkat klien. Perlambatan ini dimulai ketika tingkat di mana peristiwa dihasilkan melebihi nilai properti ini. Lihat HighThresholdOnEvents.
Catatan
Pembatasan hanya dilakukan untuk konsumen peristiwa permanen, sehingga konsumen sementara tidak boleh mengharapkan pembatasan ketika peristiwa dicadangkan dalam antrean peristiwa internal WMI.
Properti ini mencerminkan nilai registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\ CIMOM|Ambang Batas Tinggi Pada Objek Klien {B}
MaxLogFileSize
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Ukuran Maksimum File Log"), Unit ("byte")
Ukuran maksimum file log yang dihasilkan oleh layanan WMI.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|CIMOM|Ukuran Maksimum File Log
MaxWaitOnClientObjects
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Max Wait On Events"), Unit ("milidetik")
Jumlah waktu objek yang baru dibuat menunggu untuk digunakan oleh klien sebelum dibuang dan nilai kesalahan dikembalikan. Properti ini berinteraksi dengan properti LowThresholdOnClientObjects dan HighThresholdOnClientObjects untuk membatasi—memperlambat—pengiriman objek kepada konsumen ketika konsumen menerima objek terlalu lambat.
MaxWaitOnEvents
-
Jenis data: uint32
-
Jenis akses: Baca/tulis
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Max Wait On Events"), Unit ("milidetik")
Jumlah waktu saat peristiwa yang dikirim ke klien diantrekan sebelum dibuang. Properti ini berinteraksi0 dengan LowThresholdOnEvents dan HighThresholdOnEvents untuk membatasi—memperlambat—pengiriman objek kepada konsumen ketika konsumen menerima objek terlalu lambat.
Properti ini mencerminkan nilai registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\ CIMOM|Max Wait On Events (ms)
MofSelfInstallDirectory
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|Direktori Penginstalan Mandiri MOF")
Jalur direktori untuk aplikasi yang menginstal file MOF ke repositori WMI. WMI secara otomatis mengkompilasi file MOF apa pun yang ditempatkan di direktori ini dan, tergantung pada keberhasilannya, memindahkan MOF ke subdirektori berlabel baik atau buruk. Jika perintah # pragma autorecover disertakan, nama file yang sepenuhnya memenuhi syarat ditambahkan ke daftar AutorecoverMofs yang digunakan saat WMI menginisialisasi atau memulihkan repositori. Daftar menentukan urutan di mana MOF dikompilasi.
Properti ini mencerminkan nilai dalam kunci registri.
\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM|CIMOM|MOF Self=Install Directory
SettingID
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (256)
Pengidentifikasi tempat objek saat ini diketahui.
Properti ini diwarisi dari CIM_Setting.
Keterangan
Kelas Win32_WMISetting berasal dari CIM_Setting. Hanya satu instans kelas ini yang dapat ada di komputer.
Mengetahui bagaimana WMI dikonfigurasi di komputer dapat sangat berguna ketika Anda men-debug skrip atau memecahkan masalah dengan layanan WMI itu sendiri. Misalnya, banyak skrip WMI ditulis dengan asumsi bahwa root\cimv2 adalah namespace default pada komputer target. Akibatnya, penulis skrip yang perlu mengakses kelas di "Root\CIMv2" sering gagal menyertakan namespace dalam moniker GetObject, seperti yang ditunjukkan dalam sampel kode berikut:
Set colServices = GetObject("winmgmts:").ExecQuery ("SELECT * FROM Win32_Service")
Jika root\cimv2 bukan namespace default pada komputer target, skrip ini akan gagal. Untuk mencegah hal ini terjadi, namespace root\cimv2 harus disertakan dalam moniker, seperti yang ditunjukkan dalam sampel kode berikut:
Set colServices = GetObject("winmgmts:root\cimv2").ExecQuery("SELECT * FROM Win32_Service")
Jika namespace default pada komputer target berbeda dari namespace yang diasumsikan oleh skrip, skrip akan gagal. Selain itu, pengguna akan disajikan dengan pesan kesalahan yang agak menyesatkan "Kelas tidak valid." Sebenarnya, kegagalan bukan karena kelas tidak valid tetapi karena kelas tidak dapat ditemukan di namespace default. Ini adalah masalah yang sulit untuk memecahkan masalah, karena Anda cenderung menyelidiki kemungkinan masalah dengan kelas daripada masalah dengan namespace yang (atau, dalam hal ini, tidak ditentukan).
Anda dapat menggunakan kelas Win32_WMISetting untuk menentukan bagaimana WMI telah dikonfigurasi di komputer. Detail konfigurasi seperti namespace default atau nomor build WMI dapat berguna dalam memecahkan masalah skrip. Pengaturan ini juga memberikan informasi administratif penting seperti bagaimana, atau bahkan apakah, kesalahan WMI dicatat di komputer dan penyedia WMI mana yang akan secara otomatis dimuat ulang jika Anda perlu membangun kembali repositori WMI.
Contoh
Contoh kode VBScript berikut menunjukkan cara mendapatkan versi WMI yang berjalan di komputer lokal. "Win32_WMISetting=@" menunjukkan satu instans kelas. Untuk informasi selengkapnya, lihat Versi WMI.
set objWMIService = GetObject("winmgmts:{impersonationLevel=Impersonate}!/Root/CIMv2")
set objWMISetting = objWMIService.Get("Win32_WMISetting=@")
WScript.Echo objWMISetting.BuildVersion
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Baca juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk