Get-CimClass

Module:

CimCmdlets Module

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

Syntaxe

ComputerSet (Par défaut)

Get-CimClass
    [[-ClassName] <string>]
    [[-Namespace] <string>]
    [-Amended]
    [-OperationTimeoutSec <uint>]
    [-ComputerName <string[]>]
    [-MethodName <string>]
    [-PropertyName <string>]
    [-QualifierName <string>]
    [<CommonParameters>]

SessionSet

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

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

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

Propriétés du paramètre

Type:	CimSession[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

SessionSet

Position:	Named
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ClassName

Spécifie le nom de la classe CIM pour laquelle effectuer l’opération. Vous pouvez utiliser la complétion automatique par onglet 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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	True
DontShow:	False

Jeux de paramètres

(All)

Position:	0
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

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

Propriétés du paramètre

Type:	String[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	CN, Nom du serveur

Jeux de paramètres

ComputerSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	True
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-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 complétion par tabulation pour parcourir la liste des namespaces, car PowerShell récupère la liste des namespaces depuis le serveur WMI local pour la fournir.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	1
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	UInt32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	OT

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	True
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	True
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.

Liens associés

• New-CimSession