Get-CimClass
Hämtar en lista över CIM-klasser i ett specifikt namnområde.
Syntax
ComputerSet (Standard)
Get-CimClass
[[-ClassName] <string>]
[[-Namespace] <string>]
[-Amended]
[-OperationTimeoutSec <uint>]
[-ComputerName <string[]>]
[-MethodName <string>]
[-PropertyName <string>]
[-QualifierName <string>]
[<CommonParameters>]
SessionSet
Get-CimClass
[[-ClassName] <string>]
[[-Namespace] <string>]
-CimSession <CimSession[]>
[-Amended]
[-OperationTimeoutSec <uint>]
[-MethodName <string>]
[-PropertyName <string>]
[-QualifierName <string>]
[<CommonParameters>]
Description
Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten Get-CimClass hämtar en lista över CIM-klasser i ett specifikt namnområde. Om inget klassnamn anges returnerar cmdleten alla klasser i namnområdet. Till skillnad från en CIM-instans innehåller CIM-klasserna inte CIM-sessionen eller datornamnet som de hämtas från.
Exempel
Exempel 1: Hämta alla klassdefinitioner
I det här exemplet hämtas alla klassdefinitioner under namnområdet root/CIMV2.
Get-CimClass
Exempel 2: Hämta klasserna med ett specifikt namn
Det här exemplet hämtar de klasser som innehåller ordet Disk i deras namn.
Get-CimClass -ClassName *Disk*
Exempel 3: Hämta klasserna med ett specifikt metodnamn
Det här exemplet hämtar de klasser som börjar med namnet Win32 och har ett metodnamn som börjar med Term.
Get-CimClass -ClassName Win32* -MethodName Term*
Exempel 4: Hämta klasserna med ett specifikt egenskapsnamn
Det här exemplet hämtar de klasser som börjar med namnet Win32 och har en egenskap med namnet Handle.
Get-CimClass -ClassName Win32* -PropertyName Handle
Exempel 5: Hämta klasserna med ett specifikt kvalificerarnamn
Det här exemplet hämtar de klasser som börjar med namnet Win32, innehåller ordet Disk i sina namn och har den angivna kvalificeraren Association.
Get-CimClass -ClassName Win32*Disk* -QualifierName Association
Exempel 6: Hämta klassdefinitionerna från ett specifikt namnområde
Det här exemplet hämtar de klassdefinitioner som innehåller ordet Net i deras namn från det angivna namnområdet root/StandardCimv2.
Get-CimClass -Namespace root/StandardCimv2 -ClassName *Net*
Exempel 7: Hämta klassdefinitionerna från en fjärrserver
Det här exemplet hämtar de klassdefinitioner som innehåller ordet Disk i deras namn från de angivna fjärrservrarna Server01 och Server02.
Get-CimClass -ClassName *Disk* -ComputerName Server01, Server02
Exempel 8: Hämta klasserna med hjälp av en CIM-session
$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *Disk* -CimSession $s
Den här uppsättningen kommandon skapar en session med flera datorer och lagrar den i en variabel $s med hjälp av cmdleten New-CimSession och hämtar sedan klasserna med hjälp av cmdleten Get-CimClass.
Parametrar
-Amended
Anger att objekt som returneras från CIM-frågan ska innehålla ändrad information. Vanligtvis är ändrad information lokal information, till exempel objekt- och egenskapsbeskrivningar som är kopplade till CIM-objektet. Detta är användbart för att översätta numeriska värden till värden som kan läsas av människor.
Den här parametern lades till i PowerShell 7.3.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-CimSession
Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från en New-CimSession eller Get-CimSession cmdlet. Standardvärdet är den aktuella sessionen på den lokala datorn.
Parameteregenskaper
| Typ: | |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
SessionSet
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ClassName
Anger namnet på den CIM-klass som åtgärden ska utföras 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ComputerName
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 anger den här parametern skapar cmdleten en tillfällig session till den angivna datorn med hjälp av WsMan-protokollet.
Om du inte anger den här parametern utför cmdleten åtgärden på den lokala datorn med hjälp av Komponentobjektmodell (COM).
Om flera åtgärder utförs på samma dator ger CIM-sessionen bättre prestanda.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | CN, Servernamn |
Parameteruppsättningar
ComputerSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-MethodName
Söker efter de klasser som har en metod som matchar det här namnet. Du kan använda jokertecken med den här parametern.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Namespace
Anger namnområdet för CIM-åtgärden. 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-OperationTimeoutSec
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.
Parameteregenskaper
| Typ: | UInt32 |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | OT |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-PropertyName
Söker efter de klasser som har en egenskap som matchar det här namnet. Du kan använda jokertecken med den här parametern.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-QualifierName
Filtrerar klasserna efter kvalificerarnamn på klassnivå. Du kan använda jokertecken med den här parametern.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
CommonParameters
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.
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
CimClass
Den här cmdleten returnerar ett CIM-klassobjekt.
Kommentarer
PowerShell innehåller följande alias för Get-CimClass:
- Windows:
gcls
Den här cmdleten är endast tillgänglig på Windows-plattformar.
