Rutina Get-CimInstance získá instance CIM třídy ze serveru CIM. Můžete zadat buď název třídy, nebo dotaz pro tuto rutinu. Tato rutina vrátí jeden nebo více objektů instance CIM představující snímek instancí CIM, které jsou přítomné na serveru CIM.
Pokud není zadaný parametr InputObject, rutina funguje jedním z následujících způsobů:
Pokud není zadán parametr ComputerName ani parametr CimSession, bude tato rutina fungovat v místní relaci rozhraní WMI (Windows Management Instrumentation) pomocí relace modelu COM (Component Object Model).
Pokud je zadán parametr ComputerName nebo parametr CimSession, bude tato rutina fungovat se serverem CIM zadaným parametrem ComputerName nebo parametrem CimSession.
Pokud je zadaný parametr InputObject, rutina funguje jedním z následujících způsobů:
Pokud není zadán parametr ComputerName ani parametr CimSession, použije tato rutina název relace CIM nebo názvu počítače ze vstupního objektu.
Pokud je zadán parametr ComputerName nebo parametr CimSession, použije tato rutina hodnotu parametru CimSession nebo hodnotu parametru ComputerName.
Příklady
Příklad 1: Získání instancí CIM zadané třídy
Get-CimInstance -ClassName Win32_Process
Tento příkaz načte instance CIM třídy s názvem Win32_Process.
Příklad 2: Získání seznamu oborů názvů ze serveru WMI
Tato sada příkazů vytvoří novou instanci CIM v paměti pro třídu s názvem Win32_Process s klíčovou vlastností @{ "Handle"=0 } a uloží ji do proměnné s názvem $x. Proměnná se předá jako instance CIM rutině Get-CimInstance, aby získala určitou instanci.
Příklad 6: Načtení instancí CIM a jejich opakované použití
Tato sada příkazů získá instance CIM třídy pojmenované Win32_Process a uloží je do proměnných $x a $y. Proměnná $x se pak naformátuje v tabulce, která obsahuje pouze powershell a atributy PowerShellu. Tabulka je nastavená na Automatické nastavení.
Příklad 7: Získání instancí CIM ze vzdáleného počítače
Tato sada příkazů vytvoří relaci CIM na počítačích s názvem Server01 a Server02 pomocí rutiny New-CimSession a uloží informace o relaci do proměnné s názvem $s. Obsah proměnné se pak předá Get-CimInstance pomocí parametru CimSession k získání instancí CIM třídy s názvem Win32_ComputerSystem.
Parametry
-CimSession
Určuje relaci CIM, která se má pro tuto rutinu použít. Zadejte proměnnou obsahující relaci CIM nebo příkaz, který vytvoří nebo získá relaci CIM, například New-CimSession nebo rutiny Get-CimSession. Další informace naleznete v tématu about_CimSession.
Vlastnosti parametru
Typ:
CimSession[]
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ResourceUriSessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
QuerySessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
CimInstanceSessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-ClassName
Určuje název třídy CIM, pro kterou se mají načíst instance CIM. Pomocí dokončování tabulátoru můžete procházet seznam tříd, protože PowerShell získá seznam tříd z místního serveru WMI a poskytne seznam názvů tříd.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ClassNameComputerSet
Position:
0
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
0
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-ComputerName
Určuje počítač, na kterém chcete spustit operaci CIM. Můžete zadat plně kvalifikovaný název domény (FQDN), název NetBIOS nebo IP adresu. Pokud tento parametr nezadáte, rutina provede operaci na místním počítači pomocí modelu COM (Component Object Model).
Pokud zadáte tento parametr, rutina vytvoří dočasnou relaci k zadanému počítači pomocí protokolu WsMan.
Pokud se na stejném počítači provádí více operací, připojte se pomocí relace CIM pro zajištění lepšího výkonu.
Vlastnosti parametru
Typ:
String[]
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
Čína, Název serveru
Sady parametrů
ClassNameComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
CimInstanceComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QueryComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-Filter
Určuje klauzuli where, která se má použít jako filtr. Zadejte klauzuli v jazyka WQL nebo jazyku CQL.
Poznámka: Nezahrnujte do hodnoty parametru klíčové slovo where.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ClassNameComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-InputObject
Určuje objekt instance CIM, který se má použít jako vstup.
Pokud už pracujete s objektem instance CIM, můžete pomocí tohoto parametru předat objekt instance CIM, abyste získali nejnovější snímek ze serveru CIM. Když předáte objekt instance CIM jako vstup, Get-CimInstance vrátí objekt ze serveru pomocí operace get CIM místo výčtu nebo operace dotazu. Použití operace get CIM je efektivnější než načtení všech instancí a jejich následné filtrování.
Pokud třída CIM neimplementuje operaci get, zadání InputObject parametr vrátí chybu.
Vlastnosti parametru
Typ:
CimInstance
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
CimInstance
Sady parametrů
CimInstanceSessionSet
Position:
0
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
CimInstanceComputerSet
Position:
0
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-KeyOnly
Označuje, že se vrátí pouze objekty s vyplněnými vlastnostmi klíče. Zadáním parametru KeyOnly snížíte množství dat přenášených přes síť.
Pomocí parametru KeyOnly vrátíte pouze malou část objektu, kterou lze použít pro jiné operace, jako jsou Set-CimInstance nebo rutiny Get-CimAssociatedInstance.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ClassNameComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
ResourceUriSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
ResourceUriComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Namespace
Určuje obor názvů třídy CIM.
Výchozí obor názvů je root/cimv2. Pomocí dokončování tabulátoru můžete procházet seznam oborů názvů, protože PowerShell získá seznam oborů názvů z místního serveru WMI a poskytne seznam oborů názvů.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ClassNameComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QuerySessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QueryComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-OperationTimeoutSec
Určuje dobu, po kterou cmdlet čeká na odpověď z počítače. Ve výchozím nastavení je hodnota tohoto parametru 0, což znamená, že rutina používá výchozí hodnotu časového limitu pro server.
Pokud je parametr OperationTimeoutSec nastaven na hodnotu menší než robustní časový limit opakování připojení 3 minuty, selhání sítě, která trvala více než hodnota parametru OperationTimeoutSec, není možné obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.
Vlastnosti parametru
Typ:
UInt32
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
OT
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Property
Určuje sadu vlastností instance, které se mají načíst. Tento parametr použijte, pokud potřebujete zmenšit velikost vráceného objektu v paměti nebo přes síť.
Vrácený objekt má vždy vyplněné klíčové vlastnosti bez ohledu na sadu vlastností uvedených parametrem Property. Jsou přítomny jiné vlastnosti třídy, ale nejsou vyplněny.
Vlastnosti parametru
Typ:
String[]
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
SelectProperties
Sady parametrů
ClassNameComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-Query
Určuje dotaz, který se má spustit na serveru CIM. Pokud zadaná hodnota obsahuje dvojité uvozovky ", jednoduché uvozovky ', nebo zpětné lomítko \, je nutné tyto znaky escapovat použitím znakem zpětného lomítka. Pokud zadaná hodnota používá operátor WQL LIKE, musíte uvozit následující znaky tak, že je uzavřete do hranatých závorek []: percent %, podtržítka _nebo levá hranatá hranatá závorka [.
Dotaz metadat nelze použít k načtení seznamu tříd nebo dotazu na událost.
K načtení seznamu tříd použijte rutinu Get-CimClass.
K načtení dotazu na události použijte rutinu Register-CimIndicationEvent.
Dialekt dotazu můžete zadat pomocí parametru QueryDialect.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
QuerySessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QueryComputerSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-QueryDialect
Určuje dotazovací jazyk použitý pro parametr Dotazu. Přijatelné hodnoty pro tento parametr jsou: WQL nebo CQL. Výchozí hodnota je WQL .
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ClassNameComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QuerySessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QueryComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-ResourceUri
Určuje identifikátor URI (Uniform Resource Identifier) prostředku třídy prostředků nebo instance. Identifikátor URI slouží k identifikaci konkrétního typu prostředku, jako jsou disky nebo procesy, v počítači.
Identifikátor URI se skládá z předpony a cesty k prostředku. Například:
Pokud tento parametr nezadáte, použije se standardní identifikátor URI prostředku DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ a název třídy se k němu připojí.
ResourceURI lze použít pouze s relacemi CIM vytvořenými pomocí protokolu WSMan nebo při zadávání parametru ComputerName, který vytvoří relaci CIM pomocí WSManu. Pokud tento parametr zadáte bez zadání parametru ComputerName nebo pokud zadáte relaci CIM vytvořenou pomocí protokolu DCOM, zobrazí se chyba, protože protokol DCOM nepodporuje parametr ResourceURI.
Pokud je zadán parametr ResourceUri i parametr Filter, bude parametr filtru ignorován.
Vlastnosti parametru
Typ:
Uri
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ResourceUriSessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
ResourceUriComputerSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QuerySessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
QueryComputerSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
CimInstanceSessionSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
CimInstanceComputerSet
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
False
-Shallow
Označuje, že instance třídy jsou vráceny bez zahrnutí instancí všech podřízených tříd. Rutina ve výchozím nastavení vrací instance třídy a její podřízené třídy.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
ClassNameComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
ResourceUriSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
QuerySessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
ClassNameSessionSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
ResourceUriComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
QueryComputerSet
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
CIM Instance
Tato rutina přijímá vstupní objekty zadané pomocí parametru InputObject.
Výstupy
CIM Instance
Tato rutina vrátí jeden nebo více objektů instance CIM představující snímek instancí CIM na serveru CIM.