Bagikan melalui

kelas Win32_WMISetting

  • Artikel

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
CIMWin32.mof
DLL
Wbemcore.dll

Baca juga

CIM_Setting

Kelas Manajemen Layanan WMI