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>]
   [-OperationTimeoutSec <UInt32>]
   [-ComputerName <String[]>]
   [-MethodName <String>]
   [-PropertyName <String>]
   [-QualifierName <String>]
   [<CommonParameters>]
Get-CimClass
   [[-ClassName] <String>]
   [[-Namespace] <String>]
   [-OperationTimeoutSec <UInt32>]
   -CimSession <CimSession[]>
   [-MethodName <String>]
   [-PropertyName <String>]
   [-QualifierName <String>]
   [<CommonParameters>]

Description

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

L’applet de commande Get-CimClass 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 classe sous l’espace de noms racine/cimv2.

Get-CimClass

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

Cet exemple obtient les classes qui contiennent le mot disque 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 Terme.

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 le qualificateur spécifié Association.

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 l’espace de noms spécifié racine/standardCimv2.

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 mot disque dans leurs noms à partir des serveurs distants spécifiés Server01 et Server02.

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 de commande New-CimSession, puis obtient les classes à l’aide de l’applet de commande Get-CimClass.

Paramètres

-CimSession

Exécute l’applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, tel que la sortie d’une New-CimSession ou d’une applet de commande Get-CimSession. 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 ne 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:False

-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

Cette applet de commande n’accepte aucun objet d’entrée.

Sorties

CimClass

Cette applet de commande retourne un objet de classe CIM.