cmdlet New-CimInstance membuat instans kelas CIM berdasarkan definisi kelas pada komputer lokal atau komputer jarak jauh. Secara default, cmdlet New-CimInstance membuat instans di komputer lokal.
Contoh
Contoh 1: Membuat instans kelas CIM
Contoh ini membuat instans Kelas CIM bernama Win32_Environment di namespace root/CIMV2 di komputer.
Tidak ada validasi sisi klien yang dilakukan jika kelas tidak ada, properti salah, atau jika server menolak panggilan. Jika instans berhasil dibuat, cmdlet menghasilkan instans yang baru dibuat.
Contoh 2: Membuat instans kelas CIM menggunakan skema kelas
Contoh ini mengambil objek kelas CIM dan menyimpannya dalam variabel bernama $class. Konten variabel kemudian diteruskan ke cmdlet New-CimInstance.
Contoh ini membuat instans dinamis kelas CIM bernama Win32_Process di komputer klien tanpa mendapatkan instans dari server. Instans baru disimpan dalam variabel $a. Instans dinamis ini dapat digunakan untuk melakukan operasi jika instans dengan kunci ini ada di server.
ProcessId Name HandleCount WorkingSetSize VirtualSize
--------- ---- ----------- -------------- -----------
0 System Idle Process 0 8192 8192
Domain :
ReturnValue : 2
User :
PSComputerName :
Cmdlet Get-CimInstance kemudian mengambil satu instans tertentu. Cmdlet Invoke-CimMethod memanggil metode GetOwner pada instans yang diambil.
Contoh 4: Membuat instans untuk kelas CIM dari namespace tertentu
Contoh ini mendapatkan instans kelas CIM bernama MSFT_Something di namespace root/somewhere dan menyimpannya dalam variabel bernama $class. Variabel diteruskan ke cmdlet New-CimInstance untuk membuat instans CIM baru dan melakukan validasi sisi klien pada instans baru.
Dalam contoh ini, menggunakan parameter CimClass alih-alih parameter ClassName memvalidasi bahwa prop1 dan Prop2 benar-benar ada dan bahwa kunci ditandai dengan benar.
Anda tidak dapat menggunakan parameter ComputerName atau CimSession dengan parameter ClientOnly.
Parameter
-CimClass
Menentukan objek kelas CIM yang mewakili jenis instans. Gunakan cmdlet Get-CimClass untuk mengambil deklarasi kelas dari komputer. Menggunakan parameter ini menghasilkan validasi skema sisi klien yang lebih baik.
Menjalankan perintah menggunakan sesi CIM yang ditentukan. Masukkan variabel yang berisi sesi CIM, atau perintah yang membuat atau mendapatkan sesi CIM, seperti cmdlet New-CimSession atau Get-CimSession. Untuk informasi lebih lanjut, lihat about_CimSession.
Menentukan nama kelas CIM tempat operasi membuat instans. CATATAN: Anda dapat menggunakan penyelesaian tab untuk menelusuri daftar kelas, karena PowerShell mendapatkan daftar kelas dari server WMI lokal untuk menyediakan daftar nama kelas.
Menunjukkan bahwa instans hanya dibuat di PowerShell tanpa masuk ke server CIM. Anda dapat menggunakan parameter ini untuk membuat instans CIM dalam memori untuk digunakan dalam operasi PowerShell berikutnya.
Menentukan nama komputer tempat Anda ingin menjalankan operasi CIM. Anda dapat menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN), nama NetBIOS, atau alamat IP.
Jika Anda menentukan parameter ini, cmdlet membuat sesi sementara ke komputer yang ditentukan menggunakan protokol WSMan.
Jika Anda tidak menentukan parameter ini, cmdlet melakukan operasi pada komputer lokal menggunakan Model Objek Komponen (COM).
Jika beberapa operasi sedang dilakukan pada komputer yang sama, menyambungkan menggunakan sesi CIM memberikan performa yang lebih baik.
Menentukan namespace kelas untuk instans baru. Namespace default root/CIMV2 .
Anda dapat menggunakan penyelesaian tab untuk menelusuri daftar namespace, karena PowerShell mendapatkan daftar namespace dari server WMI lokal untuk menyediakan daftar namespace.
Menentukan jumlah waktu cmdlet menunggu respons dari server CIM. Secara default, nilai parameter ini adalah 0, yang berarti bahwa cmdlet menggunakan nilai batas waktu default untuk server. Jika parameter OperationTimeoutSec diatur ke nilai yang kurang dari batas waktu coba lagi koneksi yang kuat selama 3 menit, kegagalan jaringan yang berlangsung lebih dari nilai parameter OperationTimeoutSec tidak dapat dipulihkan, karena operasi pada server habis sebelum klien dapat terhubung kembali.
Menentukan properti instans CIM menggunakan tabel hash (pasangan nama-nilai).
Jika Anda menentukan parameter CimClass, cmdlet New-CimInstance melakukan validasi properti pada klien untuk memastikan bahwa properti yang ditentukan konsisten dengan deklarasi kelas di server. Jika parameter CimClass tidak ditentukan, maka validasi properti dilakukan di server.
Menentukan pengidentifikasi sumber daya seragam sumber daya (URI) dari kelas atau instans sumber daya. URI digunakan untuk mengidentifikasi jenis sumber daya tertentu, seperti disk atau proses, di komputer.
URI terdiri dari awalan dan jalur ke sumber daya. Contohnya:
Secara default, jika Anda tidak menentukan parameter ini, URI sumber daya standar DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ digunakan dan nama kelas ditambahkan ke parameter tersebut.
ResourceUri hanya dapat digunakan dengan sesi CIM yang dibuat menggunakan protokol WSMan, atau saat menentukan parameter ComputerName, yang membuat sesi CIM menggunakan WSMan. Jika Anda menentukan parameter ini tanpa menentukan parameter ComputerName, atau jika Anda menentukan sesi CIM yang dibuat menggunakan protokol DCOM, Anda akan mendapatkan kesalahan, karena protokol DCOM tidak mendukung parameter ResourceUri.
Jika parameter ResourceUri dan parameter Filter ditentukan, parameter Filter diabaikan.
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
