_Classe PnPEntity Win32

La classe WMI _ PnPEntity WMI représente les propriétés d’un appareil plug-and-Play. Plug-and-Play entités sont affichées comme entrées dans le Gestionnaire de périphériques situé dans le panneau de configuration.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées par ordre alphabétique, et non par ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), UUID("{FE28FD98-C875-11d2-B352-00104BC97924}"), AMENDMENT]
class Win32_PnPEntity : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  string   ClassGuid;
  string   CompatibleID[];
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   HardwareID[];
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Manufacturer;
  string   Name;
  string   PNPClass;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  boolean  Present;
  string   Service;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Membres

La classe Win32 _ PnPEntity possède les types de membres suivants :

Méthodes

La classe Win32 _ PnPEntity possède ces méthodes.

Méthode Description
Désactive Désactive cet appareil Plug-and-Play.
Activer Active cette Plug-and-Play appareil.
GetDeviceProperties Obtient les propriétés spécifiées de cette Plug-and-Play appareil.
Réinitialiser Non implémenté. Pour implémenter cette méthode, consultez la méthode Reset dans CIM _ LogicalDevice.
SetPowerState Non implémenté. Pour implémenter cette méthode, consultez la méthode SetPowerState dans CIM _ LogicalDevice.

Propriétés

La classe Win32 _ PnPEntity a ces propriétés.

Disponibilité

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIF. |État opérationnel DMTF | 003,5 "," MIB. |Hôte IETF-ressources-MIB. hrDeviceStatus ")

Disponibilité et état de l’appareil.

Cette propriété est héritée de CIM _ LogicalDevice.

Autre (1)

Inconnu (2)

En cours d’exécution/pleine puissance (3)

En cours d’exécution ou pleine puissance

Avertissement (4)

Dans le test (5)

Non applicable (6)

Mise hors tension (7)

Hors ligne (8)

Hors service (9)

Détérioré (10)

Non installé (11)

Erreur d’installation (12)

Économie d’énergie-inconnu (13)

L’appareil est connu pour être en mode d’économie d’énergie, mais son état exact est inconnu.

Économie d’énergie-mode faible puissance (14)

L’appareil est dans un état d’économie d’énergie, mais fonctionne toujours et peut présenter des performances dégradées.

Économie d’énergie-veille (15)

L’appareil ne fonctionne pas, mais peut être mis à la pleine puissance rapidement.

Cycle d’alimentation (16)

Économie d’énergie-Avertissement (17)

L’appareil est dans un état d’avertissement, bien qu’il soit également en mode d’économie d’énergie.

En Pause (18)

L’appareil est suspendu.

Non prêt (19)

Le périphérique n’est pas prêt.

Non configuré (20)

L’appareil n’est pas configuré.

Suspendu (21)

L’appareil est calme.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description de l’objet.

Cette propriété est héritée de CIM _ ManagedSystemElement.

ClassGuid

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« WMI »)

Identificateur global unique (GUID) de cet Plug-and-Play appareil.

CompatibleID

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Chaîne d’identification définie par le fournisseur que le programme d’installation utilise pour faire correspondre un appareil à un fichier INF. Une liste d’ID compatibles peut être associée à un appareil. Les ID compatibles doivent être classés par ordre décroissant d’adéquation. Si le programme d’installation ne parvient pas à localiser un fichier INF qui correspond à l’un des ID de matériel d’un appareil, il utilise des ID compatibles pour localiser un fichier INF. Un ID compatible a le même format qu’un HardwareID. Pour plus d’informations, consultez Windows Driver Kit.

ConfigManagerErrorCode

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32")

Code d’erreur Configuration Manager Win32.

Cette propriété est héritée de CIM _ LogicalDevice.

Ce périphérique fonctionne correctement. (0)

L’appareil fonctionne correctement.

Ce périphérique n’est pas configuré correctement. (1)

L’appareil n’est pas configuré correctement.

Windows ne peut pas charger le pilote de cet appareil. (2)

Le pilote de cet appareil est peut-être endommagé ou votre système ne dispose peut-être pas de suffisamment de mémoire ou d’autres ressources. (3)

Le pilote de cet appareil est peut-être endommagé ou la mémoire ou d’autres ressources du système sont peut-être insuffisantes.

Cet appareil ne fonctionne pas correctement. L’un de ses pilotes ou votre registre est peut-être endommagé. (4)

L’appareil ne fonctionne pas correctement. L’un de ses pilotes ou le Registre est peut-être endommagé.

Le pilote de cet appareil a besoin d’une ressource que Windows ne peut pas gérer. (5)

Le pilote de l’appareil requiert une ressource que Windows ne peut pas gérer.

La configuration de démarrage de cet appareil est en conflit avec d’autres appareils. (6)

La configuration de démarrage de l’appareil est en conflit avec d’autres appareils.

Impossible de filtrer. (7)

Le chargeur de pilote de l’appareil est manquant. (8)

Le chargeur de pilote de l’appareil est manquant.

Ce périphérique ne fonctionne pas correctement, car le microprogramme de contrôle ne signale pas correctement les ressources pour l’appareil. (9)

L’appareil ne fonctionne pas correctement. Le microprogramme de contrôle ne signale pas correctement les ressources pour l’appareil.

Impossible de démarrer cet appareil. (10)

Impossible de démarrer l’appareil.

Échec de cet appareil. (11)

Échec de l’appareil.

Ce périphérique ne peut pas trouver suffisamment de ressources disponibles. douze

L’appareil ne peut pas trouver suffisamment de ressources libres à utiliser.

Windows ne peut pas vérifier les ressources de cet appareil. (13)

Windows ne peut pas vérifier les ressources de l’appareil.

Ce périphérique ne peut pas fonctionner correctement tant que vous n’avez pas redémarré votre ordinateur. (14)

L’appareil ne peut pas fonctionner correctement tant que l’ordinateur n’a pas redémarré.

Cet appareil ne fonctionne pas correctement en raison d’un problème de réénumération. (15)

L’appareil ne fonctionne pas correctement en raison d’un éventuel problème de réénumération.

Windows ne peut pas identifier toutes les ressources utilisées par cet appareil. (16)

Windows ne peut pas identifier toutes les ressources utilisées par l’appareil.

Ce périphérique demande un type de ressource inconnu. (17)

L’appareil demande un type de ressource inconnu.

Réinstallez les pilotes pour cet appareil. (18)

Les pilotes de périphérique doivent être réinstallés.

Échec lors de l’utilisation du chargeur VxD. (19)

Votre registre est peut-être endommagé. (20)

Le Registre est peut-être endommagé.

Défaillance du système : essayez de modifier le pilote de cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. Windows supprime cet appareil. (21)

Défaillance du système. Si la modification du pilote de périphérique n’est pas efficace, consultez la documentation du matériel. Windows supprime l’appareil.

Cet appareil est désactivé. (22)

L’appareil est désactivé.

Défaillance du système : essayez de modifier le pilote de cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. (23)

Défaillance du système. Si la modification du pilote de périphérique n’est pas efficace, consultez la documentation du matériel.

Ce périphérique n’est pas présent, ne fonctionne pas correctement ou tous ses pilotes ne sont pas installés. (24)

L’appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés.

Windows est toujours en cours de configuration de cet appareil. (25)

Windows est toujours en cours de configuration de l’appareil.

Windows est toujours en cours de configuration de cet appareil. (26)

Windows est toujours en cours de configuration de l’appareil.

Cet appareil n’a pas de configuration de journal valide. (27)

L’appareil n’a pas une configuration de journal valide.

Les pilotes de cet appareil ne sont pas installés. (28)

Les pilotes de périphérique ne sont pas installés.

Ce périphérique est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources requises. (29)

L’appareil est désactivé. Le microprogramme de l’appareil n’a pas fourni les ressources requises.

Cet appareil utilise une ressource de demande d’interruption (IRQ) qu’un autre appareil utilise. (30)

L’appareil utilise une ressource IRQ qu’un autre appareil utilise.

Ce périphérique ne fonctionne pas correctement, car Windows ne peut pas charger les pilotes requis pour cet appareil. 31

L’appareil ne fonctionne pas correctement. Windows ne peut pas charger les pilotes de périphérique requis.

ConfigManagerUserConfig

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32")

Si la valeur est true, l’appareil utilise une configuration définie par l’utilisateur.

Cette propriété est héritée de CIM _ LogicalDevice.

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : _ clé CIM

Nom de la première classe concrète à afficher dans la chaîne d’héritage utilisée lors de la création d’une instance. Lorsqu’elle est utilisée avec les autres propriétés de clé de la classe, la propriété permet d’identifier de manière unique toutes les instances de cette classe et de ses sous-classes.

Cette propriété est héritée de CIM _ LogicalDevice.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName ("Description")

Description de l’objet.

Cette propriété est héritée de CIM _ ManagedSystemElement.

DeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé, remplacement (« DeviceID »), MappingStrings (« WMI »)

Identificateur de l’appareil Plug-and-Play.

Cette propriété est héritée de CIM _ LogicalDevice.

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est true, l’erreur signalée dans LastErrorCode est maintenant désactivée.

Cette propriété est héritée de CIM _ LogicalDevice.

ErrorDescription

Type de données : chaîne

Type d'accès : Lecture seule

Plus d’informations sur l’erreur enregistrée dans LastErrorCode, ainsi que sur les actions correctives qui peuvent être prises.

Cette propriété est héritée de CIM _ LogicalDevice.

HardwareID

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Chaîne d’identification définie par le fournisseur que le programme d’installation utilise pour faire correspondre un appareil à un fichier INF. Normalement, un appareil possède une liste associée d’ID matériels. Le pilote de bus 1394, qui n’utilise pas d’ID de matériel, est une exception. Le premier ID matériel de la liste doit être l’ID de l’appareil. Les ID restants doivent être classés par ordre décroissant d’adéquation.

Les ID de matériel s’affichent dans l’un des formats suivants :

  • énumérateur d’énumérateur \ -spécifique-appareil-ID

    Il s’agit du format le plus courant pour les périphériques PnP individuels. Le BIOS ou la ISAPNP est un exemple d’énumérateur.

  • *ID spécifique à l’énumérateur

    Un astérisque ( * ) indique une utilisation par plus d’un énumérateur.

  • ID spécifique à la classe de l’appareil

    Format personnalisé.

Voici quelques exemples d’ID de matériel :

\\ \* PNPOF08 racine
PC \\ VEN \_ 1000&DEV \_ 001&subsi \_ 00000000&Rev \_ 02

Pour plus d’informations, consultez le Kit de pilotes Windows.

InstallDate

Type de données : DateTime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIF. DMTF | ComponentID | 001,5 "), DisplayName (" date d’installation ")

Date et heure d’installation de l’objet. Cette propriété n’a pas besoin d’une valeur pour indiquer que l’objet est installé.

Cette propriété est héritée de CIM _ ManagedSystemElement.

LastErrorCode

Type de données : UInt32

Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’unité logique.

Cette propriété est héritée de CIM _ LogicalDevice.

Fabricant

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« WMI »)

Nom du fabricant de l’appareil Plug-and-Play.

Exemple : « Acme »

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName ("Name")

Étiquette par laquelle l’objet est connu. Lorsqu’elle est sous-classée, la propriété peut être substituée pour être une propriété de clé.

Cette propriété est héritée de CIM _ ManagedSystemElement.

PNPClass

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« WMI »)

Avertissement

En dépit de la liste dans le fichier MOF, cette propriété n’existe pas réellement dans la classe. La propriété est décrite ici uniquement pour des raisons d’exhaustivité et pour clarifier le fichier MOF lui-même.

Nom du type de ce Plug-and-Play appareil.

Windows server 2012 R2, Windows 8.1, Windows server 2012, Windows 8, Windows server 2008 R2, Windows 7, Windows server 2008 et Windows Vista : Cette propriété n’est pas dans le fichier MOF.

PNPDeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32")

Identificateur d’appareil Windows Plug-and-Play de l’unité logique.

Cette propriété est héritée de CIM _ LogicalDevice.

Exemple : « * PNP030b »

PowerManagementCapabilities

Type de données : tableau UInt16

Type d'accès : Lecture seule

Non implémenté.

Cette propriété est héritée de CIM _ LogicalDevice.

Inconnu (0)

Les capacités associées à l’alimentation sont inconnues.

Non pris en charge (1)

Les capacités liées à l’alimentation ne sont pas prises en charge pour cet appareil.

Désactivé (2)

Les capacités associées à l’alimentation ont été désactivées.

Activé (3)

Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais le jeu de fonctionnalités exact est inconnu ou les informations ne sont pas disponibles.

Modes d’économie d’énergie entrés automatiquement (4)

L’appareil peut modifier son état d’alimentation en fonction de l’utilisation ou d’autres critères.

État d’alimentation définissable (5)

La méthode SetPowerState est prise en charge. Cette méthode se trouve sur la classe parente du _ LogicalDevice CIM et peut être implémentée. Pour plus d’informations, consultez conception de Classes format MOF (MOF).

Cycle d’alimentation pris en charge (6)

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Power cycle »).

Mise sous tension minutée prise en charge (7)

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Power cycle ») et le paramètre Time défini sur une date et une heure spécifiques, ou un intervalle, pour la mise sous tension.

PowerManagementSupported

Type de données : booléen

Type d'accès : Lecture seule

Non implémenté.

Cette propriété est héritée de CIM _ LogicalDevice.

Présent

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« WMI »)

Indique si ce Plug-and-Play périphérique est actuellement dans le système.

Windows server 2012 R2, Windows 8.1, Windows server 2012, Windows 8, Windows server 2008 R2, Windows 7, Windows server 2008 et Windows Vista : Cette propriété n’est pas prise en charge.

Service

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« WMI »)

Nom du service qui prend en charge cet appareil Plug-and-Play. Pour plus d’informations, consultez Win32 _ SystemDriverPnPEntity.

Exemple : « ATAPI »

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName ("Status")

État actuel de l’objet. Divers États opérationnels et inopérationnels peuvent être définis. Les États opérationnels sont les suivants : « OK », « détérioré » et « échec prévu » (un élément, tel qu’un lecteur de disque dur intelligent, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les États qui ne sont pas opérationnels sont les suivants : « erreur », « démarrage », « arrêt » et « service ». Le dernier, « service », peut s’appliquer pendant la réargentation en miroir d’un disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous les travaux de ce type ne sont pas en ligne, mais l’élément géré n’est ni « OK », ni de l’un des autres États.

Cette propriété est héritée de CIM _ ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« erreur »)

Détérioré (« détérioré »)

Inconnu ("inconnu")

Échec prévu (« échec prédit »)

Démarrage en cours (« démarrage »)

Arrêt en cours (« arrêt »)

Service (« service »)

Stressed (« stressed »)

Non récupéré (« non récupéré »)

Aucun contact (« aucun contact »)

Communication perdue (« inversée comm »)

StatusInfo

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIF. |État opérationnel DMTF | 003,3 ")

État de l’unité logique. Si cette propriété ne s’applique pas à l’unité logique, la valeur 5 (non applicable) doit être utilisée.

Cette propriété est héritée de CIM _ LogicalDevice.

Autre (1)

Inconnu (2)

Activé (3)

Désactivé (4)

Non applicable (5)

SystemCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Propaged ("CIM _ System.CreationClassName"), _ clé CIM

Valeur de la propriété CreationClassName de l’ordinateur d’étendue.

Cette propriété est héritée de CIM _ LogicalDevice.

SystemName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Propaged ("CIM _ System.Name"), _ clé CIM

Nom du système d’étendue.

Cette propriété est héritée de CIM _ LogicalDevice.

Notes

La classe Win32 _ PnPEntity est dérivée de CIM _ LogicalDevice.

Exemples

L’exemple Get-BrokenHardware.ps1 PowerShell de la Galerie TechNet utilise pour Win32 _ PnPEntity pour récupérer une liste de matériel non opérationnel à l’aide de WMI.

L’exemple de code VBScript suivant se connecte à un groupe d’ordinateurs distants dans le même domaine en créant un tableau de noms d’ordinateurs distants, puis en affichant les noms des appareils Plug-and-Play (instances de Win32 _ PnPEntity) sur chaque ordinateur.

On Error Resume Next 
arrComputers = Array("Computer1","Computer2","Computer3")
For Each strComputer In arrComputers
    WScript.Echo
    WScript.Echo "===================================="
    WScript.Echo "Computer: "& strComputer
    WScript.Echo "===================================="

    Set objWMIService = GetObject("winmgmts:\\" _
        & strComputer& "\root\CIMV2") 
    Set colItems = objWMIService.ExecQuery( _
        "SELECT * FROM Win32_PnPEntity",,48) 
    For Each objItem in colItems 
        Wscript.Echo "-----------------------------------"
        Wscript.Echo "Win32_PnPEntity instance"
        Wscript.Echo "-----------------------------------"
        Wscript.Echo "Name: "& objItem.Name
        Wscript.Echo "Status: "& objItem.Status
    Next
Next

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

_LOGICALDEVICE CIM

Classes matérielles du système informatique

Connexion à WMI sur un ordinateur distant

Tâches WMI : matériel de l’ordinateur