classe Win32_PnPEntity

  • Articolo

La classe WMI Win32_PnPEntityrappresenta le proprietà di un dispositivo Plug and Play. Le entità Plug and Play vengono visualizzate come voci nella Gestione dispositivi che si trova in Pannello di controllo.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non in ordine MOF.

Sintassi

[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;
};

Membri

La classe Win32_PnPEntity include questi tipi di membri:

Metodi

La classe Win32_PnPEntity dispone di questi metodi.

Metodo Descrizione
Disabilita Disabilita questo dispositivo Plug and Play.
Abilitazione Abilita questo dispositivo Plug and Play.
GetDeviceProperties Ottiene le proprietà specificate di questo dispositivo Plug and Play.
Reimposta Non implementata. Per implementare questo metodo, vedere il metodo Reset in CIM_LogicalDevice.
SetPowerState Non implementata. Per implementare questo metodo, vedere il metodo SetPowerState in CIM_LogicalDevice.

 

Proprietà

La classe Win32_PnPEntity ha queste proprietà.

Disponibilità

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Stato operativo|003.5", "MIB. IETF |HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilità e stato del dispositivo.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Altro (1)

Sconosciuto (2)

Esecuzione/alimentazione completa (3)

Esecuzione o alimentazione completa

Avviso (4)

In test (5)

Non applicabile (6)

Spegnimento (7)

Fuori linea (8)

Fuori servizio (9)

Degradato (10)

Non installato (11)

Errore di installazione (12)

Risparmio energia - Sconosciuto (13)

Il dispositivo è noto come in modalità risparmio energia, ma lo stato esatto è sconosciuto.

Risparmio energia - Modalità risparmio energia ridotta (14)

Il dispositivo si trova in uno stato di risparmio energia ma funziona ancora e può presentare prestazioni ridotte.

Risparmio energia - Standby (15)

Il dispositivo non funziona, ma può essere portato a piena potenza rapidamente.

Ciclo di alimentazione (16)

Risparmio energia - Avviso (17)

Il dispositivo è in uno stato di avviso, anche se in modalità risparmio energia.

Sospeso (18)

Il dispositivo è in pausa.

Non pronto (19)

Il dispositivo non è pronto.

Non configurato (20)

Il dispositivo non è configurato.

Quiesced (21)

Il dispositivo è silenzioso.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), DisplayName ("Caption")

Breve descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

ClassGuid

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("WMI")

Identificatore univoco globale (GUID) del dispositivo Plug and Play.

CompatibleID

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringa di identificazione definita dal fornitore usata dal programma di installazione per associare un dispositivo a un file INF. A un dispositivo può essere associato un elenco di ID compatibili. Gli ID compatibili devono essere elencati in ordine di idoneità decrescente. Se il programma di installazione non riesce a individuare un file INF corrispondente a uno degli ID hardware di un dispositivo, usa ID compatibili per individuare un file INF. Un ID compatibile ha lo stesso formato di HardwareID. Per altre informazioni, vedere Windows Driver Kit.

ConfigManagerErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Codice di errore di Configuration Manager Win32.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Questo dispositivo funziona correttamente. (0)

Il dispositivo funziona correttamente.

Questo dispositivo non è configurato correttamente. (1)

Il dispositivo non è configurato correttamente.

Windows non può caricare il driver per questo dispositivo. (2)

Il driver per questo dispositivo potrebbe essere danneggiato o il sistema potrebbe essere in esecuzione insufficiente nella memoria o in altre risorse. (3)

Il driver per questo dispositivo potrebbe essere danneggiato o il sistema potrebbe essere insufficiente nella memoria o in altre risorse.

Questo dispositivo non funziona correttamente. Uno dei driver o del Registro di sistema potrebbe essere danneggiato. (4)

Il dispositivo non funziona correttamente. Uno dei driver o del Registro di sistema potrebbe essere danneggiato.

Il driver per questo dispositivo richiede una risorsa che Windows non può gestire. (5)

Il driver per il dispositivo richiede una risorsa che Windows non può gestire.

La configurazione di avvio per questo dispositivo è in conflitto con altri dispositivi. (6)

La configurazione di avvio per il dispositivo è in conflitto con altri dispositivi.

Impossibile filtrare. (7)

Il caricatore driver per il dispositivo non è presente. (8)

Driver loader per il dispositivo mancante.

Questo dispositivo non funziona correttamente perché il firmware di controllo segnala erroneamente le risorse per il dispositivo. (9)

Il dispositivo non funziona correttamente. Il firmware di controllo segnala erroneamente le risorse per il dispositivo.

Impossibile avviare il dispositivo. (10)

Impossibile avviare il dispositivo.

Il dispositivo non è riuscito. (11)

Dispositivo non riuscito.

Questo dispositivo non riesce a trovare risorse gratuite sufficienti che può usare. (12)

Il dispositivo non riesce a trovare risorse sufficienti da usare.

Windows non è in grado di verificare le risorse del dispositivo. (13)

Windows non è in grado di verificare le risorse del dispositivo.

Questo dispositivo non può funzionare correttamente fino a quando non si riavvia il computer. (14)

Il dispositivo non può funzionare correttamente finché il computer non viene riavviato.

Questo dispositivo non funziona correttamente perché è probabile che si verifichi un problema di rienumerazione. (15)

Il dispositivo non funziona correttamente a causa di un possibile problema di rienumerazione.

Windows non è in grado di identificare tutte le risorse usate dal dispositivo. (16)

Windows non è in grado di identificare tutte le risorse usate dal dispositivo.

Questo dispositivo richiede un tipo di risorsa sconosciuto. (17)

Il dispositivo richiede un tipo di risorsa sconosciuto.

Reinstallare i driver per questo dispositivo. (18)

I driver di dispositivo devono essere reinstallati.

Errore durante l'uso del caricatore VxD. (19)

Il registro potrebbe essere danneggiato. (20)

Il Registro di sistema potrebbe essere danneggiato.

Errore di sistema: provare a modificare il driver per questo dispositivo. Se non funziona, vedere la documentazione hardware. Windows rimuove questo dispositivo. (21)

Errore di sistema. Se la modifica del driver di dispositivo è inefficace, vedere la documentazione hardware. Windows rimuove il dispositivo.

Questo dispositivo è disabilitato. (22)

Il dispositivo è disabilitato.

Errore di sistema: provare a modificare il driver per questo dispositivo. In caso contrario, vedere la documentazione dell'hardware. (23)

Errore di sistema. Se la modifica del driver di dispositivo è inefficace, vedere la documentazione hardware.

Questo dispositivo non è presente, non funziona correttamente o non dispone di tutti i driver installati. (24)

Il dispositivo non è presente, non funziona correttamente o non dispone di tutti i driver installati.

Windows sta ancora configurando questo dispositivo. (25)

Windows sta ancora configurando il dispositivo.

Windows sta ancora configurando questo dispositivo. (26)

Windows sta ancora configurando il dispositivo.

Questo dispositivo non dispone di una configurazione log valida. (27)

Il dispositivo non dispone di una configurazione log valida.

I driver per questo dispositivo non sono installati. (28)

I driver di dispositivo non sono installati.

Questo dispositivo è disabilitato perché il firmware del dispositivo non ha dato le risorse necessarie. (29)

Il dispositivo è disabilitato. Il firmware del dispositivo non ha fornito le risorse necessarie.

Questo dispositivo usa una risorsa IRQ (Interrupt Request) usata da un altro dispositivo. (30)

Il dispositivo usa una risorsa IRQ usata da un altro dispositivo.

Questo dispositivo non funziona correttamente perché Windows non è in grado di caricare i driver necessari per questo dispositivo. (31)

Il dispositivo non funziona correttamente. Windows non può caricare i driver di dispositivo necessari.

ConfigManagerUserConfig

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Se TRUE, il dispositivo usa una configurazione definita dall'utente.

Questa proprietà viene ereditata da CIM_LogicalDevice.

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: CIM_Key

Nome della prima classe concreta da visualizzare nella catena di ereditarietà utilizzata nella creazione di un'istanza. Se utilizzata con le altre proprietà chiave della classe, la proprietà consente l'identificazione univoca di tutte le istanze di questa classe e delle relative sottoclassi.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Deviceid

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Key, Override ("DeviceId"), MappingStrings ("WMI")

Identificatore del dispositivo Plug and Play.

Questa proprietà viene ereditata da CIM_LogicalDevice.

ErrorCleared

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se TRUE, l'errore segnalato in LastErrorCode viene ora cancellato.

Questa proprietà viene ereditata da CIM_LogicalDevice.

ErrorDescription

Tipo di dati: string

Tipo di accesso: sola lettura

Altre informazioni sull'errore registrato in LastErrorCode e informazioni sulle azioni correttive che possono essere eseguite.

Questa proprietà viene ereditata da CIM_LogicalDevice.

HardwareID

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringa di identificazione definita dal fornitore usata dal programma di installazione per associare un dispositivo a un file INF. In genere, un dispositivo ha un elenco associato di ID hardware. Un'eccezione è il driver del bus 1394, che non usa ID hardware. Il primo ID hardware nell'elenco deve essere l'ID dispositivo. Gli ID rimanenti devono essere elencati in ordine di idoneità decrescente.

Gli ID hardware vengono visualizzati in uno dei formati seguenti:

  • enumerator\enumerator-specific-device-ID

    Questo è il formato più comune per i singoli dispositivi PnP. Un esempio di enumeratore è il BIOS o ISAPNP.

  • *ID specifico dell'enumeratore

    Un asterisco (*) indica l'uso da parte di più enumeratori.

  • ID specifico della classe device

    Formato personalizzato.

Esempi di ID hardware sono:

root\\\*PNPOF08
PC\\VEN\_1000&DEV\_001&SUBSYS\_00000000&REV\_02

Per altre informazioni, vedere Windows Driver Kit.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |ComponentID|001.5"), DisplayName ("Data di installazione")

Data e ora di installazione dell'oggetto. Questa proprietà non richiede un valore per indicare che l'oggetto è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

LastErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Ultimo codice di errore segnalato dal dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Produttore

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("WMI")

Nome del produttore del dispositivo Plug and Play.

Esempio: "Acme"

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Name")

Etichetta in base alla quale l'oggetto è noto. Se sottoclassata, è possibile eseguire l'override della proprietà in modo che sia una proprietà chiave.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

PNPClass

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("WMI")

Avviso

Questa proprietà, nonostante sia elencata nel file MOF, non esiste effettivamente nella classe . La proprietà è descritta qui solo per motivi di completezza e per chiarire il file MOF stesso.

 

Nome del tipo di dispositivo Plug and Play.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista: questa proprietà non si trova nel file MOF.

PNPDeviceID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Identificatore del dispositivo Plug and Play di Windows del dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Esempio: "*PNP030b"

PowerManagementCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Non implementata.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Sconosciuto (0)

Le capacità correlate all'alimentazione sono sconosciute.

Non supportato (1)

Le capacità correlate all'alimentazione non sono supportate per questo dispositivo.

Disabilitato (2)

Le capacità correlate all'alimentazione sono state disabilitate.

Abilitato (3)

Le funzionalità di risparmio energia sono attualmente abilitate, ma il set di funzionalità esatto è sconosciuto o le informazioni non sono disponibili.

Modalità risparmio energia immesse automaticamente (4)

Il dispositivo può modificare lo stato di alimentazione in base all'utilizzo o ad altri criteri.

Power State Settable (5)

Il metodo SetPowerState è supportato. Questo metodo è disponibile nella classe padre CIM_LogicalDevice e può essere implementato. Per altre informazioni, vedere Progettazione di classi MOF (Managed Object Format).

Power Cycling supportato (6)

Il metodo SetPowerState può essere richiamato con il parametro PowerState impostato su 5 ("Power Cycle").

Accensione temporizzato supportata (7)

Il metodo SetPowerState può essere richiamato con il parametro PowerState impostato su 5 ("Power Cycle") e il parametro Time impostato su una data e un'ora specifici, o intervallo, per l'accensione.

PowerManagementSupported

Tipo di dati: booleano

Tipo di accesso: sola lettura

Non implementata.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Presente

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("WMI")

Indica se il dispositivo Plug and Play è attualmente presente nel sistema.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista: questa proprietà non è supportata.

Servizio

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("WMI")

Nome del servizio che supporta questo dispositivo Plug and Play. Per altre informazioni, vedere Win32_SystemDriverPnPEntity.

Esempio: "atapi"

Stato

Tipo di dati: string

Tipo di accesso: sola lettura

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

Stato corrente dell'oggetto. È possibile definire vari stati operativi e non operativi. Gli stati operativi includono: "OK", "Degraded" e "Pred Fail" (un elemento, ad esempio un'unità disco rigido abilitata per SMART, potrebbe funzionare correttamente, ma prevedere un errore nel prossimo futuro). Gli stati non operativi includono: "Error", "Starting", "Stopping" e "Service". Quest'ultimo, "Servizio", può essere applicato durante il ridimensionamento mirror di un disco, il ricaricamento di un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutte queste operazioni sono online, ma l'elemento gestito non è "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Stato operativo|003.3")

Stato del dispositivo logico. Se questa proprietà non si applica al dispositivo logico, è necessario usare il valore 5 (Non applicabile).

Questa proprietà viene ereditata da CIM_LogicalDevice.

Altro (1)

Sconosciuto (2)

Abilitato (3)

Disabilitato (4)

Non applicabile (5)

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System.CreationClassName"), CIM_Key

Valore della proprietà CreationClassName del computer di ambito.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System.Nome"), CIM_Key

Nome del sistema di definizione dell'ambito.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Osservazioni:

La classe Win32_PnPEntity deriva da CIM_LogicalDevice.

Esempi

L'esempio di codice VBScript seguente si connette a un gruppo di computer remoti nello stesso dominio creando una matrice di nomi di computer remoti e quindi visualizzando i nomi dei dispositivi Plug and Play, istanze di Win32_PnPEntity, in ogni computer.

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

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

Cim_logicaldevice

Classi hardware del sistema informatico

Connessione a WMI in un computer remoto

Attività WMI: Hardware del computer