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_.

Anggota

Objek SWbemObject memiliki jenis anggota ini:

• Metode
• Properti

Metode

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).

Properti

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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	Wbemdisp.h
Pustaka jenis	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Baca juga

SWbemObjectEx

Objek API Pembuatan Skrip