Get-CimInstance
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_Process2. 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 __Namespace3. 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 $x6. 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 1572387979687507. 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,Server028. 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 GetOwner9. 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 GetOwnerA 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-CimInstanceInvoke-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 $sParamé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.
| Type: | CimSession[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Aliases: | CN, ServerName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | CimInstance |
| Aliases: | CimInstance |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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-CimInstanceGet-CimAssociatedInstance parancsmagokhoz is használható.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | UInt32 |
| Aliases: | OT |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Aliases: | SelectProperties |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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_LogicalDiskhttp://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.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Bevitelek
Ehhez a parancsmaghoz CIM-példányobjektumot csövezhet.
Kimenetek
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.
Kapcsolódó hivatkozások
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: