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 a InputObject paraméter nincs megadva, 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 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 paraméter vagy a CimSession paraméter által megadott CIM-kiszolgálóval működik.
Ha a InputObject paraméter van 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 bemeneti objektum CIM-munkamenetét vagy számítógépnevét használja.
Ha a ComputerName paraméter vagy a CimSession paraméter van megadva, akkor ez a parancsmag a CimSession paraméter értékét vagy ComputerName paraméterértéket használja.
Példák
1. példa: Adott osztály CIM-példányainak lekérése
Ez a példa egy Win32_Processnevű osztály CIM-példányait kéri le.
3. példa: Egy osztály példányainak lekérdezéssel szűrt lekérése
Ez a példa egy Win32_Process nevű osztály P betűjével kezdődő összes CIM-példányt lekéri egy 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 a Win32_Process nevű osztály számára, a kulcstulajdonság @{ "Handle"=0 } segítségével, és egy $xnevű változóban tárolja. A rendszer CIM-példányként továbbítja a változót a Get-CimInstance parancsmagnak egy adott példány lekéréséhez.
6. példa: CIM-példányok lekérése és újbóli felhasználása
Ez a példa lekéri a Win32_Process nevű osztály CIM-példányait, és a $x és $yváltozókban tárolja őket. A $x változó ezután egy olyan táblában lesz formázva, amely csak a Name és KernelModeTime tulajdonságokat tartalmazza, a tábla Automatikus méretezés.
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 vagy Invoke-CimMethod.
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 Server02 nevű számítógépeken a New-CimSession parancsmag használatával, és a munkamenet adatait egy $snevű változóban tárolja. A változó tartalmát a rendszer a Get-CimInstance paraméterrel továbbítja a , hogy lekérje a Win32_ComputerSystemnevű osztály CIM-példányait.
Megadja a parancsmaghoz használandó CIM-munkamenetet. Adjon meg egy változót, amely tartalmazza a CIM-munkamenetet, vagy egy olyan parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például a New-CimSession vagy Get-CimSession parancsmagokat. További információért lásd: about_CimSession.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
QuerySessionSet
Position:
Named
Kötelező:
True
Folyamatból származó érték:
True
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
Named
Kötelező:
True
Folyamatból származó érték:
True
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
CimInstanceSessionSet
Position:
Named
Kötelező:
True
Folyamatból származó érték:
True
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-ClassName
Azon CIM-osztály nevét adja meg, amelyhez a CIM-példányokat le kell kérni. Használhatja a tabulátorkiegészítést az osztályok listájának böngészéséhez, mivel a PowerShell a helyi WMI-kiszolgálóról kér le egy osztálylistát az osztálynevek megjelenítéséhez.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
0
Kötelező:
True
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
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.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
CimInstanceComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QueryComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
-Filter
Meghatároz egy WHERE záradékot, amelyet szűrőként használhat. Adja meg a záradékot a WQL vagy a CQL lekérdezési nyelvben. Ne adja meg a WHERE kulcsszót a paraméter értékében.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
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ányobjektumot, 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 objektumot egy beolvasási CIM-művelettel adja vissza a kiszolgálóról enumerálási vagy lekérdezési művelet helyett. 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ényekkel való munka során irányítsa át a bemenetet az értékek felsorolásához.
Ha a CIM-osztály nem implementálja a lekérési műveletet, akkor a InputObject paraméter megadása hibát ad vissza.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
CimInstanceComputerSet
Position:
0
Kötelező:
True
Folyamatból származó érték:
True
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
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 csak az objektum egy kis részét adja vissza, amely más műveletekhez, például a Set-CimInstance vagy Get-CimAssociatedInstance parancsmagokhoz használható.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
ResourceUriSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
ResourceUriComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Namespace
A CIM-osztály névterét adja meg.
Az alapértelmezett névtér root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek között, mert a PowerShell a helyi WMI-kiszolgálóról kér le egy névtérlistát, hogy biztosítsa a névterek listáját.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QuerySessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QueryComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
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 a OperationTimeoutSec paraméter értéke kisebb, mint a 3 perces robusztus kapcsolat-újrapróbálkozási időtúllépés, a 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őt, mielőtt az ügyfél újracsatlakozhat.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
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 nem listázta őket a Tulajdonság paraméterrel. Az osztály többi tulajdonsága is jelen van, de nincsenek feltöltve.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
-Query
A CIM-kiszolgálón futtatandó lekérdezést adja meg. Ha a megadott érték dupla idézőjeleket ", egyszeres idézőjeleket 'vagy fordított perjelet \tartalmaz, ezeket a karaktereket a fordított perjel karakterrel kell előtaggal feloldani. Ha a megadott érték a WQL LIKE operátort használja, akkor a következő karaktereket kell szögletes zárójelek közé ([]): százalékjel (%), aláhúzásjel (_), vagy nyitó szögletes zárójel ([) tenni.
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.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QueryComputerSet
Position:
Named
Kötelező:
True
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
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 WQL.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QuerySessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QueryComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
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éldául:
Alapértelmezés szerint, ha nem adja meg ezt a paramétert, a rendszer a DMTF standard erőforrás URI-http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ használja, és hozzáfűzi az osztály nevét.
ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel, vagy a ComputerName paraméter megadásakor használható, 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 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.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
ResourceUriComputerSet
Position:
Named
Kötelező:
True
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QuerySessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
QueryComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
CimInstanceSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
CimInstanceComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
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 cmdlet egy osztály és annak gyermekosztályai objektum példányait adja vissza.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
ResourceUriSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
QuerySessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
ClassNameSessionSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
ResourceUriComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
QueryComputerSet
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.