Share via

Get-CimClass

  • Referencia
Modul:
CimCmdlets

Lekéri a CIM-osztályok listáját egy adott névtérben.

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

Ez a parancsmag csak a Windows platformon érhető el.

A Get-CimClass parancsmag lekéri a CIM-osztályok listáját egy adott névtérben. Ha nincs megadva osztálynév, akkor a parancsmag a névtér összes osztályát visszaadja. A CIM-példányoktól eltérően a CIM-osztályok nem tartalmazzák azt a CIM-munkamenetet vagy számítógépnevet, amelyből lekérik őket.

Példák

1. példa: Az összes osztálydefiníció lekérése

Ez a példa lekéri az összes osztálydefiníciót a névtér gyökér/cimv2 területén.

Get-CimClass

2. példa: Adott névvel rendelkező osztályok lekérése

Ez a példa lekéri azokat az osztályokat, amelyek a lemez szót tartalmazzák a nevükben.

Get-CimClass -ClassName *disk*

3. példa: Az osztályok lekérése egy adott metódusnévvel

Ez a példa a Win32 névvel kezdődő és a Kifejezéssel kezdődő metódusnévvel kezdődő osztályokat kapja.

Get-CimClass -ClassName Win32* -MethodName Term*

4. példa: Adott tulajdonságnévvel rendelkező osztályok lekérése

Ez a példa lekéri a Win32 névvel kezdődő és a Handle nevű tulajdonsággal rendelkező osztályokat.

Get-CimClass -ClassName Win32* -PropertyName Handle

5. példa: Az osztályok lekérése egy adott minősítőnévvel

Ez a példa lekéri a Win32 névvel kezdődő osztályokat, a nevükben a Lemez szót tartalmazza, és rendelkezik a megadott minősítő társítással.

Get-CimClass -ClassName Win32*Disk* -QualifierName Association

6. példa: Az osztálydefiníciók lekérése egy adott névtérből

Ez a példa lekéri a net szót tartalmazó osztálydefiníciókat a megadott névtérgyökerből/standardCimv2-ből.

Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*

7. példa: Az osztálydefiníciók lekérése távoli kiszolgálóról

Ez a példa lekéri azokat az osztálydefiníciókat, amelyek a lemez szót tartalmazzák a nevükben a megadott távoli kiszolgálóról, a Server01-ről és a Server02-ről.

Get-CimClass -ClassName *disk* -ComputerName Server01, Server02

8. példa: Az osztályok lekérése CIM-munkamenet használatával

$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *disk* -CimSession $s

Ez a parancskészlet létrehoz egy munkamenetet több számítógéppel, és a parancsmag használatával New-CimSession egy változóba $s tárolja, majd lekéri az osztályokat a Get-CimClass parancsmag használatával.

Paraméterek

-Amended

Azt jelzi, hogy a CIM-lekérdezésből visszaadott objektumoknak módosított információkat kell tartalmazniuk. A módosított információk általában honosítható információk, például a CIM-objektumhoz csatolt objektum- és tulajdonságleírások. Ez akkor hasznos, ha numerikus értékeket ember által olvasható értékekre fordít.

Ez a paraméter a PowerShell 7.3-ban lett hozzáadva.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

A parancsmagot távoli munkamenetben vagy távoli számítógépen futtatja. Adjon meg egy számítógépnevet vagy egy munkamenet-objektumot, például egy vagy Get-CimSession egy New-CimSession parancsmag kimenetét. Az alapértelmezett az aktuális munkamenet a helyi számítógépen.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ClassName

Annak a CIM-osztálynak a nevét adja meg, amelynek a műveletet végre kell hajtania. A tabulátorkiegészítéssel tallózhat az osztályok listájában, mivel a PowerShell lekéri a helyi WMI-kiszolgálóról az osztályok listáját az osztálynevek listájának megadásához.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-ComputerName

Azt a számítógépet adja meg, amelyen futtatni szeretné a CIM-műveletet. Megadhat egy teljes tartománynevet (FQDN) netBIOS-nevet vagy IP-címet.

Ha megadja ezt a paramétert, a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WsMan protokoll használatával.

Ha nem adja meg ezt a paramétert, a parancsmag a helyi számítógépen hajtja végre a műveletet a Component Object Model (COM) használatával.

Ha több műveletet végez ugyanazon a számítógépen, a CIM-munkamenet jobb teljesítményt nyújt.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MethodName

Megkeresi azokat az osztályokat, amelyek metódusa megfelel ennek a névnek. Ezzel a paraméterrel helyettesítő karaktereket is használhat.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Namespace

Megadja a CIM-művelet névterét. Az alapértelmezett névtér a root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek listájában, mivel a PowerShell lekéri a névterek listáját a helyi WMI-kiszolgálóról a névterek listájának megadásához.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Megadja, hogy a parancsmag mennyi időt vár a számítógép válaszára. Alapértelmezés szerint ennek a paraméternek az értéke 0, ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.

Ha az OperationTimeoutSec paraméter értéke kisebb, mint a robusztus kapcsolat újrapróbálkozási időtúllépése 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PropertyName

Megkeresi azokat az osztályokat, amelyek tulajdonsága megfelel ennek a névnek. Ezzel a paraméterrel helyettesítő karaktereket is használhat.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-QualifierName

Az osztályokat osztályszintű minősítő neve alapján szűri. Ezzel a paraméterrel helyettesítő karaktereket is használhat.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

CimClass

Ez a parancsmag egy CIM-osztályobjektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat Get-CimClasstartalmazza:

  • Windows:
    • gcls

Ez a parancsmag csak Windows-platformokon érhető el.