Aracılığıyla paylaş

Get-CimInstance

  • Başvuru
Modül:
CimCmdlets

CiM sunucusundan bir sınıfın CIM örneklerini alır.

Syntax

Get-CimInstance
   [-ClassName] <String>
   [-ComputerName <String[]>]
   [-KeyOnly]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-QueryDialect <String>]
   [-Shallow]
   [-Filter <String>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-CimInstance
   -CimSession <CimSession[]>
   -ResourceUri <Uri>
   [-KeyOnly]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-Shallow]
   [-Filter <String>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-CimInstance
   -CimSession <CimSession[]>
   [-ResourceUri <Uri>]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   -Query <String>
   [-QueryDialect <String>]
   [-Shallow]
   [<CommonParameters>]
Get-CimInstance
   -CimSession <CimSession[]>
   [-ClassName] <String>
   [-KeyOnly]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-QueryDialect <String>]
   [-Shallow]
   [-Filter <String>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-CimInstance
   -CimSession <CimSession[]>
   [-ResourceUri <Uri>]
   [-OperationTimeoutSec <UInt32>]
   [-InputObject] <CimInstance>
   [<CommonParameters>]
Get-CimInstance
   [-ResourceUri <Uri>]
   [-ComputerName <String[]>]
   [-OperationTimeoutSec <UInt32>]
   [-InputObject] <CimInstance>
   [<CommonParameters>]
Get-CimInstance
   -ResourceUri <Uri>
   [-ComputerName <String[]>]
   [-KeyOnly]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-Shallow]
   [-Filter <String>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-CimInstance
   [-ResourceUri <Uri>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   -Query <String>
   [-QueryDialect <String>]
   [-Shallow]
   [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

cmdlet'i Get-CimInstance bir CIM sunucusundan sınıfın CIM örneklerini alır. 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_Process adlı 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ı altındaki ad alanlarının listesini alır.

Get-CimInstance -Namespace root -ClassName __Namespace

Örnek 3: Sorgu kullanarak filtrelenen bir sınıfın örneklerini alma

Bu örnek, bir 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 @{ "Handle"=0 } sahip Win32_Process adlı bir sınıf için bellekte yeni bir CIM örneği oluşturur ve adlı $xbir değişkende depolar. Değişken, belirli bir örneği almak için Get-CimInstance cmdlet'ine CIM örneği olarak geçirilir.

$x = New-CimInstance -ClassName Win32_Process -Namespace root\cimv2 -Property @{ "Handle"=0 } -Key Handle -ClientOnly
Get-CimInstance -CimInstance $x

Örnek 6: CIM örneklerini alma ve yeniden kullanma

Bu örnek, Win32_Process adlı bir sınıfın CIM örneklerini alır ve bunları ve $ydeğişkenlerinde depolar$x. $x Değişken daha sonra yalnızca Name ve KernelModeTime özelliklerini içeren bir tabloda biçimlendirilir ve tablo OtomatikLeştir olarak ayarlanır.

$x,$y = Get-CimInstance -ClassName Win32_Process
$x | Format-Table -Property Name,KernelModeTime -AutoSize

Name                 KernelModeTime
----                 --------------
System Idle Process 157238797968750

Örnek 7: CiM örneklerini uzak bilgisayardan alma

Bu örnek, Server01 ve Server02 adlı uzak bilgisayarlardan Win32_ComputerSystem adlı sınıfın CIM örneklerini alır.

Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01,Server02

Örnek 8: Tüm özellikler yerine yalnızca anahtar özellikleri alma

Bu örnek yalnızca nesnenin ve ağ trafiğinin boyutunu azaltan temel özellikleri alır.

$x = Get-CimInstance -Class Win32_Process -KeyOnly
$x | Invoke-CimMethod -MethodName GetOwner

Örnek 9: Tüm özellikler yerine özelliklerin yalnızca bir alt kümesini alma

Bu örnek, nesnenin ve ağ trafiğinin boyutunu azaltan özelliklerin yalnızca bir alt kümesini alır.

Get-CimInstance -Class Win32_Process -Property Name,KernelModeTime
$x = Get-CimInstance -Class Win32_Process -Property Name,KernelModeTime
$x | Invoke-CimMethod -MethodName GetOwner

Property parametresiyle alınan örnek, veya Invoke-CimMethodgibi Set-CimInstance 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 Server02 adlı bilgisayarlarda bir CIM oturumu oluşturur ve oturum bilgilerini adlı $sbir değişkende depolarNew-CimSession. Değişkenin içeriği, Win32_ComputerSystem adlı sınıfın CIM örneklerini almak için CimSession parametresi kullanılarak öğesine geçirilirGet-CimInstance.

$s = New-CimSession -ComputerName Server01,Server02
Get-CimInstance -ClassName Win32_ComputerSystem -CimSession $s

Parametreler

-CimSession

Bu cmdlet için kullanılacak CIM oturumunu belirtir. CIM oturumunu içeren bir değişken veya VEYA cmdlet'leri gibi CIM oturumunu New-CimSessionGet-CimSession oluşturan veya alan bir komut girin. Daha fazla bilgi için bkz . about_CimSession.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ClassName

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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

CIM işlemini çalıştırmak istediğiniz bilgisayarı belirtir. Tam 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.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Filter

Filtre olarak kullanılacak where yan tümcesini belirtir. Yan tümcesini WQL veya CQL sorgu dilinde belirtin. parametresinin WHERE değerine anahtar sözcüğünü eklemeyin.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

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 nesneyi listeleme veya sorgu işlemi yerine get CIM işlemi kullanarak sunucudan 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 geçirilirse bir hata oluşur. Koleksiyonlarla çalışırken, değerleri numaralandırmak için girişi kanala yazın.

CIM sınıfı get işlemini uygulamazsa InputObject parametresinin belirtilmesi bir hata döndürür.

Type:CimInstance
Aliases:CimInstance
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyOnly

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 Get-CimAssociatedInstance 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 KeyOnly parametresini Set-CimInstance kullanın.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

CIM sınıfının ad alanını belirtir.

Varsayılan ad alanı root/cimv2'dir. 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

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.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Property

Alınacak örnek özellikleri 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, Property parametresini kullanarak bunları listelemiyor olsanız bile anahtar özelliklerini de içerir. Sınıfın diğer özellikleri vardır, ancak doldurulmazlar.

Type:String[]
Aliases:SelectProperties
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Query

CIM sunucusunda çalıştırılacak sorguyu belirtir. Belirtilen değer çift tırnak ", tek tırnak 'veya ters eğik çizgi \içeriyorsa, bu karakterlerin önüne ters eğik çizgi karakteri ekleyerek kaçış yapmanız gerekir. Belirtilen değer WQL LIKE işlecini kullanıyorsa, bunları köşeli ayraç 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 cmdlet'ini Get-CimClass kullanın. Olay sorgusu almak için cmdlet'ini Register-CimIndicationEvent kullanın.

QueryDialect parametresini kullanarak sorgu diyalektini belirtebilirsiniz.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-QueryDialect

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 WQL'dir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceUri

Kaynak sınıfının veya örneğin kaynak 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:

  • http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
  • http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

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 cim oturumu oluşturan ComputerName parametresini belirtirken 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.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Shallow

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

CimInstance

CiM örneği nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

CimInstance

Bu cmdlet, CIM sunucusundaki CIM örneklerinin anlık görüntüsünü temsil eden bir veya daha fazla CIM örneği nesnesi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları Get-CimInstanceiçerir:

  • Windows:
    • gcim

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.