Polecenie cmdlet Get-CimInstance pobiera wystąpienia klasy modelu CIM z serwera CIM. Możesz określić nazwę klasy lub zapytanie dla tego polecenia cmdlet. To polecenie cmdlet zwraca jeden lub więcej obiektów wystąpień CIM, które reprezentują migawkę wystąpień CIM znajdujących się na serwerze CIM.
Jeśli nie określono parametru InputObject, polecenie cmdlet działa na jeden z następujących sposobów:
Jeśli nie określono parametru ComputerName ani parametru CimSession, to to polecenie cmdlet działa w lokalnej sesji instrumentacji zarządzania Windows (WMI) przy użyciu sesji modelu obiektów składników (COM).
Jeśli określono parametr ComputerName lub parametr CimSession, to polecenie cmdlet działa na serwerze CIM określonym przez parametr ComputerName lub parametr CimSession.
Jeśli określono parametr InputObject, polecenie cmdlet działa w jeden z następujących sposobów:
Jeśli nie określono parametru ComputerName ani parametru CimSession, to to polecenie cmdlet używa sesji CIM lub nazwy komputera z obiektu wejściowego.
Jeśli określono parametr ComputerName lub parametr CimSession, to to polecenie cmdlet używa wartości parametru CimSession lub wartości parametru ComputerName.
Przykłady
Przykład 1: Pobierz wystąpienia CIM określonej klasy
Get-CimInstance -ClassName Win32_Process
To polecenie pobiera wystąpienia modelu CIM klasy o nazwie Win32_Process.
Przykład 2. Pobieranie listy przestrzeni nazw z serwera WMI
To polecenie pobiera listę przestrzeni nazw w głównej przestrzeni nazw na serwerze WMI.
Przykład 3. Pobieranie wystąpień klasy filtrowanej przy użyciu zapytania
Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'p%'"
To polecenie pobiera wszystkie wystąpienia modelu CIM rozpoczynające się literą p klasy o nazwie Win32_Process przy użyciu zapytania określonego przez parametr Query.
Przykład 4. Pobieranie wystąpień klasy filtrowanej przy użyciu nazwy klasy i wyrażenia filtru
Get-CimInstance -ClassName Win32_Process -Filter "Name like 'p%'"
To polecenie pobiera wszystkie wystąpienia modelu CIM rozpoczynające się literą "p" klasy o nazwie Win32_Process przy użyciu parametru Filter.
Przykład 5: Pobieranie instancji CIM tylko z wypełnionymi właściwościami klucza
Ten zestaw poleceń tworzy nowe wystąpienie modelu CIM w pamięci dla klasy o nazwie Win32_Process z właściwością klucza @{ "Handle"=0 } i przechowuje je w zmiennej o nazwie $x. Zmienna jest przekazywana jako instancja CIM do cmdletu Get-CimInstance w celu pobrania konkretnej instancji.
Przykład 6. Pobieranie wystąpień modelu CIM i ponowne używanie ich
Ten zestaw poleceń pobiera wystąpienia modelu CIM klasy o nazwie Win32_Process i przechowuje je w zmiennych $x i $y. Zmienna $x jest następnie formatowana w tabeli zawierającej tylko program PowerShell i atrybuty programu PowerShell, tabelę ustawioną na AutoSize.
Przykład 7. Pobieranie wystąpień modelu CIM z komputera zdalnego
Ten zestaw poleceń tworzy sesję modelu CIM na komputerach o nazwach Server01 i Server02 przy użyciu polecenia cmdlet New-CimSession i przechowuje informacje o sesji w zmiennej o nazwie $s. Zawartość zmiennej jest następnie przekazywana do Get-CimInstance przy użyciu parametru CimSession, w celu uzyskania wystąpień klasy CIM o nazwie Win32_ComputerSystem.
Parametry
-CimSession
Określa sesję CIM, która ma być używana przez to polecenie cmdlet. Wprowadź zmienną zawierającą sesję modelu CIM lub polecenie, które tworzy lub pobiera sesję modelu CIM, na przykład polecenia cmdlet New-CimSession lub Get-CimSession. Aby uzyskać więcej informacji, zobacz about_CimSession.
Właściwości parametru
Typ:
CimSession[]
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ResourceUriSessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
True
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
QuerySessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
True
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
True
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
CimInstanceSessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
True
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
-ClassName
Określa nazwę klasy CIM, dla której mają być pobierane wystąpienia modelu CIM. Można użyć uzupełniania za pomocą tabulatora, aby przeglądać listę klas, ponieważ PowerShell pobiera spis klas z lokalnego serwera WMI, aby wyświetlić listę ich nazw.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ClassNameComputerSet
Position:
0
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
0
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-ComputerName
Określa komputer, na którym chcesz uruchomić operację CIM. Można określić w pełni kwalifikowaną nazwę domeny (FQDN), nazwę NetBIOS lub adres IP. Jeśli nie określisz tego parametru, polecenie cmdlet wykonuje operację na komputerze lokalnym przy użyciu modelu obiektów składników (COM).
Jeśli określisz ten parametr, polecenie cmdlet utworzy sesję tymczasową na określonym komputerze przy użyciu protokołu WsMan.
Jeśli na tym samym komputerze jest wykonywanych wiele operacji, połącz się przy użyciu sesji CIM, aby uzyskać lepszą wydajność.
Właściwości parametru
Typ:
String[]
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Aliasy:
CN, NazwaSerwera
Zestawy parametrów
ClassNameComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
CimInstanceComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QueryComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Filter
Określa klauzulę where, która ma być używana jako filtr. Określ sekcję w języku zapytań WQL lub CQL.
Uwaga: nie dołączaj słowa kluczowego where w wartości parametru .
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ClassNameComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-InputObject
Określa obiekt wystąpienia modelu CIM, który ma być używany jako dane wejściowe.
Jeśli już pracujesz z obiektem wystąpienia modelu CIM, możesz użyć tego parametru, aby przekazać obiekt wystąpienia modelu CIM, aby uzyskać najnowszą migawkę z serwera CIM. Po przekazaniu obiektu wystąpienia modelu CIM jako danych wejściowych Get-CimInstance zwraca obiekt z serwera przy użyciu operacji get CIM, zamiast operacji wyliczania lub wykonywania zapytania. Użycie operacji Get CIM jest bardziej wydajne niż pobieranie wszystkich wystąpień, a następnie ich filtrowanie.
Jeśli klasa CIM nie implementuje operacji get, określenie parametru InputObject zwraca błąd.
Właściwości parametru
Typ:
CimInstance
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Aliasy:
CimInstance
Zestawy parametrów
CimInstanceSessionSet
Position:
0
Obowiązkowe:
True
Wartość z potoku:
True
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
CimInstanceComputerSet
Position:
0
Obowiązkowe:
True
Wartość z potoku:
True
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
-KeyOnly
Wskazuje, że zwracane są tylko obiekty z uzupełnionymi właściwościami klucza. Określenie parametru KeyOnly zmniejsza ilość danych przesyłanych przez sieć.
Użyj parametru KeyOnly, aby zwrócić tylko niewielką część obiektu, która może być używana do innych operacji, takich jak Set-CimInstance lub Get-CimAssociatedInstance poleceń cmdlet.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ClassNameComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
ResourceUriSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
ResourceUriComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
-Namespace
Określa przestrzeń nazw klasy CIM.
Domyślna przestrzeń nazw to root/cimv2. Za pomocą uzupełniania za pomocą klawisza Tab można przeglądać listę przestrzeni nazw, ponieważ PowerShell pobiera listę przestrzeni nazw z lokalnego serwera WMI w celu udostępnienia listy przestrzeni nazw.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ClassNameComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QuerySessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QueryComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-OperationTimeoutSec
Określa czas, przez który polecenie cmdlet czeka na odpowiedź od komputera. Domyślnie wartość tego parametru to 0, co oznacza, że polecenie cmdlet używa domyślnej wartości limitu czasu dla serwera.
Jeśli parametr OperationTimeoutSec jest ustawiony na wartość mniejszą niż limit czasu ponawiania próby niezawodnego połączenia przez 3 minuty, awarie sieci, które trwają dłużej niż wartość parametru OperationTimeoutSec nie są możliwe do odzyskania, ponieważ operacja na serwerze przekracza limit czasu, zanim klient będzie mógł ponownie nawiązać połączenie.
Właściwości parametru
Typ:
UInt32
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Aliasy:
OT
Zestawy parametrów
(All)
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
-Property
Określa zestaw właściwości obiektu do pobrania. Użyj tego parametru, gdy musisz zmniejszyć rozmiar zwracanego obiektu w pamięci lub za pośrednictwem sieci.
Zwrócony obiekt zawsze ma wypełnione właściwości klucza, niezależnie od zestawu właściwości wymienionych przez parametr Property. Inne właściwości klasy są obecne, ale nie są używane.
Właściwości parametru
Typ:
String[]
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Aliasy:
Wybierz pozycjęWłaściwości
Zestawy parametrów
ClassNameComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Query
Określa zapytanie do uruchomienia na serwerze CIM. Jeśli określona wartość zawiera cudzysłowy podwójne ", apostrofy 'lub ukośnik odwrotny \, należy poprzedzić te znaki znakiem ukośnika odwrotnego. Jeśli określona wartość używa operatora WQL LIKE, należy ująć następujące znaki w nawiasy kwadratowe []: procent %, podkreślenie _lub otwierający nawias kwadratowy [.
Nie można użyć zapytania metadanych do pobrania listy klas lub zapytania zdarzenia.
Aby pobrać listę klas, użyj polecenia cmdlet Get-CimClass.
Aby pobrać zapytanie o zdarzenie, użyj polecenia cmdlet Register-CimIndicationEvent.
Dialekt zapytania można określić przy użyciu parametru QueryDialect.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
QuerySessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QueryComputerSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-QueryDialect
Określa język zapytań używany dla parametru Query. Dopuszczalne wartości tego parametru to: WQL lub CQL. Wartość domyślna to WQL.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ClassNameComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QuerySessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QueryComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-ResourceUri
Określa jednolity identyfikator zasobu (URI) klasy zasobów lub jej wystąpienia. Identyfikator URI służy do identyfikowania określonego typu zasobu, takiego jak dyski lub procesy, na komputerze.
Identyfikator URI składa się z prefiksu i ścieżki do zasobu. Przykład:
Domyślnie, jeśli nie określisz tego parametru, używany jest identyfikator URI zasobu standardowego DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/, a nazwa klasy jest dołączana do niego.
ResourceURI można używać tylko z sesjami modelu CIM utworzonymi przy użyciu protokołu WSMan lub podczas określania parametru ComputerName, który tworzy sesję modelu CIM przy użyciu narzędzia WSMan. Jeśli określisz ten parametr bez określenia parametru ComputerName lub jeśli określisz sesję CIM utworzoną przy użyciu protokołu DCOM, zostanie wyświetlony błąd, ponieważ protokół DCOM nie obsługuje parametru ResourceURI.
Jeśli określono zarówno parametr ResourceUri, jak i parametr Filter, parametr Filter zostanie zignorowany.
Właściwości parametru
Typ:
Uri
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ResourceUriSessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
ResourceUriComputerSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QuerySessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
QueryComputerSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
CimInstanceSessionSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
CimInstanceComputerSet
Position:
Named
Obowiązkowe:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Shallow
Wskazuje, że wystąpienia klasy są zwracane bez uwzględniania wystąpień żadnych klas podrzędnych. Domyślnie polecenie cmdlet zwraca wystąpienia klasy i jej klas podrzędnych.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
ClassNameComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
ResourceUriSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
QuerySessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
ClassNameSessionSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
ResourceUriComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
QueryComputerSet
Position:
Named
Obowiązkowe:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
CIM Instance
To polecenie cmdlet akceptuje obiekty wejściowe określone za pomocą parametru InputObject.
Dane wyjściowe
CIM Instance
Polecenie cmdlet zwraca jedno lub więcej obiektów wystąpień CIM, które reprezentują migawkę wystąpień CIM na serwerze CIM.