Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten Get-CimInstance hämtar CIM-instanserna av en klass från en CIM-server. Du kan ange antingen klassnamnet eller en fråga för den här cmdleten. Den här cmdleten returnerar ett eller flera CIM-instansobjekt som representerar en ögonblicksbild av CIM-instanserna som finns på CIM-servern.
Om parametern InputObject inte anges fungerar cmdleten på något av följande sätt:
Om varken parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten på den lokala Windows Management Instrumentation (WMI) med hjälp av en COM-session (Component Object Model).
Om parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten mot den CIM-server som anges av parametern ComputerName eller parametern CimSession.
Om parametern InputObject anges fungerar cmdleten på något av följande sätt:
Om varken parametern ComputerName eller parametern CimSession anges använder den här cmdleten CIM-sessionen eller datornamnet från indataobjektet.
Om parametern ComputerName eller parametern CimSession anges använder den här cmdleten antingen parametervärdet CimSession eller ComputerName parametervärde.
Exempel
Exempel 1: Hämta CIM-instanserna av en angiven klass
Det här exemplet hämtar CIM-instanserna av en klass med namnet Win32_Process.
Get-CimInstance -ClassName Win32_Process
Exempel 2: Hämta en lista över namnområden från en WMI-server
Det här exemplet hämtar en lista över namnområden under rot- namnrymd på en WMI-server.
Exempel 3: Hämta instanser av en klass som filtrerats med hjälp av en fråga
Det här exemplet hämtar alla CIM-instanser som börjar med bokstaven P- för en klass med namnet Win32_Process med hjälp av frågan som anges av en Query-parameter.
Get-CimInstance -Query "SELECT * from Win32_Process WHERE name LIKE 'P%'"
Exempel 4: Hämta instanser av en klass som filtreras med hjälp av ett klassnamn och ett filteruttryck
Det här exemplet hämtar alla CIM-instanser som börjar med bokstaven P- för en klass med namnet Win32_Process med hjälp av parametern Filter.
Get-CimInstance -ClassName Win32_Process -Filter "Name like 'P%'"
Exempel 5: Hämta CIM-instanserna med endast nyckelegenskaper ifyllda
Det här exemplet skapar en ny CIM-instans i minnet för en klass med namnet Win32_Process med nyckelegenskapen @{ "Handle"=0 } och lagrar den i en variabel med namnet $x. Variabeln skickas som en CIM-instans till cmdleten Get-CimInstance för att hämta en viss instans.
Det här exemplet hämtar CIM-instanserna av en klass med namnet Win32_Process och lagrar dem i variablerna $x och $y. Variabeln $x formateras sedan i en tabell som endast innehåller egenskaperna Name och KernelModeTime. Tabellen är inställd på AutoSize.
Den instans som hämtas med parametern Property kan användas för att utföra andra CIM-åtgärder, till exempel Set-CimInstance eller Invoke-CimMethod.
Exempel 10: Hämta CIM-instansen med CIM-sessionen
Det här exemplet skapar en CIM-session på datorerna med namnet Server01 och Server02 med hjälp av cmdleten New-CimSession och lagrar sessionsinformationen i en variabel med namnet $s. Innehållet i variabeln skickas sedan till Get-CimInstance med hjälp av parametern CimSession för att hämta CIM-instanserna av klassen med namnet Win32_ComputerSystem.
Anger den CIM-session som ska användas för den här cmdleten. Ange en variabel som innehåller CIM-sessionen eller ett kommando som skapar eller hämtar CIM-sessionen, till exempel cmdletarna New-CimSession eller Get-CimSession. Mer information finns i about_CimSession.
Anger namnet på den CIM-klass som CIM-instanserna ska hämtas för. Du kan använda tabbavslut för att bläddra i listan över klasser, eftersom PowerShell hämtar en lista över klasser från den lokala WMI-servern för att tillhandahålla en lista med klassnamn.
Anger den dator där du vill köra CIM-åtgärden. Du kan ange ett fullständigt domännamn (FQDN), ett NetBIOS-namn eller en IP-adress. Om du inte anger den här parametern utför cmdleten åtgärden på den lokala datorn med hjälp av Komponentobjektmodell (COM).
Om du anger den här parametern skapar cmdleten en tillfällig session till den angivna datorn med hjälp av WsMan-protokollet.
Om flera åtgärder utförs på samma dator ansluter du med en CIM-session för bättre prestanda.
Anger en where-sats som ska användas som ett filter. Ange satsen i antingen WQL- eller CQL- frågespråk. Ta inte med nyckelordet WHERE i värdet för parametern.
Anger ett CIM-instansobjekt som ska användas som indata.
Om du redan arbetar med ett CIM-instansobjekt kan du använda den här parametern för att skicka CIM-instansobjektet för att hämta den senaste ögonblicksbilden från CIM-servern. När du skickar ett CIM-instansobjekt som indata returnerar Get-CimInstance objektet från servern med hjälp av en get CIM-åtgärd i stället för en uppräknings- eller frågeåtgärd. Det är effektivare att använda en get CIM-åtgärd än att hämta alla instanser och sedan filtrera dem.
Parametern InputObject räknas inte upp över samlingar. Om en samling skickas utlöses ett fel. När du arbetar med samlingar kan du skicka indata för att räkna upp värdena.
Om CIM-klassen inte implementerar get-åtgärden returneras ett fel när du anger parametern InputObject.
Anger att endast objekt med nyckelegenskaper ifyllda returneras. Om du anger parametern KeyOnly minskar mängden data som överförs via nätverket.
Använd parametern KeyOnly för att returnera endast en liten del av objektet, som kan användas för andra åtgärder, till exempel Set-CimInstance eller Get-CimAssociatedInstance cmdletar.
Standardnamnområdet är root/CIMV2. Du kan använda tabbavslut för att bläddra i listan över namnområden, eftersom PowerShell hämtar en lista över namnområden från den lokala WMI-servern för att tillhandahålla listan över namnområden.
Anger hur lång tid cmdleten väntar på ett svar från datorn. Som standard är värdet för den här parametern 0, vilket innebär att cmdleten använder standardvärdet för timeout för servern.
Om parametern OperationTimeoutSec anges till ett värde som är mindre än den robusta tidsgränsen för återförsök på 3 minuter kan nätverksfel som varar mer än värdet för parametern OperationTimeoutSec inte återställas eftersom åtgärden på servern överskrider tidsgränsen innan klienten kan återansluta.
Anger en uppsättning instansegenskaper som ska hämtas. Använd den här parametern när du behöver minska storleken på objektet som returneras, antingen i minnet eller i nätverket. Objektet som returneras innehåller även nyckelegenskaperna även om du inte har listat dem med parametern Egenskap. Andra egenskaper för klassen finns men de är inte ifyllda.
Anger en fråga som ska köras på CIM-servern. Om det angivna värdet innehåller dubbla citattecken ", enkla citattecken 'eller ett omvänt snedstreck \måste du undvika dessa tecken genom att prefixa dem med omvänt snedstreck. Om det angivna värdet använder operatorn WQL LIKE måste du undvika följande tecken genom att omsluta dem inom hakparenteser []: procent %, understreck _eller inledande hakparentes [.
Du kan inte använda en metadatafråga för att hämta en lista över klasser eller en händelsefråga. Om du vill hämta en lista över klasser använder du cmdleten Get-CimClass. Om du vill hämta en händelsefråga använder du cmdleten Register-CimIndicationEvent.
Du kan ange frågedialekten med parametern QueryDialect.
Anger resursens enhetliga resursidentifierare (URI) för resursklassen eller instansen. URI:n används för att identifiera en specifik typ av resurs, till exempel diskar eller processer, på en dator.
En URI består av ett prefix och en sökväg till en resurs. Till exempel:
Om du inte anger den här parametern används som standard URI för DMTF-standardresursen http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ och klassnamnet läggs till i den.
ResourceUri- kan bara användas med CIM-sessioner som skapats med hjälp av WSMan-protokollet, eller när du anger parametern ComputerName, som skapar en CIM-session med WSMan. Om du anger den här parametern utan att ange parametern ComputerName, eller om du anger en CIM-session som skapats med DCOM-protokollet, får du ett fel eftersom DCOM-protokollet inte stöder parametern ResourceUri.
Om både parametern ResourceUri och parametern Filter anges ignoreras parametern Filter.
Anger att instanserna av en klass returneras utan att inkludera instanserna av några underordnade klasser. Som standard returnerar cmdleten instanserna av en klass och dess underordnade klasser.
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Källan för det här innehållet finns på GitHub, där du även kan skapa och granska ärenden och pull-begäranden. Se vår deltagarguide för mer information.
