Partager via

Get-CimClass

  • Référence
Module:
CimCmdlets

Obtient une liste de classes CIM dans un espace de noms spécifique.

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

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Get-CimClass de commande récupère une liste de classes CIM dans un espace de noms spécifique. S’il n’existe aucun nom de classe fourni, l’applet de commande retourne toutes les classes de l’espace de noms. Contrairement à une instance CIM, les classes CIM ne contiennent pas le nom de session CIM ou d’ordinateur à partir duquel elles sont récupérées.

Exemples

Exemple 1 : Obtenir toutes les définitions de classe

Cet exemple obtient toutes les définitions de classes sous la racine/cimv2 de l’espace de noms.

Get-CimClass

Exemple 2 : Obtenir les classes avec un nom spécifique

Cet exemple obtient les classes qui contiennent le disque word dans leurs noms.

Get-CimClass -ClassName *disk*

Exemple 3 : Obtenir les classes avec un nom de méthode spécifique

Cet exemple obtient les classes qui commencent par le nom Win32 et ont un nom de méthode qui commence par Term.

Get-CimClass -ClassName Win32* -MethodName Term*

Exemple 4 : Obtenir les classes avec un nom de propriété spécifique

Cet exemple obtient les classes qui commencent par le nom Win32 et ont une propriété nommée Handle.

Get-CimClass -ClassName Win32* -PropertyName Handle

Exemple 5 : Obtenir les classes avec un nom de qualificateur spécifique

Cet exemple obtient les classes qui commencent par le nom Win32, contiennent le mot Disque dans leurs noms et ont l’association de qualificateur spécifiée.

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

Exemple 6 : Obtenir les définitions de classe à partir d’un espace de noms spécifique

Cet exemple obtient les définitions de classe qui contiennent le mot Net dans leurs noms à partir de la racine d’espace de noms /standardCimv2 spécifiée.

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

Exemple 7 : Obtenir les définitions de classe à partir d’un serveur distant

Cet exemple obtient les définitions de classe qui contiennent le disque word dans leurs noms à partir des serveurs distants Server01 et Server02 spécifiés.

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

Exemple 8 : Obtenir les classes à l’aide d’une session CIM

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

Cet ensemble de commandes crée une session avec plusieurs ordinateurs et les stocke dans une variable $s à l’aide de l’applet New-CimSession de commande, puis obtient les classes à l’aide de l’applet Get-CimClass de commande.

Paramètres

-Amended

Indique que les objets retournés par la requête CIM doivent contenir des informations modifiées. En règle générale, les informations modifiées sont des informations localisables, telles que des descriptions d’objets et de propriétés attachées à l’objet CIM. Cela est utile pour traduire des valeurs numériques en valeurs lisibles par l’homme.

Ce paramètre a été ajouté dans PowerShell 7.3.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CimSession

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, tel que la sortie d’une ou Get-CimSession d’une New-CimSession applet de commande. La valeur par défaut est la session active sur l’ordinateur local.

Type:CimSession[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ClassName

Spécifie le nom de la classe CIM pour laquelle effectuer l’opération. Vous pouvez utiliser la saisie semi-automatique des onglets pour parcourir la liste des classes, car PowerShell obtient une liste de classes à partir du serveur WMI local pour fournir une liste de noms de classes.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-ComputerName

Spécifie l’ordinateur sur lequel vous souhaitez exécuter l’opération CIM. Vous pouvez spécifier un nom de domaine complet (FQDN) un nom NetBIOS ou une adresse IP.

Si vous spécifiez ce paramètre, l’applet de commande crée une session temporaire sur l’ordinateur spécifié à l’aide du protocole WsMan.

Si vous ne spécifiez pas ce paramètre, l’applet de commande effectue l’opération sur l’ordinateur local à l’aide du modèle objet de composant (COM).

Si plusieurs opérations sont effectuées sur le même ordinateur, l’utilisation d’une session CIM offre de meilleures performances.

Type:String[]
Alias:CN, ServerName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MethodName

Recherche les classes qui ont une méthode correspondant à ce nom. Vous pouvez utiliser des caractères génériques avec ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Namespace

Spécifie l’espace de noms pour l’opération CIM. L’espace de noms par défaut est racine/cimv2. Vous pouvez utiliser la saisie semi-automatique des onglets pour parcourir la liste des espaces de noms, car PowerShell obtient une liste d’espaces de noms à partir du serveur WMI local pour fournir la liste des espaces de noms.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-OperationTimeoutSec

Spécifie la durée pendant laquelle l’applet de commande attend une réponse de l’ordinateur. Par défaut, la valeur de ce paramètre est 0, ce qui signifie que l’applet de commande utilise la valeur de délai d’expiration par défaut pour le serveur.

Si le paramètre OperationTimeoutSec est défini sur une valeur inférieure au délai d’attente de nouvelle tentative de connexion robuste de 3 minutes, les échecs réseau qui durent plus que la valeur du paramètre OperationTimeoutSec ne sont pas récupérables, car l’opération sur le serveur expire avant que le client puisse se reconnecter.

Type:UInt32
Alias:OT
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PropertyName

Recherche les classes qui ont une propriété correspondant à ce nom. Vous pouvez utiliser des caractères génériques avec ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-QualifierName

Filtre les classes par nom de qualificateur de niveau classe. Vous pouvez utiliser des caractères génériques avec ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

CimClass

Cette applet de commande retourne un objet de classe CIM.

Notes

PowerShell inclut les alias suivants pour Get-CimClass:

  • Windows :
    • gcls

Cette applet de commande est disponible uniquement sur les plateformes Windows.