Megosztás a következőn keresztül:

Get-CimInstance

  • Referencia
Modul:
CimCmdlets

Lekéri egy osztály CIM-példányait egy CIM-kiszolgálóról.

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

Ez a parancsmag csak a Windows platformon érhető el.

A Get-CimInstance parancsmag lekéri egy osztály CIM-példányait egy CIM-kiszolgálóról. Megadhatja a parancsmag osztálynevét vagy lekérdezését. Ez a parancsmag egy vagy több CIM-példányobjektumot ad vissza, amely a CIM-kiszolgálón található CIM-példányok pillanatképét jeleníti meg.

Ha az InputObject paraméter nincs megadva, a parancsmag az alábbi módok egyikével működik:

  • Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a helyi Windows Management Instrumentation (WMI) rendszeren működik egy komponensobjektum-modell (COM) munkamenettel.
  • Ha a ComputerName paraméter vagy a CimSession paraméter van megadva, akkor ez a parancsmag a ComputerName vagy a CimSession paraméter által megadott CIM-kiszolgálóval működik.

Ha az InputObject paraméter meg van adva, a parancsmag a következő módok egyikével működik:

  • Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a bemeneti objektum CIM-munkamenetét vagy számítógépnevét használja.
  • Ha a ComputerName vagy a CimSession paraméter van megadva, akkor ez a parancsmag a CimSession paraméter vagy a ComputerName paraméter értékét használja.

Példák

1. példa: Adott osztály CIM-példányainak lekérése

Ez a példa egy Win32_Process nevű osztály CIM-példányait kéri le.

Get-CimInstance -ClassName Win32_Process

2. példa: Névterek listájának lekérése WMI-kiszolgálóról

Ez a példa egy WMI-kiszolgáló gyökérnévterében található névterek listáját kéri le.

Get-CimInstance -Namespace root -ClassName __Namespace

3. példa: Egy osztály példányainak lekérdezéssel szűrt lekérése

Ez a példa lekéri az összes OLYAN CIM-példányt, amely egy Win32_Process nevű osztály P betűjével kezdődik a Lekérdezés paraméter által megadott lekérdezéssel.

Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'P%'"

4. példa: Osztálynév és szűrőkifejezés használatával szűrt osztálypéldányok lekérése

Ez a példa lekéri az összes OLYAN CIM-példányt, amely egy Win32_Process nevű osztály P betűjével kezdődik a Szűrő paraméterrel.

Get-CimInstance -ClassName Win32_Process -Filter "Name like 'P%'"

5. példa: Csak a kulcstulajdonságokat tartalmazó CIM-példányok lekérése

Ez a példa létrehoz egy új CIM-példányt a memóriában egy Win32_Process nevű osztály számára a kulcstulajdonság @{ "Handle"=0 } használatával, és egy nevesített $xváltozóban tárolja. A változót a rendszer CIM-példányként továbbítja a Get-CimInstance parancsmagnak egy adott példány lekéréséhez.

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

6. példa: CIM-példányok lekérése és újbóli felhasználása

Ez a példa lekéri egy Win32_Process nevű osztály CIM-példányait, és tárolja őket a változókban $x és $ya . A változó $x ezután egy olyan táblában lesz formázva, amely csak a Név és a KernelModeTime tulajdonságokat tartalmazza, és a tábla automatikus méretezésre van beállítva.

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

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

7. példa: CIM-példányok lekérése távoli számítógépről

Ez a példa egy Win32_ComputerSystem nevű osztály CIM-példányait kéri le a Server01 és Server02 nevű távoli számítógépekről.

Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName Server01,Server02

8. példa: Csak a kulcstulajdonságok lekérése az összes tulajdonság helyett

Ez a példa csak a kulcstulajdonságokat kéri le, ami csökkenti az objektum és a hálózati forgalom méretét.

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

9. példa: Csak a tulajdonságok egy részhalmazának lekérése az összes tulajdonság helyett

Ez a példa csak a tulajdonságok egy részhalmazát kéri le, ami csökkenti az objektum és a hálózati forgalom méretét.

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

A Tulajdonság paraméterrel lekért példány más CIM-műveletek végrehajtására is használható, például Set-CimInstance Invoke-CimMethodvagy .

10. példa: A CIM-példány lekérése CIM-munkamenet használatával

Ez a példa létrehoz egy CIM-munkamenetet a Server01 és a Server02 nevű számítógépeken a New-CimSession parancsmag használatával, és a munkamenet adatait egy névvel ellátott $sváltozóban tárolja. A változó tartalmát ezután a CimSession paraméterrel továbbítja Get-CimInstance a rendszer a Win32_ComputerSystem nevű osztály CIM-példányainak lekéréséhez.

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

Paraméterek

-CimSession

Megadja a parancsmaghoz használandó CIM-munkamenetet. Adjon meg egy változót, amely tartalmazza a CIM-munkamenetet, vagy egy parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például a New-CimSession parancsmagokat.Get-CimSession További információ: about_CimSession.

Típus:CimSession[]
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ClassName

Megadja annak a CIM-osztálynak a nevét, amelyhez le szeretné kérni a CIM-példányokat. A tabulátorkiegészítéssel tallózhat az osztályok listájában, mivel a PowerShell lekéri a helyi WMI-kiszolgálóról az osztályok listáját az osztálynevek listájának megadásához.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ComputerName

Azt a számítógépet adja meg, amelyen futtatni szeretné a CIM-műveletet. Megadhat teljes tartománynevet (FQDN), NetBIOS-nevet vagy IP-címet. Ha nem adja meg ezt a paramétert, a parancsmag a helyi számítógépen hajtja végre a műveletet a Component Object Model (COM) használatával.

Ha megadja ezt a paramétert, a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WsMan protokoll használatával.

Ha több műveletet végez ugyanazon a számítógépen, csatlakozzon egy CIM-munkamenet használatával a jobb teljesítmény érdekében.

Típus:String[]
Aliasok:CN, ServerName
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Filter

Megadja a szűrőként használandó hol található záradékot. Adja meg a záradékot a WQL-ben vagy a CQL lekérdezési nyelvben. Ne vegye fel a WHERE kulcsszót a paraméter értékére.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-InputObject

Megadja a bemenetként használni kívánt CIM-példányobjektumot.

Ha már dolgozik EGY CIM-példányobjektumon, ezzel a paraméterrel továbbíthatja a CIM-példány objektumát, hogy lekérje a legújabb pillanatképet a CIM-kiszolgálóról. Ha egy CIM-példányobjektumot bemenetként ad át, Get-CimInstance az enumerálási vagy lekérdezési művelet helyett egy beolvasási CIM-művelettel adja vissza az objektumot a kiszolgálóról. A GET CIM-művelet hatékonyabb, mint az összes példány lekérése, majd szűrése.

Az InputObject paraméter nem számba veszi a gyűjteményeket. Ha egy gyűjteményt ad át, hibaüzenet jelenik meg. A gyűjtemények használatakor a bemenetet a bemenetet az értékek számbavételéhez kell beszűkíteni.

Ha a CIM-osztály nem implementálja a lekérési műveletet, akkor az InputObject paraméter megadása hibát ad vissza.

Típus:CimInstance
Aliasok:CimInstance
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-KeyOnly

Azt jelzi, hogy a rendszer csak a kulcstulajdonságokkal rendelkező objektumokat adja vissza. A KeyOnly paraméter megadása csökkenti a hálózaton keresztül továbbított adatok mennyiségét.

A KeyOnly paraméterrel az objektumnak csak egy kis részét adja vissza, amely más műveletekhez, például a Set-CimInstance Get-CimAssociatedInstance parancsmagokhoz is használható.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Namespace

A CIM-osztály névterét adja meg.

Az alapértelmezett névtér a root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek listájában, mivel a PowerShell lekéri a névterek listáját a helyi WMI-kiszolgálóról a névterek listájának megadásához.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-OperationTimeoutSec

Megadja, hogy a parancsmag mennyi időt vár a számítógép válaszára. Alapértelmezés szerint ennek a paraméternek az értéke 0, ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.

Ha az OperationTimeoutSec paraméter értéke kisebb, mint a robusztus kapcsolat újrapróbálkozási időtúllépése 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.

Típus:UInt32
Aliasok:OT
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Property

A lekérendő példánytulajdonságok halmazát adja meg. Ezt a paramétert akkor használja, ha csökkentenie kell a visszaadott objektum méretét a memóriában vagy a hálózaton keresztül. A visszaadott objektum akkor is tartalmazza a kulcstulajdonságokat, ha még nem sorolta fel őket a Tulajdonság paraméterrel. Az osztály többi tulajdonsága is jelen van, de nincsenek feltöltve.

Típus:String[]
Aliasok:SelectProperties
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Query

A CIM-kiszolgálón futtatandó lekérdezést adja meg. Ha a megadott érték dupla idézőjeleket ", egyszeri idézőjeleket 'vagy fordított perjeleket \tartalmaz, ezeket a karaktereket a fordított perjel karakterrel való előtagolásával kell feloldani. Ha a megadott érték a WQL LIKE operátort használja, akkor a következő karaktereket el kell hárítania, ha szögletes zárójelekbe []foglalja őket: százalék %, aláhúzás _vagy nyitó szögletes zárójel [.

Nem használhat metaadat-lekérdezést osztályok vagy esemény lekérdezések listájának lekéréséhez. Az osztályok listájának lekéréséhez használja a Get-CimClass parancsmagot. Eseménylekérdezés lekéréséhez használja a Register-CimIndicationEvent parancsmagot.

A lekérdezés dialektusát a QueryDialect paraméterrel adhatja meg.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-QueryDialect

A Lekérdezés paraméterhez használt lekérdezési nyelvet adja meg. A paraméter elfogadható értékei a következők: WQL vagy CQL. Az alapértelmezett érték a WQL.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ResourceUri

Az erőforrásosztály vagy -példány erőforrás-egységes erőforrás-azonosítóját (URI) adja meg. Az URI egy adott típusú erőforrás, például lemezek vagy folyamatok azonosítására szolgál a számítógépen.

Az URI egy előtagból és egy erőforrás elérési útból áll. Példa:

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

Alapértelmezés szerint, ha nem adja meg ezt a paramétert, a rendszer a DMTF standard erőforrás-URI-t http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ használja, és hozzáfűzi az osztály nevét.

A ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel használható, vagy a ComputerName paraméter megadásakor, amely a WSMan használatával hoz létre CIM-munkamenetet. Ha ezt a paramétert a ComputerName paraméter megadása nélkül adja meg, vagy ha egy DCOM protokoll használatával létrehozott CIM-munkamenetet ad meg, hibaüzenet jelenik meg, mert a DCOM protokoll nem támogatja a ResourceURI paramétert.

Ha a ResourceUri paraméter és a Szűrő paraméter is meg van adva, a szűrő paraméter figyelmen kívül lesz hagyva.

Típus:Uri
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Shallow

Azt jelzi, hogy egy osztály példányait a rendszer a gyermekosztályok példányainak hozzáadása nélkül adja vissza. Alapértelmezés szerint a parancsmag egy osztály és annak gyermekosztályai példányait adja vissza.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

CimInstance

Ehhez a parancsmaghoz CIM-példányobjektumot csövezhet.

Kimenetek

CimInstance

Ez a parancsmag egy vagy több CIM-példányobjektumot ad vissza, amely a CIM-kiszolgálón található CIM-példányok pillanatképét jelöli.

Jegyzetek

A PowerShell a következő aliasokat Get-CimInstancetartalmazza:

  • Windows:
    • gcim

Ez a parancsmag csak Windows-platformokon érhető el.