Partager via


Get-CimClass

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

Syntax

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. Si aucun nom de classe n’est fourni, l’applet de commande retourne toutes les classes de l’espace de noms. Contrairement à un 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 root/cimv2.

Get-CimClass

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

Cet exemple obtient les classes qui contiennent le disque word dans leur nom.

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

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

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 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 la stocke dans une variable $s à l’aide de l’applet New-CimSession de commande , puis obtient les classes à l’aide de l’applet de Get-CimClass 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 New-CimSession applet de commande ou Get-CimSession . La valeur par défaut est la session active sur l’ordinateur local.

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

-ClassName

Spécifie le nom de la classe CIM pour laquelle effectuer l’opération. Vous pouvez utiliser la saisie semi-automatique par tabulation 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 COM (Component Object Model).

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

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Namespace

Spécifie l’espace de noms pour l’opération CIM. L’espace de noms par défaut est root/cimv2. Vous pouvez utiliser la saisie semi-automatique par tabulation 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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’expiration de nouvelle tentative de connexion robuste de 3 minutes, les défaillances 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
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-QualifierName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.