Get-CimClass

  • Referens
Modul:
CimCmdlets

Hämtar en lista över CIM-klasser i ett specifikt namnområde.

Syntax

Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-ComputerName <string[]>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]
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ådesroten /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 deras namn och har den angivna kvalificerarassociationen.

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 den angivna namnområdesroten /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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 eller Get-CimSession cmdletNew-CimSession. Standardvärdet är den aktuella sessionen på den lokala datorn.

Typ:CimSession[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-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.

Typ:String[]
Alias:CN, ServerName
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-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.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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 är inställd på ett värde som är mindre än den robusta tidsgränsen för återförsök av anslutningen 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.

Typ:UInt32
Alias:OT
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-QualifierName

Filtrerar klasserna efter kvalificerarnamn på klassnivå. Du kan använda jokertecken med den här parametern.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

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.