Sdílet prostřednictvím

Get-CimClass

  • Reference
Modul:
CimCmdlets

Získá seznam tříd CIM v určitém oboru názvů.

Syntaxe

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

Tato rutina je dostupná jenom na platformě Windows.

Rutina Get-CimClass načte seznam tříd CIM v určitém oboru názvů. Pokud není zadaný žádný název třídy, vrátí rutina všechny třídy v oboru názvů. Na rozdíl od instance CIM třídy CIM neobsahují relaci CIM ani název počítače, ze kterého jsou načteny.

Příklady

Příklad 1: Získání všech definic tříd

Tento příklad získá všechny definice třídy pod kořenem oboru názvů /cimv2.

Get-CimClass

Příklad 2: Získání tříd s konkrétním názvem

Tento příklad získá třídy, které obsahují slovo disk v jejich názvech.

Get-CimClass -ClassName *disk*

Příklad 3: Získání tříd s konkrétním názvem metody

Tento příklad získá třídy, které začínají názvem Win32 a mají název metody, který začíná termínem.

Get-CimClass -ClassName Win32* -MethodName Term*

Příklad 4: Získání tříd s konkrétním názvem vlastnosti

Tento příklad získá třídy, které začínají názvem Win32 a mají vlastnost s názvem Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Příklad 5: Získání tříd s konkrétním názvem kvalifikátoru

Tento příklad získá třídy, které začínají názvem Win32, obsahují slovo Disk v jejich názvech a mají zadané kvalifikátor Association.

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

Příklad 6: Získání definic tříd z konkrétního oboru názvů

Tento příklad získá definice třídy, které obsahují slovo Net v jejich názvech ze zadaného kořenu oboru názvů nebo standardCimv2.

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

Příklad 7: Získání definic tříd ze vzdáleného serveru

Tento příklad získá definice třídy, které obsahují slovo disk v jejich názvech ze zadaných vzdálených serverů Server01 a Server02.

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

Příklad 8: Získání tříd pomocí relace CIM

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

Tato sada příkazů vytvoří relaci s více počítači a uloží ji do proměnné $s pomocí New-CimSession rutiny a pak získá třídy pomocí rutiny Get-CimClass .

Parametry

-Amended

Označuje, že objekty vrácené z dotazu CIM by měly obsahovat změněné informace. Změněné informace jsou obvykle lokalizovatelné informace, jako jsou popisy objektů a vlastností, které jsou připojeny k objektu CIM. To je užitečné při překladu číselných hodnot na hodnoty čitelné člověkem.

Tento parametr byl přidán v PowerShellu 7.3.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CimSession

Spustí rutinu ve vzdálené relaci nebo ve vzdáleném počítači. Zadejte název počítače nebo objekt relace, například výstup New-CimSession rutiny.Get-CimSession Výchozí hodnota je aktuální relace na místním počítači.

Typ:CimSession[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ClassName

Určuje název třídy CIM, pro kterou se má operace provést. Pomocí dokončování tabulátoru můžete procházet seznam tříd, protože PowerShell získá seznam tříd z místního serveru WMI a poskytne seznam názvů tříd.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-ComputerName

Určuje počítač, na kterém chcete spustit operaci CIM. Můžete zadat plně kvalifikovaný název domény (FQDN) název rozhraní NetBIOS nebo IP adresu.

Pokud zadáte tento parametr, rutina vytvoří dočasnou relaci k zadanému počítači pomocí protokolu WsMan.

Pokud tento parametr nezadáte, rutina provede operaci na místním počítači pomocí modelu COM (Component Object Model).

Pokud se na stejném počítači provádí více operací, poskytuje použití relace CIM lepší výkon.

Typ:String[]
Aliasy:CN, ServerName
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MethodName

Najde třídy, které mají metodu odpovídající tomuto názvu. S tímto parametrem můžete použít zástupné znaky.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Namespace

Určuje obor názvů pro operaci CIM. Výchozí obor názvů je root/cimv2. Pomocí dokončování tabulátoru můžete procházet seznam oborů názvů, protože PowerShell získá seznam oborů názvů z místního serveru WMI a poskytne seznam oborů názvů.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-OperationTimeoutSec

Určuje dobu, po kterou rutina čeká na odpověď z počítače. Ve výchozím nastavení je hodnota tohoto parametru 0, což znamená, že rutina používá výchozí hodnotu časového limitu pro server.

Pokud je parametr OperationTimeoutSec nastaven na hodnotu menší než robustní časový limit opakování připojení 3 minuty, chyby sítě, které trvaly více než hodnota parametru OperationTimeoutSec, se nedají obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.

Typ:UInt32
Aliasy:OT
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PropertyName

Vyhledá třídy, které mají vlastnost odpovídající tomuto názvu. S tímto parametrem můžete použít zástupné znaky.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-QualifierName

Filtruje třídy podle názvu kvalifikátoru na úrovni třídy. S tímto parametrem můžete použít zástupné znaky.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

CimClass

Tato rutina vrátí objekt třídy CIM.

Poznámky

PowerShell obsahuje následující aliasy pro Get-CimClass:

  • Windows:
    • gcls

Tato rutina je dostupná jenom na platformách Windows.