Get-CimClass
Ruft eine Liste der CIM-Klassen in einem bestimmten Namespace ab.
Syntax
ComputerSet (Standardwert)
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>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das cmdlet Get-CimClass ruft eine Liste der 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 Namen der CIM-Sitzung oder des Computers, von dem sie abgerufen werden.
Beispiele
Beispiel 1: Abrufen aller Klassendefinitionen
In diesem Beispiel werden alle Klassendefinitionen unter dem Namespace root/CIMV2.
Get-CimClass
Beispiel 2: Abrufen der Klassen mit einem bestimmten Namen
In diesem Beispiel werden die Klassen ab, die das Wort Datenträger- in ihren Namen enthalten.
Get-CimClass -ClassName *Disk*
Beispiel 3: Erhalte die Klassen mit einem bestimmten Methodennamen
Dieses Beispiel ermittelt die Klassen, die mit dem Namen Win32 beginnen und einen Methodennamen haben, der mit Term beginnt.
Get-CimClass -ClassName Win32* -MethodName Term*
Beispiel 4: Klassen mit einem bestimmten Eigenschaftsnamen abrufen
Dieses Beispiel ermittelt die Klassen, die mit dem Namen Win32 beginnen und eine Eigenschaft namens Handle haben.
Get-CimClass -ClassName Win32* -PropertyName Handle
Beispiel 5: Abrufen der Klassen mit einem bestimmten Qualifizierungsnamen
Dieses Beispiel ruft die Klassen ab, die mit dem Namen Win32 beginnen, das Wort Datenträger in ihrem Namen enthalten und den angegebenen Qualifier Association haben.
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 Namespace root/StandardCimv2enthalten.
Get-CimClass -Namespace root/StandardCimv2 -ClassName *Net*
Beispiel 7: Abrufen der Klassendefinitionen von einem Remoteserver
In diesem Beispiel werden die Klassendefinitionen abgerufen, die das Wort Datenträger- in ihren Namen von den angegebenen Remoteservern Server01- und Server02-enthalten.
Get-CimClass -ClassName *Disk* -ComputerName Server01, Server02
Beispiel 8: Abrufen der Klassen mit Hilfe 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 in einer Variablen $s mithilfe des cmdlets New-CimSession und ruft dann die Klassen mithilfe des cmdlets Get-CimClass 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CimSession
Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, wie z. B. die Ausgabe eines New-CimSession- oder Get-CimSession-Cmdlets. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.
Parametereigenschaften
| Typ: | |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
SessionSet
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ClassName
Gibt den Namen der CIM-Klasse an, für die der Vorgang ausgeführt werden soll. Sie können die Tab-Vervollständigung 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | China, Servername |
Parametersätze
ComputerSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-MethodName
Sucht die Klassen, die über eine Methode verfügen, die diesem Namen entspricht. Sie können mit diesem Parameter Wildcardzeichen verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Namespace
Gibt den Namespace für die CIM-Operation an. Der Standardnamespace ist root/CIMV2. Sie können die Registerkartenvervollständigung verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste der Namespaces vom lokalen WMI-Server abruft, um die Liste der Namespaces bereitzustellen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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 OperationTimeoutSec-Parameter auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungswiederholungszeitlimit von 3 Minuten ist, können Netzwerkfehler, die länger als den Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server überschritten wird, bevor der Client die Verbindung erneut herstellen kann.
Parametereigenschaften
| Typ: | UInt32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | OT |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PropertyName
Sucht die Klassen, die über eine Eigenschaft verfügen, die diesem Namen entspricht. Sie können mit diesem Parameter Wildcardzeichen verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-QualifierName
Filtert die Klassen nach dem Namen des Class Level Qualifiers. Sie können mit diesem Parameter Wildcardzeichen verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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:
- Fenster:
gcls
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
