Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Get-CimInstance cmdlet’in bir CIM sunucusundan bir sınıfın CIM örneklerini almasını sağlar. Bu cmdlet için sınıf adını veya sorguyu belirtebilirsiniz. Bu cmdlet, CIM sunucusunda bulunan CIM örneklerinin anlık görüntüsünü temsil eden bir veya daha fazla CIM örneği nesnesi döndürür.
InputObject parametresi belirtilmezse, cmdlet aşağıdaki yollardan biriyle çalışır:
ComputerName parametresi veya CimSession parametresi belirtilmezse, bu cmdlet bir Bileşen Nesne Modeli (COM) oturumu kullanarak yerel Windows Yönetim Araçları'nda (WMI) çalışır.
ComputerName parametresi veya CimSession parametresi belirtilirse, bu cmdlet ComputerName parametresi veya CimSession parametresi tarafından belirtilen CIM sunucusunda çalışır.
InputObject parametresi belirtilirse, cmdlet aşağıdaki yollardan biriyle çalışır:
ComputerName parametresi veya CimSession parametresi belirtilmezse, bu cmdlet giriş nesnesinden CIM oturumunu veya bilgisayar adını kullanır.
ComputerName parametresi veya CimSession parametresi belirtilirse, bu cmdlet CimSession parametre değerini veya ComputerName parametre değerini kullanır.
Örnekler
Örnek 1: Belirtilen sınıfın CIM örneklerini alma
Bu örnek, Win32_Processadlı bir sınıfın CIM örneklerini alır.
Get-CimInstance -ClassName Win32_Process
Örnek 2: WMI sunucusundan ad alanlarının listesini alma
Bu örnek, bir WMI sunucusundaki kök ad alanının altındaki ad alanlarının listesini alır.
Örnek 3: Sorgu kullanarak filtrelenen bir sınıfın örneklerini alma
Bu örnek, Query parametresi tarafından belirtilen sorguyu kullanarak Win32_Process adlı sınıfın P harfiyle başlayan tüm CIM örneklerini alır.
Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'P%'"
Örnek 4: Sınıf adı ve filtre ifadesi kullanılarak filtrelenen sınıfın örneklerini alma
Bu örnek, Filter parametresini kullanarak Win32_Process adlı sınıfın P harfiyle başlayan tüm CIM örneklerini alır.
Get-CimInstance -ClassName Win32_Process -Filter "Name like 'P%'"
Örnek 5: Yalnızca anahtar özellikleri doldurulmuş CIM örneklerini alma
Bu örnek, anahtar özelliğine sahip @{ "Handle"=0 } adlı bir sınıf için bellekte yeni bir CIM örneği oluşturur ve $xadlı bir değişkende depolar. Değişken, belirli bir örneği almak için Get-CimInstance cmdlet'ine CIM örneği olarak geçirilir.
Bu örnek, Win32_Process adlı bir sınıfın CIM örneklerini alır ve bunları $x ve $ydeğişkenlerinde depolar. değişkeni daha sonra yalnızca Adı ve KernelModeTime özelliklerini içeren bir tabloda biçimlendirilir ve tablo otomatikolarak ayarlanır.
Özelliği parametresiyle alınan örnek, Set-CimInstance veya Invoke-CimMethodgibi diğer CIM işlemlerini gerçekleştirmek için kullanılabilir.
Örnek 10: CIM oturumunu kullanarak CIM örneğini alma
Bu örnek, cmdlet'ini kullanarak Server01 ve New-CimSession adlı bilgisayarlarda bir CIM oturumu oluşturur ve oturum bilgilerini $sadlı bir değişkende depolar. Değişkenin içeriği daha sonra, Get-CimInstanceadlı sınıfın CIM örneklerini almak için CimSession parametresi kullanılarak 'a geçirilir.
Bu cmdlet için kullanılacak CIM oturumunu belirtir. CIM oturumunu içeren bir değişken veya New-CimSession veya Get-CimSession cmdlet'leri gibi CIM oturumunu oluşturan veya alan bir komut girin. Daha fazla bilgi için bkz. about_CimSession.
CIM örneklerinin alındığı CIM sınıfının adını belirtir. PowerShell, sınıf adlarının listesini sağlamak için yerel WMI sunucusundan sınıfların listesini aldığından, sınıf listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.
CIM işlemini çalıştırmak istediğiniz bilgisayarı belirtir. Tam olarak belirtilmiş etki alanı adı (FQDN), NetBIOS adı veya IP adresi belirtebilirsiniz. Bu parametreyi belirtmezseniz, cmdlet işlemi Bileşen Nesne Modeli (COM) kullanarak yerel bilgisayarda gerçekleştirir.
Bu parametreyi belirtirseniz, cmdlet WsMan protokolunu kullanarak belirtilen bilgisayarda geçici bir oturum oluşturur.
Aynı bilgisayarda birden çok işlem gerçekleştiriliyorsa, daha iyi performans için CIM oturumu kullanarak bağlanın.
Filtre olarak kullanılacak where yan tümcesini belirtir. yan tümcesini WQL veya CQL sorgu dilinde belirtin. parametresinin değerine WHERE anahtar sözcüğünü eklemeyin.
Giriş olarak kullanılacak bir CIM örneği nesnesi belirtir.
Zaten bir CIM örneği nesnesiyle çalışıyorsanız, CIM sunucusundan en son anlık görüntüyü almak için CIM örnek nesnesini geçirmek için bu parametreyi kullanabilirsiniz. Bir CIM örneği nesnesini giriş olarak geçirdiğinizde, Get-CimInstance listeleme veya sorgu işlemi yerine get CIM işlemini kullanarak sunucudan nesneyi döndürür. Get CIM işlemi kullanmak, tüm örnekleri alıp sonra bunları filtrelemekten daha verimlidir.
InputObject parametresi koleksiyonlar üzerinde numaralandırılmıyor. Bir koleksiyon aktarılırsa bir hata oluşur. Koleksiyonlarla çalışırken, değerleri numaralandırmak için girdiyi yönlendirin.
CIM sınıfı get işlemini uygulamazsa, InputObject parametresinin belirtilmesi bir hata döndürür.
Yalnızca anahtar özellikleri doldurulmuş nesnelerin döndürüldüğünü gösterir.
KeyOnly parametresinin belirtilmesi ağ üzerinden aktarılan veri miktarını azaltır.
veya Set-CimInstance cmdlet'leri gibi diğer işlemler için kullanılabilen nesnenin yalnızca küçük bir bölümünü döndürmek için Get-CimAssociatedInstance parametresini kullanın.
Varsayılan ad alanı kök/CIMV2 . PowerShell, ad alanlarının listesini sağlamak üzere yerel WMI sunucusundan bir ad alanı listesi aldığından, ad alanları listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.
Cmdlet'in bilgisayardan yanıt bekleme süresini belirtir. Varsayılan olarak, bu parametrenin değeri 0'dır; bu da cmdlet'in sunucu için varsayılan zaman aşımı değerini kullandığı anlamına gelir.
OperationTimeoutSec parametresi 3 dakikalık sağlam bağlantı yeniden deneme zaman aşımından daha küçük bir değere ayarlanırsa, istemci yeniden bağlanamadan önce sunucudaki işlem zaman aşımına uğraması nedeniyle OperationTimeoutSec parametresinin değerinden daha uzun süren ağ hataları kurtarılamaz.
Alınacak örnek özellikler kümesini belirtir. Döndürülen nesnenin boyutunu bellekte veya ağ üzerinden azaltmanız gerektiğinde bu parametreyi kullanın. Döndürülen nesne, Özelliği parametresini kullanarak bunları listelemiyor olsanız bile anahtar özelliklerini de içerir. Sınıfın diğer özellikleri vardır, ancak doldurulmamıştır.
CIM sunucusunda çalıştırılacak sorguyu belirtir. Belirtilen değer çift tırnak işareti ", tek tırnak işareti 'veya ters eğik çizgi \içeriyorsa, bu karakterlere ters eğik çizgi karakteri ön ekleyerek bu karakterlerden kaçmalısınız. Belirtilen değer WQL LIKE işlecini kullanıyorsa, bunları köşeli ayraç içine []içine alarak şu karakterlerden kaçmalısınız: yüzde %, alt çizgi _veya [köşeli ayraç açma.
Sınıfların listesini veya olay sorgusunu almak için meta veri sorgusu kullanamazsınız. Sınıfların listesini almak için Get-CimClass cmdlet'ini kullanın. Olay sorgusu almak için Register-CimIndicationEvent cmdlet'ini kullanın.
QueryDialect parametresini kullanarak sorgu diyalektini belirtebilirsiniz.
Sorgu parametresi için kullanılan sorgu dilini belirtir. Bu parametre için kabul edilebilir değerler şunlardır: WQL veya CQL. Varsayılan değer WQLdeğeridir.
Kaynak sınıfının veya örneğinin tekdüzen kaynak tanımlayıcısını (URI) belirtir. URI, bir bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.
URI bir ön ek ve kaynağın yolundan oluşur. Örneğin:
Varsayılan olarak, bu parametreyi belirtmezseniz, DMTF standart kaynak URI'sini http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ kullanılır ve sınıf adı eklenir.
ResourceUri yalnızca WSMan protokolü kullanılarak oluşturulan CIM oturumlarıyla veya WSMan kullanarak bir CIM oturumu oluşturan ComputerName parametresi belirtilirken kullanılabilir.
ComputerName parametresini belirtmeden bu parametreyi belirtirseniz veya DCOM protokolü kullanılarak oluşturulan bir CIM oturumu belirtirseniz, DCOM protokolü ResourceUri parametresini desteklemediğinden bir hata alırsınız.
hem ResourceUri parametresi hem de Filter parametresi belirtilirse, Filter parametresi yoksayılır.
Bir sınıfın örneklerinin, herhangi bir alt sınıfın örnekleri dahil edilmeden döndürüldüğünü gösterir. Varsayılan olarak, cmdlet bir sınıfın ve onun alt sınıflarının örneklerini döndürür.
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Bu içeriğin kaynağı GitHub'da bulunabilir; burada ayrıca sorunları ve çekme isteklerini oluşturup gözden geçirebilirsiniz. Daha fazla bilgi içinkatkıda bulunan kılavuzumuzu inceleyin.