Bagikan melalui


Get-CimClass

Mendapatkan daftar kelas CIM di namespace tertentu.

Sintaks

ComputerSet (Default)

Get-CimClass
    [[-ClassName] <string>]
    [[-Namespace] <string>]
    [-Amended]
    [-OperationTimeoutSec <uint>]
    [-ComputerName <string[]>]
    [-MethodName <string>]
    [-PropertyName <string>]
    [-QualifierName <string>]
    [<CommonParameters>]

SessionSet

Get-CimClass
    [[-ClassName] <string>]
    [[-Namespace] <string>]
    -CimSession <CimSession[]>
    [-Amended]
    [-OperationTimeoutSec <uint>]
    [-MethodName <string>]
    [-PropertyName <string>]
    [-QualifierName <string>]
    [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

cmdlet Get-CimClass mengambil daftar kelas CIM di namespace tertentu. Jika tidak ada nama kelas yang disediakan, cmdlet mengembalikan semua kelas di namespace. Tidak seperti instans CIM, kelas CIM tidak berisi sesi CIM atau nama komputer tempat mereka diambil.

Contoh

Contoh 1: Mendapatkan semua definisi kelas

Contoh ini mendapatkan semua definisi kelas di bawah namespace root/CIMV2.

Get-CimClass

Contoh 2: Dapatkan kelas dengan nama tertentu

Contoh ini mendapatkan kelas yang berisi kata Disk dalam namanya.

Get-CimClass -ClassName *Disk*

Contoh 3: Dapatkan kelas dengan nama metode tertentu

Contoh ini mendapatkan kelas yang dimulai dengan nama Win32 dan memiliki nama metode yang dimulai dengan Term.

Get-CimClass -ClassName Win32* -MethodName Term*

Contoh 4: Mendapatkan kelas dengan nama properti tertentu

Contoh ini mendapatkan kelas yang dimulai dengan nama Win32 dan memiliki properti bernama Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Contoh 5: Dapatkan kelas dengan nama kualifikasi tertentu

Contoh ini mendapatkan kelas yang dimulai dengan nama Win32, berisi kata Disk dalam namanya dan memiliki kualifikasi yang ditentukan Asosiasi.

Get-CimClass -ClassName Win32*Disk* -QualifierName Association

Contoh 6: Mendapatkan definisi kelas dari namespace tertentu

Contoh ini mendapatkan definisi kelas yang berisi kata Net dalam namanya dari namespace layanan yang ditentukan root/StandardCimv2.

Get-CimClass -Namespace root/StandardCimv2 -ClassName *Net*

Contoh 7: Mendapatkan definisi kelas dari server jarak jauh

Contoh ini mendapatkan definisi kelas yang berisi kata Disk dalam namanya dari server jarak jauh yang ditentukan Server01 dan Server02.

Get-CimClass -ClassName *Disk* -ComputerName Server01, Server02

Contoh 8: Dapatkan kelas dengan menggunakan sesi CIM

$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *Disk* -CimSession $s

Kumpulan perintah ini membuat sesi dengan beberapa komputer dan menyimpannya ke dalam variabel $s menggunakan cmdlet New-CimSession, lalu mendapatkan kelas menggunakan cmdlet Get-CimClass.

Parameter

-Amended

Menunjukkan bahwa objek yang dikembalikan dari kueri CIM harus berisi informasi yang diubah. Biasanya, informasi yang diubah adalah informasi yang dapat dilokalkan, seperti deskripsi objek dan properti yang dilampirkan ke objek CIM. Ini berguna untuk menerjemahkan nilai numerik ke nilai yang dapat dibaca manusia.

Parameter ini ditambahkan di PowerShell 7.3.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-CimSession

Menjalankan cmdlet dalam sesi jarak jauh atau pada komputer jarak jauh. Masukkan nama komputer atau objek sesi, seperti output cmdlet New-CimSession atau Get-CimSession. Defaultnya adalah sesi saat ini pada komputer lokal.

Properti parameter

Jenis:

CimSession[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SessionSet
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ClassName

Menentukan nama kelas CIM untuk melakukan operasi. Anda dapat menggunakan penyelesaian tab untuk menelusuri daftar kelas, karena PowerShell mendapatkan daftar kelas dari server WMI lokal untuk menyediakan daftar nama kelas.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ComputerName

Menentukan 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, menggunakan sesi CIM memberikan performa yang lebih baik.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:CN, ServerName

Kumpulan parameter

ComputerSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-MethodName

Menemukan kelas yang memiliki metode yang cocok dengan nama ini. Anda dapat menggunakan karakter pengganti dengan parameter ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Namespace

Menentukan namespace untuk operasi CIM. 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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:1
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-OperationTimeoutSec

Menentukan jumlah waktu cmdlet menunggu respons dari komputer. 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.

Properti parameter

Jenis:UInt32
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:OT

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PropertyName

Menemukan kelas yang memiliki properti yang cocok dengan nama ini. Anda dapat menggunakan karakter pengganti dengan parameter ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-QualifierName

Memfilter kelas menurut nama kualifikasi tingkat kelas. Anda dapat menggunakan karakter pengganti dengan parameter ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

CimClass

Cmdlet ini mengembalikan objek kelas CIM.

Catatan

PowerShell menyertakan alias berikut untuk Get-CimClass:

  • Windows:
    • gcls

Cmdlet ini hanya tersedia di platform Windows.