Freigeben über

Get-CimClass

  • Referenz
Modul:
CimCmdlets

Ruft eine Liste der CIM-Klassen in einem bestimmten Namespace ab.

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Get-CimClass Cmdlet ruft eine Liste von CIM-Klassen in einem bestimmten Namespace ab. Wenn kein Klassenname angegeben ist, gibt das Cmdlet alle Klassen im Namespace zurück. Im Gegensatz zu einer CIM-Instanz enthalten CIM-Klassen nicht den CIM-Sitzungs- oder Computernamen, aus dem sie abgerufen werden.

Beispiele

Beispiel 1: Abrufen aller Klassendefinitionen

In diesem Beispiel werden alle Klassendefinitionen unter dem Namespacestamm /cimv2 abgerechnet.

Get-CimClass

Beispiel 2: Abrufen der Klassen mit einem bestimmten Namen

In diesem Beispiel werden die Klassen mit dem Wortdatenträger in ihren Namen ab.

Get-CimClass -ClassName *disk*

Beispiel 3: Abrufen der Klassen mit einem bestimmten Methodennamen

Dieses Beispiel ruft die Klassen ab, die mit dem Namen Win32 beginnen und einen Methodennamen haben, der mit "Ausdruck" beginnt.

Get-CimClass -ClassName Win32* -MethodName Term*

Beispiel 4: Abrufen der Klassen mit einem bestimmten Eigenschaftsnamen

Dieses Beispiel ruft die Klassen ab, die mit dem Namen Win32 beginnen und eine Eigenschaft mit dem Namen Handle haben.

Get-CimClass -ClassName Win32* -PropertyName Handle

Beispiel 5: Abrufen der Klassen mit einem bestimmten Qualifizierernamen

In diesem Beispiel werden die Klassen, die mit dem Namen Win32 beginnen, das Wort Datenträger in ihren Namen enthalten und die angegebene Qualifiziererzuordnung aufweisen.

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

Beispiel 6: Abrufen der Klassendefinitionen aus einem bestimmten Namespace

In diesem Beispiel werden die Klassendefinitionen abgerufen, die das Wort Net in ihren Namen aus dem angegebenen Namespacestamm /standardCimv2 enthalten.

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

Beispiel 7: Abrufen der Klassendefinitionen von einem Remoteserver

In diesem Beispiel werden die Klassendefinitionen abgerufen, die den Wortdatenträger in ihren Namen von den angegebenen Remoteservern Server01 und Server02 enthalten.

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

Beispiel 8: Abrufen der Klassen mithilfe einer CIM-Sitzung

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

Dieser Satz von Befehlen erstellt eine Sitzung mit mehreren Computern und speichert sie mithilfe des New-CimSession Cmdlets in einer Variablen $s und ruft dann die Klassen mithilfe des Get-CimClass Cmdlets ab.

Parameter

-Amended

Gibt an, dass von der CIM-Abfrage zurückgegebene Objekte geänderte Informationen enthalten sollen. In der Regel sind geänderte Informationen lokalisierbare Informationen, z. B. Objekt- und Eigenschaftsbeschreibungen, die dem CIM-Objekt zugeordnet sind. Dies ist nützlich, um numerische Werte in lesbare Werte zu übersetzen.

Dieser Parameter wurde in PowerShell 7.3 hinzugefügt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CimSession

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines New-CimSession Oder Get-CimSession Cmdlets. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Typ:CimSession[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ClassName

Gibt den Namen der CIM-Klasse an, für die der Vorgang ausgeführt werden soll. Sie können den Tabstoppabschluss verwenden, um die Liste der Klassen zu durchsuchen, da PowerShell eine Liste von Klassen vom lokalen WMI-Server abruft, um eine Liste der Klassennamen bereitzustellen.

Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-ComputerName

Gibt den Computer an, auf dem der CIM-Vorgang ausgeführt werden soll. Sie können einen vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) einen NetBIOS-Namen oder eine IP-Adresse angeben.

Wenn Sie diesen Parameter angeben, erstellt das Cmdlet mithilfe des WsMan-Protokolls eine temporäre Sitzung auf dem angegebenen Computer.

Wenn Sie diesen Parameter nicht angeben, führt das Cmdlet den Vorgang auf dem lokalen Computer mithilfe des Component Object Model (COM) aus.

Wenn mehrere Vorgänge auf demselben Computer ausgeführt werden, bietet die Verwendung einer CIM-Sitzung eine bessere Leistung.

Typ:String[]
Aliase:CN, ServerName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MethodName

Sucht die Klassen, die über eine Methode verfügen, die diesem Namen entspricht. Sie können mit diesem Parameter Wildcardzeichen verwenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Namespace

Gibt den Namespace für DEN CIM-Vorgang an. Der Standardnamespace ist root/cimv2. Sie können die Registerkartenabschluss verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste von Namespaces vom lokalen WMI-Server abruft, um die Liste der Namespaces bereitzustellen.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OperationTimeoutSec

Gibt die Zeitspanne an, die das Cmdlet auf eine Antwort vom Computer wartet. Standardmäßig ist der Wert dieses Parameters 0, was bedeutet, dass das Cmdlet den Standardtimeoutwert für den Server verwendet.

Wenn der Parameter OperationTimeoutSec auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungsretrytimeout von 3 Minuten ist, können Netzwerkfehler, die mehr als der Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server zu einem Timeout vor dem erneuten Herstellen der Verbindung führen kann.

Typ:UInt32
Aliase:OT
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PropertyName

Sucht die Klassen, die über eine Eigenschaft verfügen, die diesem Namen entspricht. Sie können mit diesem Parameter Wildcardzeichen verwenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-QualifierName

Filtert die Klassen nach klassenebenenqualifizierernamen. Sie können mit diesem Parameter Wildcardzeichen verwenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

CimClass

Dieses Cmdlet gibt ein CIM-Klassenobjekt zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Get-CimClass:

  • Windows:
    • gcls

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.