Objek SWbemObject
Anda dapat menggunakan metode dan properti objek SWbemObject untuk mewakili satu definisi kelas Atau instans objek Windows Management Instrumentation (WMI). Objek ini tidak dapat dibuat oleh panggilan VBScript CreateObject .
Objek ini mendukung dua jenis properti dan metode. Yang didefinisikan di bagian ini adalah properti dan metode umum yang berlaku untuk semua objek WMI. Selain itu, objek ini mengekspos properti dan metode objek yang mendasar sebagai properti otomatisasi dinamis dan metode SWbemObject. Nama dan jenis properti dan metode ini bergantung pada objek WMI yang mendasar. Untuk informasi selengkapnya tentang bagaimana properti dan metode dinamis ini diekspos, lihat Memanipulasi Informasi Kelas dan Instans.
Dari perspektif klien WMI, objek ini selalu dalam proses. Operasi tulis hanya memengaruhi salinan lokal objek, dan operasi baca selalu mengambil nilai dari salinan lokal. Pembaruan untuk WMI dilakukan hanya ketika seluruh objek ditulis menggunakan panggilan ke metode SWbemObject.Put_. Jika Anda mengubah properti atau metode dalam objek SWbemObject , perubahan Anda tidak ditulis ke WMI hingga Anda memanggil SWbemObject.Put_.
Metode generik dan nama properti yang ditentukan di bagian ini selalu diakhir dengan garis bawah berikutnya ("_") untuk membedakannya dari metode WMI dinamis dan properti objek yang mendasar.
Perhatikan bahwa SWbemObject tidak dapat dibuat menggunakan VBScript GetObject.method. Jika Anda ingin membuat kelas baru yang kosong, gunakan SWbemServices.Dapatkan dengan parameter jalur kosong. Panggilan ini mengembalikan objek SWbemObject kosong yang dapat menjadi kelas. Anda kemudian dapat memberikan nama kelas untuk properti Kelas objek SWbemObjectPath yang dikembalikan oleh panggilan Path_. Tambahkan properti ke kelas baru dengan metode Properties_. Untuk membuat instans, panggil GetObject di kelas baru.
Contoh kode berikut menunjukkan cara mendapatkan kelas baru dan menambahkan properti ke dalamnya. Objek SWbemObject yang mewakili kelas harus ditulis kembali ke repositori WMI dengan panggilan ke Put_.
wbemCimtypeString = 8
Set objSWbemService = GetObject("Winmgmts:root\default")
Set objClass = objSWbemService.Get()
objClass.Path_.Class = "NewClass"
' Add a property
' String property
objClass.Properties_.add "PropertyName", wbemCimtypeString
' Make the property a key property
objClass.Properties_("PropertyName").Qualifiers_.add "key", true
' Write the new class to the root\default namespace in the repository
Set objClassPath = objClass.Put_
WScript.Echo objClassPath.Path
'Create an instance of the new class using SWbemObject.SpawnInstance
Set objNewInst = GetObject( _
"Winmgmts:root\default:NewClass").Spawninstance_
objNewInst.PropertyName = "My Instance"
' Write the instance into the repository
Set objInstancePath = objNewInst.Put_
WScript.Echo objInstancePath.Path
Anda dapat memeriksa repositori dengan alat tampilan seperti CIM Studio untuk memverifikasi bahwa kelas dan instans baru muncul. Untuk contoh menghapus kelas dan instans dari repositori, lihat SWbemServices.Delete atau SWbemObject.Delete_.
Objek SWbemObject memiliki jenis anggota ini:
Objek SWbemObject memiliki metode ini.
Metode | Deskripsi |
---|---|
Associators_ | Mengambil asosiator objek. |
AssociatorsAsync_ | Secara asinkron mengambil asosiator objek. |
Clone_ | Membuat salinan objek saat ini. |
CompareTo_ | Menguji dua objek untuk kesetaraan. |
Menghapus_ | Menghapus objek dari WMI. |
DeleteAsync_ | Secara asinkron menghapus objek dari WMI. |
ExecMethod_ | Menjalankan metode yang diekspor oleh penyedia metode. |
ExecMethodAsync_ | Secara asinkron menjalankan metode yang diekspor oleh penyedia metode. |
GetObjectText_ | Mengambil representasi tekstual objek (sintaks MOF). |
Contoh_ | Mengembalikan kumpulan instans objek (yang harus merupakan kelas WMI). |
InstancesAsync_ | Secara asinkron mengembalikan kumpulan instans objek (yang harus merupakan kelas WMI). |
Menempatkan_ | Membuat atau memperbarui objek di WMI. |
PutAsync_ | Secara asinkron membuat atau memperbarui objek di WMI. |
Referensi_ | Mengembalikan referensi ke objek. |
ReferencesAsync_ | Secara asinkron mengembalikan referensi ke objek. |
SpawnDerivedClass_ | Membuat kelas turunan baru dari objek saat ini (yang harus merupakan kelas WMI). |
SpawnInstance_ | Membuat instans baru dari objek saat ini. |
Subclasses_ | Mengembalikan kumpulan subkelas objek (yang harus merupakan kelas WMI). |
SubclassesAsync_ | Secara asinkron mengembalikan kumpulan subkelas objek (yang harus merupakan kelas WMI). |
Objek SWbemObject memiliki properti ini.
Properti | Jenis akses | Deskripsi |
---|---|---|
Derivasi_ |
Baca-saja |
Berisi array string yang menjelaskan hierarki derivasi untuk kelas. |
Metode_ |
Baca-saja |
Objek SWbemMethodSet yang merupakan kumpulan metode untuk objek ini. |
Jalan_ |
Baca-saja |
Berisi objek SWbemObjectPath yang mewakili jalur objek kelas atau instans saat ini. |
Properti_ |
Baca-saja |
Objek SWbemPropertySet yang merupakan kumpulan properti untuk objek ini. |
Kualifikasi_ |
Baca-saja |
Objek SWbemQualifierSet yang merupakan kumpulan kualifikasi untuk objek ini. |
Security_ |
Baca-saja |
Berisi objek SWbemSecurity yang digunakan untuk membaca atau mengubah pengaturan keamanan. |
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Header |
|
Pustaka jenis |
|
DLL |
|
CLSID |
CLSID_SWbemObject |
IID |
IID_ISWbemObject |