Get-CimClass
Lekéri a CIM-osztályok listáját egy adott névtérben.
Syntax
ComputerSet (Alapértelmezett)
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
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érben root/cimv2.
Get-CimClass
2. példa: Adott névvel rendelkező osztályok lekérése
Ez a példa beolvasja azokat az osztályokat, amelyek a nevükben szót tartalmazzák.
Get-CimClass -ClassName *disk*
3. példa: Az osztályok lekérése egy adott metódusnévvel
Ez a példa a Win32 nevű kezdődő osztályokat veszi fel, és a metódus neve Kifejezéskezdődik.
Get-CimClass -ClassName Win32* -MethodName Term*
4. példa: Adott tulajdonságnévvel rendelkező osztályok lekérése
Ez a példa a Win32 nevű kezdődő osztályokat, és egy Handlenevű tulajdonsággal rendelkezik.
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 a Win32 nevűkezdődő osztályokat tartalmazza, a nevükben a Lemez szót tartalmazza, és a megadott minősítő Társítás.
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érből root/standardCimv2.
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 a lemez szót tartalmazó osztálydefiníciókat a megadott távoli kiszolgálókról Server01 és Server02.
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 egy változó $s tárolja a New-CimSession parancsmag használatával, majd lekéri az osztályokat a Get-CimClass parancsmaggal.
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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 New-CimSession vagy Get-CimSession parancsmag kimenetét. Az alapértelmezett az aktuális munkamenet a helyi számítógépen.
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ClassName
Annak a CIM-osztálynak a nevét adja meg, amelynek a műveletet végre kell hajtania. Használhatja a tabulátorkiegészítést az osztályok listájának böngészéséhez, mivel a PowerShell a helyi WMI-kiszolgálóról kér le egy osztálylistát az osztálynevek megjelenítéséhez.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Kína, Kiszolgálónév |
Paraméterkészletek
ComputerSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Namespace
Megadja a CIM-művelet névterét. Az alapértelmezett névtér root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek között, mert a PowerShell a helyi WMI-kiszolgálóról kér le egy névtérlistát, hogy biztosítsa a névterek listáját.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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 a OperationTimeoutSec paraméter értéke kisebb, mint a 3 perces robusztus kapcsolat-újrapróbálkozási időtúllépés, a 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őt, mielőtt az ügyfél újracsatlakozhat.
Paramétertulajdonságok
| Típus: | UInt32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | OT |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-QualifierName
Az osztályokat osztályszintű minősítő neve alapján szűri. Ezzel a paraméterrel helyettesítő karaktereket is használhat.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
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 tartalmazza Get-CimClass:
- Windows:
gcls
Ez a parancsmag csak Windows-platformokon érhető el.