Share via

Get-CimClass

  • Riferimento
Modulo:
CimCmdlets

Ottiene un elenco di classi CIM in uno spazio dei nomi specifico.

Sintassi

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

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il Get-CimClass cmdlet recupera un elenco di classi CIM in uno spazio dei nomi specifico. Se non è stato specificato alcun nome di classe, il cmdlet restituisce tutte le classi nello spazio dei nomi . A differenza di un'istanza CIM, le classi CIM non contengono la sessione CIM o il nome del computer da cui vengono recuperati.

Esempio

Esempio 1: Ottenere tutte le definizioni di classe

In questo esempio vengono recuperate tutte le definizioni di classe nella radice dello spazio dei nomi /cimv2.

Get-CimClass

Esempio 2: Ottenere le classi con un nome specifico

In questo esempio vengono recuperate le classi che contengono il disco delle parole nei relativi nomi.

Get-CimClass -ClassName *disk*

Esempio 3: Ottenere le classi con un nome di metodo specifico

Questo esempio ottiene le classi che iniziano con il nome Win32 e hanno un nome di metodo che inizia con Term.

Get-CimClass -ClassName Win32* -MethodName Term*

Esempio 4: Ottenere le classi con un nome di proprietà specifico

Questo esempio ottiene le classi che iniziano con il nome Win32 e hanno una proprietà denominata Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Esempio 5: Ottenere le classi con un nome qualificatore specifico

Questo esempio ottiene le classi che iniziano con il nome Win32, contengono la parola Disk nei nomi e hanno il qualificatore specificato Association.

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

Esempio 6: Ottenere le definizioni di classe da uno spazio dei nomi specifico

In questo esempio vengono ottenute le definizioni di classe che contengono la parola Net nei relativi nomi dalla radice/standardCimv2 dello spazio dei nomi specificata.

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

Esempio 7: Ottenere le definizioni di classe da un server remoto

In questo esempio vengono ottenute le definizioni di classe che contengono il disco delle parole nei relativi nomi dai server remoti specificati Server01 e Server02.

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

Esempio 8: Ottenere le classi usando una sessione CIM

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

Questo set di comandi crea una sessione con più computer e la archivia in una variabile $s usando il New-CimSession cmdlet e quindi ottiene le classi usando il Get-CimClass cmdlet .

Parametri

-Amended

Indica che gli oggetti restituiti dalla query CIM devono contenere informazioni modificate. In genere, le informazioni modificate sono informazioni localizzabili, ad esempio descrizioni di oggetti e proprietà associate all'oggetto CIM. Ciò è utile per convertire i valori numerici in valori leggibili.

Questo parametro è stato aggiunto in PowerShell 7.3.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Esegue il cmdlet in una sessione remota o in un computer remoto. Immettere un nome computer o un oggetto sessione, ad esempio l'output di un New-CimSession cmdlet o Get-CimSession . Il valore predefinito è la sessione corrente nel computer locale.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ClassName

Specifica il nome della classe CIM per cui eseguire l'operazione. È possibile usare il completamento tramite tabulazione per esplorare l'elenco delle classi, perché PowerShell ottiene un elenco di classi dal server WMI locale per fornire un elenco di nomi di classi.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-ComputerName

Specifica il computer in cui si desidera eseguire l'operazione CIM. È possibile specificare un nome di dominio completo (FQDN) un nome NetBIOS o un indirizzo IP.

Se si specifica questo parametro, il cmdlet crea una sessione temporanea nel computer specificato usando il protocollo WsMan.

Se non si specifica questo parametro, il cmdlet esegue l'operazione nel computer locale usando Component Object Model (COM).

Se più operazioni vengono eseguite nello stesso computer, l'uso di una sessione CIM offre prestazioni migliori.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MethodName

Trova le classi con un metodo corrispondente a questo nome. È possibile usare caratteri jolly con questo parametro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Namespace

Specifica lo spazio dei nomi per l'operazione CIM. Lo spazio dei nomi predefinito è root/cimv2. È possibile usare il completamento della scheda per esplorare l'elenco degli spazi dei nomi, perché PowerShell ottiene un elenco di spazi dei nomi dal server WMI locale per fornire l'elenco degli spazi dei nomi.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Specifica la quantità di tempo in cui il cmdlet attende una risposta dal computer. Per impostazione predefinita, il valore di questo parametro è 0, il che significa che il cmdlet usa il valore di timeout predefinito per il server.

Se il parametro OperationTimeoutSec è impostato su un valore inferiore al timeout di tentativo di connessione affidabile di 3 minuti, gli errori di rete che durano più del valore del parametro OperationTimeoutSec non sono recuperabili, perché l'operazione sul server scade prima che il client possa riconnettersi.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PropertyName

Trova le classi con una proprietà corrispondente a questo nome. È possibile usare caratteri jolly con questo parametro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-QualifierName

Filtra le classi in base al nome del qualificatore a livello di classe. È possibile usare caratteri jolly con questo parametro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

CimClass

Questo cmdlet restituisce un oggetto classe CIM.

Note

PowerShell include gli alias seguenti per Get-CimClass:

  • Windows:
    • gcls

Questo cmdlet è disponibile solo nelle piattaforme Windows.