Partager via

Get-CimClass

  • Référence
Module:
CimCmdlets

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

Syntax

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 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 à 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 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 qualificateurs 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 l’espace de noms racine/standardCimv2 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

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

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 d’onglet 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 des nouvelles tentatives 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 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:False

-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

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

Sorties

CimClass

Cette applet de commande retourne un objet de classe CIM.