Win32_PnPEntity classe

La classe WMIWin32_PnPEntity 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 comporte les types de membres suivants :

• Méthodes
• Propriétés

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 a ces propriétés.

Disponibilité

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| Operational State|003.5 », « MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus »)

Disponibilité et status de l’appareil.

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

Autre (1)

Inconnu (2)

En cours d’exécution/Pleine alimentation (3)

En cours d’exécution ou pleine puissance

Avertissement (4)

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

Power Save - Inconnu (13)

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

Économie d’énergie - Mode faible consommation (14)

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

Économie d’alimentation - Veille (15)

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

Cycle d’alimentation (16)

Power Save - Avertissement (17)

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

Suspendu (18)

L’appareil est suspendu.

Pas 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 faire correspondre un appareil à un fichier INF. Une liste d’ID compatibles peut être associée à un appareil. Les ID compatibles doivent être répertoriés par ordre décroissant d’adéquation. 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 Kit de pilotes Windows.

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 est peut-être endommagé ou votre système est peut-être à court de mémoire ou d’autres ressources. (3)

Le pilote de cet appareil peut être endommagé, ou le système peut être faible en 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 pilote pour l’appareil est manquant. (8)

Le chargeur de pilote 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 libres qu’il peut utiliser. (12)

L’appareil ne trouve pas 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 ne redémarrez pas 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éinsentération. (15)

L’appareil ne fonctionne pas correctement en raison d’un problème de réinsentération 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 de cet appareil. (18)

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

Échec à l’aide du chargeur VxD. (19)

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

Le Registre peut être endommagé.

Défaillance du système : essayez de modifier le pilote pour 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 matérielle. 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 pour cet appareil. 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 n’est pas efficace, 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 cet appareil 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 nécessaires. (29)

L’appareil est désactivé. Le microprogramme de l’appareil ne fournissait pas 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.

Cet appareil 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 à apparaître dans la chaîne d’héritage utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés clés de la classe, la propriété permet à toutes les instances de cette classe et de 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 : Key, Override (« 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 des informations 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 que le programme d’installation utilise 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 de l’appareil. Les ID restants doivent être répertoriés dans l’ordre décroissant d’adéquation.

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

• enumerator\enumerator-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 à 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 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

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 des raisons d’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 : cette propriété 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 à 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 liées à l’alimentation ont été désactivées.

Activé (3)

Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais l’ensemble exact des fonctionnalités 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.

Power State Settable (5)

La méthode SetPowerState est prise en charge. Cette méthode se trouve dans 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 d’alimentation »).

Prise en charge de l’alimentation chrono timed (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 : 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 »)

Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels sont les suivants : « OK », « Détérioré » et « Échec antérieur » (un élément, tel qu’un disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non opératoires sont les suivants : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer pendant miroir redimensionnement d’un disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont 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égradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

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