Get-CimClass
Hiermee haalt u een lijst met CIM-klassen op in een specifieke naamruimte.
Syntaxis
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
Deze cmdlet is alleen beschikbaar op het Windows-platform.
De Get-CimClass
cmdlet haalt een lijst met CIM-klassen op in een specifieke naamruimte. Als er geen klassenaam is opgegeven, retourneert de cmdlet alle klassen in de naamruimte. In tegenstelling tot een CIM-exemplaar bevatten CIM-klassen niet de CIM-sessie of computernaam waaruit ze worden opgehaald.
Voorbeelden
Voorbeeld 1: Alle klassedefinities ophalen
In dit voorbeeld worden alle klassedefinities opgehaald onder de naamruimte root/cimv2.
Get-CimClass
Voorbeeld 2: De klassen ophalen met een specifieke naam
In dit voorbeeld worden de klassen met het woord schijf in hun namen weergegeven.
Get-CimClass -ClassName *disk*
Voorbeeld 3: De klassen ophalen met een specifieke methodenaam
In dit voorbeeld worden de klassen ophaalt die beginnen met de naam Win32- en een methodenaam hebben die begint met Term.
Get-CimClass -ClassName Win32* -MethodName Term*
Voorbeeld 4: De klassen ophalen met een specifieke eigenschapsnaam
In dit voorbeeld worden de klassen ophaalt die beginnen met de naam Win32- en een eigenschap hebben met de naam Handle.
Get-CimClass -ClassName Win32* -PropertyName Handle
Voorbeeld 5: De klassen ophalen met een specifieke kwalificatienaam
In dit voorbeeld worden de klassen ophaalt die beginnen met de naam Win32, het woord Disk in hun naam bevatten en de opgegeven kwalificatie Associationhebben.
Get-CimClass -ClassName Win32*Disk* -QualifierName Association
Voorbeeld 6: De klassedefinities ophalen uit een specifieke naamruimte
In dit voorbeeld worden de klassedefinities opgehaald die het woord Net bevatten in hun namen van de opgegeven naamruimte root/standardCimv2.
Get-CimClass -Namespace root/standardCimv2 -ClassName *Net*
Voorbeeld 7: De klassedefinities ophalen van een externe server
In dit voorbeeld worden de klassedefinities opgehaald die het woord schijf bevatten in hun namen van de opgegeven externe servers Server01 en Server02.
Get-CimClass -ClassName *disk* -ComputerName Server01, Server02
Voorbeeld 8: De klassen ophalen met behulp van een CIM-sessie
$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *disk* -CimSession $s
Met deze set opdrachten maakt u een sessie met meerdere computers en slaat deze op in een variabele $s
met behulp van de New-CimSession
-cmdlet en haalt u vervolgens de klassen op met behulp van de Get-CimClass
-cmdlet.
Parameters
-Amended
Geeft aan dat objecten die worden geretourneerd uit de CIM-query gewijzigde informatie moeten bevatten. Gewijzigde informatie is doorgaans lokaliseerbare informatie, zoals object- en eigenschapsbeschrijvingen die zijn gekoppeld aan het CIM-object. Dit is handig voor het vertalen van numerieke waarden naar waarden die door mensen kunnen worden gelezen.
Deze parameter is toegevoegd in PowerShell 7.3.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-CimSession
De cmdlet wordt uitgevoerd in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van een New-CimSession
of Get-CimSession
cmdlet. De standaardwaarde is de huidige sessie op de lokale computer.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ClassName
Hiermee geeft u de naam van de CIM-klasse waarvoor de bewerking moet worden uitgevoerd. U kunt tabvoltooiing gebruiken om door de lijst met klassen te bladeren, omdat PowerShell een lijst met klassen ophaalt van de lokale WMI-server om een lijst met klassennamen op te geven.
Type: | String |
Position: | 0 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | True |
-ComputerName
Hiermee geeft u de computer waarop u de CIM-bewerking wilt uitvoeren. U kunt een FQDN (Fully Qualified Domain Name) een NetBIOS-naam of een IP-adres opgeven.
Als u deze parameter opgeeft, maakt de cmdlet een tijdelijke sessie naar de opgegeven computer met behulp van het WsMan-protocol.
Als u deze parameter niet opgeeft, voert de cmdlet de bewerking uit op de lokale computer met behulp van Component Object Model (COM).
Als er meerdere bewerkingen op dezelfde computer worden uitgevoerd, biedt het gebruik van een CIM-sessie betere prestaties.
Type: | String[] |
Aliassen: | CN, ServerName |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-MethodName
Hiermee vindt u de klassen met een methode die overeenkomt met deze naam. U kunt jokertekens gebruiken met deze parameter.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | True |
-Namespace
Hiermee geeft u de naamruimte voor CIM-bewerking. De standaardnaamruimte is root/cimv2. U kunt tabvoltooiing gebruiken om door de lijst met naamruimten te bladeren, omdat PowerShell een lijst met naamruimten ophaalt van de lokale WMI-server om de lijst met naamruimten op te geven.
Type: | String |
Position: | 1 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-OperationTimeoutSec
Hiermee geeft u de hoeveelheid tijd op die de cmdlet wacht op een reactie van de computer. De waarde van deze parameter is standaard 0, wat betekent dat de cmdlet de standaardtime-outwaarde voor de server gebruikt.
Als de parameter OperationTimeoutSec is ingesteld op een waarde die kleiner is dan de robuuste time-out voor opnieuw proberen van de verbinding van 3 minuten, kunnen netwerkfouten die meer duren dan de waarde van de parameter OperationTimeoutSec niet herstellen, omdat de bewerking op de server een time-out optreedt voordat de client opnieuw verbinding kan maken.
Type: | UInt32 |
Aliassen: | OT |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-PropertyName
Hiermee zoekt u de klassen met een eigenschap die overeenkomt met deze naam. U kunt jokertekens gebruiken met deze parameter.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | True |
-QualifierName
Hiermee filtert u de klassen op kwalificatienaam op klasseniveau. U kunt jokertekens gebruiken met deze parameter.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | True |
Invoerwaarden
None
U kunt geen objecten doorsluisen naar deze cmdlet.
Uitvoerwaarden
Met deze cmdlet wordt een CIM-klasseobject geretourneerd.
Notities
PowerShell bevat de volgende aliassen voor Get-CimClass
:
- Ramen:
gcls
Deze cmdlet is alleen beschikbaar op Windows-platforms.