classe Win32_PnPEntity

  • Article

La classe Win32_PnPEntityWMI représente les propriétés d’un appareil Plug-and-Play. Plug-and-Play entités sont affichées en tant qu’entrées dans le Gestionnaire de périphériques situé dans 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 dans l’ordre alphabétique, et non dans l’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 a ces types de membres :

Méthodes

La classe Win32_PnPEntity a ces méthodes.

Méthode Description
Désactiver Désactive cet appareil Plug-and-Play.
Activer Active cet appareil Plug-and-Play.
GetDeviceProperties Obtient les propriétés spécifiées de cet appareil Plug-and-Play.
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 possède ces propriétés.

Disponibilité

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.5 », « MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus »)

Disponibilité et état de l’appareil.

Cette propriété est héritée de CIM_LogicalDevice.

Autre (1)

Inconnu (2)

Exécution/puissance complète (3)

Exécution ou puissance complète

Avertissement (4)

Dans Test (5)

Non applicable (6)

Mise hors tension (7)

Off Line (8)

Hors service (9)

Détérioré (10)

Non installé (11)

Erreur d’installation (12)

Power Save - Inconnu (13)

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

Économie d’alimentation - Mode faible puissance (14)

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

Power Save - Veille (15)

L’appareil ne fonctionne pas, mais peut être amené à puissance totale rapidement.

Cycle d’alimentation (16)

Power Save - Avertissement (17)

L’appareil est dans un état d’avertissement, mais également en mode d’alimentation.

Suspendu (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é.

Quiesced (21)

L’appareil est silencieux.

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 appareil Plug-and-Play.

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 correspondre à un appareil à un fichier INF. Un appareil peut avoir une liste d’ID compatibles associés. Les ID compatibles doivent être répertoriés dans l’ordre de diminution de la pertinence. Si le programme d’installation ne peut pas localiser un fichier INF qui correspond à l’un des ID matériels 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 Kit de pilotes.

ConfigManagerErrorCode

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »)

Code d’erreur win32 Configuration Manager.

Cette propriété est héritée de CIM_LogicalDevice.

Cet appareil fonctionne correctement. (0)

L’appareil fonctionne correctement.

Cet appareil n’est pas configuré correctement. (1)

L’appareil n’est pas configuré correctement.

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

Le pilote de cet appareil peut être endommagé, ou votre système peut être en cours d’exécution faible sur la mémoire ou d’autres ressources. (3)

Le pilote de cet appareil peut être endommagé, ou le système peut être faible sur la mémoire ou d’autres ressources.

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

L’appareil ne fonctionne pas correctement. L’un de ses pilotes ou le Registre 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 nécessite 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 pilotes pour l’appareil est manquant. (8)

Le chargeur de pilotes pour l’appareil est manquant.

Cet appareil ne fonctionne pas correctement, car le microprogramme de contrôle signale les ressources de l’appareil de manière incorrecte. (9)

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

Cet appareil ne peut pas démarrer. (10)

L’appareil ne peut pas démarrer.

Cet appareil a échoué. (11)

Échec de l’appareil.

Cet appareil ne peut pas trouver suffisamment de ressources gratuites qu’il peut utiliser. (12)

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

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

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

Cet appareil 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’est pas redémarré.

Cet appareil ne fonctionne pas correctement, car il existe probablement un problème de réécriture. (15)

L’appareil ne fonctionne pas correctement en raison d’un problème de réécriture possible.

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.

Cet appareil 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 à l’aide du chargeur VxD. (19)

Votre registre peut être endommagé. (20)

Le Registre peut être endommagé.

Échec système : Essayez de modifier le pilote pour ce périphérique. Si cela ne fonctionne pas, consultez votre documentation matérielle. Windows supprime cet appareil. (21)

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

Cet appareil est désactivé. (22)

L’appareil est désactivé.

Échec système : Essayez de modifier le pilote pour ce périphérique. Si cela ne fonctionne pas, consultez votre documentation matérielle. (23)

Défaillance du système. Si la modification du pilote de périphérique est inefficace, consultez la documentation matérielle.

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

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

Windows configure toujours cet appareil. (25)

Windows configure toujours l’appareil.

Windows configure toujours cet appareil. (26)

Windows configure toujours l’appareil.

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

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

Les pilotes de ce périphérique ne sont pas installés. (28)

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

Cet appareil 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) utilisée par un autre appareil. (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 : schéma (« 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 : CIM_Key

Nom de la première classe concrète à afficher dans la chaîne d’héritage utilisée dans 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 à toutes les instances de cette classe et à ses sous-classes d’être identifiées de manière unique.

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 effacé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 et sur les actions correctives qui peuvent être effectuées.

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 utilisée par le programme d’installation pour faire correspondre un appareil à un fichier INF. Normalement, un appareil a une liste associée d’ID matériels. Une exception est le pilote de bus 1394, qui n’utilise pas d’ID matériels. Le premier ID matériel de la liste doit être l’ID d’appareil. Les ID restants doivent être répertoriés dans l’ordre de diminution de l’adéquation.

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

  • énumérateur\énumérateur-specific-device-ID

    Il s’agit du format le plus courant pour les appareils PnP individuels. Un exemple d’énumérateur est le BIOS ou ISAPNP.

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

    Un astérisque (*) indique l’utilisation par plusieurs énumérateurs.

  • ID spécifique de la classe d’appareil

    Format personnalisé.

Voici quelques exemples d’ID matériels :

root\\\*PNPOF08
PC\\VEN\_1000&DEV\_001&SUBSYS\_0000000&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’appareil 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. En cas de sous-classe, la propriété peut être remplacée comme 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

Cette propriété, bien qu’elle soit répertoriée dans le fichier MOF, n’existe pas réellement dans la classe. La propriété est décrite ici uniquement pour l’exhaustivité et pour clarifier le fichier MOF lui-même.

 

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

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 et Windows Vista : n’est pas dans le fichier MOF.

PNPDeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : schéma (« Win32 »)

Windows Plug-and-Play’identificateur d’appareil de l’appareil 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 liées à la puissance 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 lié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’enregistrement d’alimentation entrés automatiquement (4)

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

Power State Settable (5)

La méthode SetPowerState est prise en charge. Cette méthode se trouve sur la classe CIM_LogicalDevice parent et peut être implémentée. Pour plus d’informations, consultez Conception de classes MOF (Managed Object Format).

Power Cycling pris en charge (6)

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

Alimentation chronométrée prise en charge (7)

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Cycle d’alimentation ») et le paramètre Time défini sur une date et une heure spécifiques, ou 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 cet appareil Plug-and-Play se trouve 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 : 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 (« État »)

État actuel de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels incluent : « OK », « Détérioré » et « Échec prédéfinit » (un élément, tel qu’un disque dur compatible SMART, peut fonctionner correctement, mais prédire un échec dans le proche avenir). Les états non opérateur incluent : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer pendant la réécriture miroir d’un disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tout ce travail n’est pas en ligne, mais l’élément managé n’est ni « OK » ni dans 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édéfinu (« Échec prédéfinu »)

Démarrage (« Démarrage »)

Arrêt (« arrêt »)

Service (« Service  »)

Stressé (« stressé »)

NonRecover (« NonRecover  »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

StatusInfo

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.3 »)

État de l’appareil logique. Si cette propriété ne s’applique pas à l’appareil 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 : propagé (« CIM_System. CreationClassName « ), CIM_Key

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 : propagé (« CIM_System. Nom »), CIM_Key

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 PowerShellGet-BrokenHardware.ps1 sur TechNet Gallery utilise pour Win32_PnPEntity récupérer une liste de matériel non fonctionnel à 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

Spécifications

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

Voir aussi

CIM_LogicalDevice

Classes matérielles du système informatique

Connexion à WMI sur un ordinateur distant

Tâches WMI : Matériel informatique