Partilhar via

classe Win32_PnPEntity

  • Artigo

A classe WMIWin32_PnPEntity representa as propriedades de um dispositivo Plug and Play. Plug and Play entidades são mostradas como entradas no Gerenciador de Dispositivos localizado em Painel de Controle.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

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

Membros

A classe Win32_PnPEntity tem esses tipos de membros:

Métodos

A classe Win32_PnPEntity tem esses métodos.

Método Descrição
Desativar Desabilita esse dispositivo Plug and Play.
Habilitar Habilita esse dispositivo Plug and Play.
GetDeviceProperties Obtém as propriedades especificadas desse dispositivo Plug and Play.
Redefinir Não implementado. Para implementar esse método, consulte o método Reset em CIM_LogicalDevice.
SetPowerState Não implementado. Para implementar esse método, consulte o método SetPowerState em CIM_LogicalDevice.

 

Propriedades

A classe Win32_PnPEntity tem essas propriedades.

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado Operacional|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidade e status do dispositivo.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Energia em execução/completa (3)

Energia completa ou em execução

Aviso (4)

Em Teste (5)

Não aplicável (6)

Desligar (7)

Off Line (8)

Desativação do serviço (9)

Degradado (10)

Não Instalado (11)

Erro de instalação (12)

Power Save – Desconhecido (13)

O dispositivo é conhecido por estar em um modo de economia de energia, mas sua status exata é desconhecida.

Economia de energia – modo de energia baixa (14)

O dispositivo está em um estado de economia de energia, mas ainda está funcionando e pode apresentar desempenho degradado.

Power Save – Espera (15)

O dispositivo não está funcionando, mas pode ser levado à potência total rapidamente.

Ciclo de Energia (16)

Power Save – Aviso (17)

O dispositivo está em um estado de aviso, embora também em um modo de economia de energia.

Pausado (18)

O dispositivo está em pausa.

Não Pronto (19)

O dispositivo não está pronto.

Não Configurado (20)

O dispositivo não está configurado.

Quiesced (21)

O dispositivo está silencioso.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Descrição curta do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

ClassGuid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("WMI")

Guid (identificador global exclusivo) desse dispositivo Plug and Play.

CompatibleID

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres de identificação definida pelo fornecedor que a Instalação usa para corresponder um dispositivo a um arquivo INF. Um dispositivo pode ter uma lista de identificações compatíveis associadas a ele. As IDs compatíveis devem ser listadas para diminuir a adequação. Se a Instalação não puder localizar um arquivo INF que corresponda a uma das IDs de hardware de um dispositivo, ele usará IDs compatíveis para localizar um arquivo INF. Uma ID compatível tem o mesmo formato que um HardwareID. Para obter mais informações, consulte Kit de Driver do Windows.

ConfigManagerErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Win32 Configuration Manager código de erro.

Essa propriedade é herdada de CIM_LogicalDevice.

Este dispositivo está funcionando corretamente. (0)

O dispositivo está funcionando corretamente.

Este dispositivo não está configurado corretamente. (1)

O dispositivo não está configurado corretamente.

O Windows não pode carregar o driver para este dispositivo. (2)

O driver desse dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos. (3)

O driver desse dispositivo pode estar corrompido ou o sistema pode ter pouca memória ou outros recursos.

Este dispositivo não está funcionando corretamente. Um de seus drivers ou seu registro pode estar corrompido. (4)

O dispositivo não está funcionando corretamente. Um de seus drivers ou o registro pode estar corrompido.

O driver deste dispositivo precisa de um recurso que o Windows não possa gerenciar. (5)

O driver para o dispositivo requer um recurso que o Windows não pode gerenciar.

A configuração de inicialização deste dispositivo está em conflito com outros dispositivos. (6)

A configuração de inicialização do dispositivo está em conflito com outros dispositivos.

Não é possível filtrar. (7)

O carregador de driver para o dispositivo está ausente. (8)

O carregador de driver para o dispositivo está ausente.

Este dispositivo não está funcionando corretamente porque o firmware de controle está relatando os recursos para o dispositivo incorretamente. (9)

O dispositivo não está funcionando corretamente. O firmware de controle está relatando incorretamente os recursos para o dispositivo.

Este dispositivo não pode ser iniciado. (10)

O dispositivo não pode ser iniciado.

Este dispositivo falhou. (11)

Falha no dispositivo.

Este dispositivo não pode encontrar recursos gratuitos suficientes que ele pode usar. (12)

O dispositivo não pode encontrar recursos gratuitos suficientes para usar.

O Windows não pode verificar os recursos deste dispositivo. (13)

O Windows não pode verificar os recursos do dispositivo.

Este dispositivo não pode funcionar corretamente até que você reinicie o computador. (14)

O dispositivo não pode funcionar corretamente até que o computador seja reiniciado.

Este dispositivo não está funcionando corretamente porque provavelmente há um problema de renumeração. (15)

O dispositivo não está funcionando corretamente devido a um possível problema de renumeração.

O Windows não pode identificar todos os recursos que este dispositivo usa. (16)

O Windows não pode identificar todos os recursos que o dispositivo usa.

Este dispositivo está solicitando um tipo de recurso desconhecido. (17)

O dispositivo está solicitando um tipo de recurso desconhecido.

Reinstale os drivers para este dispositivo. (18)

Os drivers de dispositivo devem ser reinstalados.

Falha ao usar o carregador VxD. (19)

Seu registro pode estar corrompido. (20)

O Registro pode estar corrompido.

Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. O Windows está removendo este dispositivo. (21)

Falha do sistema. Se a alteração do driver de dispositivo for ineficaz, consulte a documentação de hardware. O Windows está removendo o dispositivo.

Este dispositivo está desabilitado. (22)

O dispositivo está desabilitado.

Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. (23)

Falha do sistema. Se a alteração do driver de dispositivo for ineficaz, consulte a documentação de hardware.

Este dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados. (24)

O dispositivo não está presente, não está funcionando corretamente ou não tem todos os seus drivers instalados.

O Windows ainda está configurando este dispositivo. (25)

O Windows ainda está configurando o dispositivo.

O Windows ainda está configurando este dispositivo. (26)

O Windows ainda está configurando o dispositivo.

Este dispositivo não tem uma configuração de log válida. (27)

O dispositivo não tem uma configuração de log válida.

Os drivers para este dispositivo não estão instalados. (28)

Os drivers de dispositivo não estão instalados.

Esse dispositivo está desabilitado porque o firmware do dispositivo não lhe deu os recursos necessários. (29)

O dispositivo está desabilitado. O firmware do dispositivo não forneceu os recursos necessários.

Este dispositivo está usando um recurso irq (solicitação de interrupção) que outro dispositivo está usando. (30)

O dispositivo está usando um recurso IRQ que outro dispositivo está usando.

Este dispositivo não está funcionando corretamente porque o Windows não pode carregar os drivers necessários para este dispositivo. (31)

O dispositivo não está funcionando corretamente. O Windows não pode carregar os drivers de dispositivo necessários.

ConfigManagerUserConfig

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Se TRUE, o dispositivo está usando uma configuração definida pelo usuário.

Essa propriedade é herdada de CIM_LogicalDevice.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key

Nome da primeira classe concreta a ser exibida na cadeia de herança usada na criação de uma instância. Quando usada com as outras propriedades de chave da classe , a propriedade permite que todas as instâncias dessa classe e suas subclasses sejam identificadas exclusivamente.

Essa propriedade é herdada de CIM_LogicalDevice.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Chave, Substituição ("DeviceId"), MappingStrings ("WMI")

Identificador do dispositivo Plug and Play.

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o erro relatado em LastErrorCode agora será limpo.

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Mais informações sobre o erro registrado em LastErrorCode e informações sobre as ações corretivas que podem ser executadas.

Essa propriedade é herdada de CIM_LogicalDevice.

HardwareID

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres de identificação definida pelo fornecedor que a Instalação usa para corresponder um dispositivo a um arquivo INF. Normalmente, um dispositivo tem uma lista associada de IDs de hardware. Uma exceção é o driver de barramento 1394, que não usa IDs de hardware. A primeira ID de hardware na lista deve ser a ID do dispositivo. As IDs restantes devem ser listadas para diminuir a adequação.

As IDs de hardware aparecem em um dos seguintes formatos:

  • enumerador\enumerador-specific-device-ID

    Esse é o formato mais comum para dispositivos PnP individuais. Um exemplo de um enumerador é o BIOS ou ISAPNP.

  • *ID específica do enumerador

    Um asterisco (*) indica o uso por mais de um enumerador.

  • ID específica da classe de dispositivo

    Um formato personalizado.

Exemplos de IDs de hardware são:

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

Para obter mais informações, consulte o Kit de Driver do Windows.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Data e hora em que o objeto foi instalado. Essa propriedade não precisa de um valor para indicar que o objeto está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

LastErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Último código de erro relatado pelo dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Fabricante

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("WMI")

Nome do fabricante do dispositivo Plug and Play.

Exemplo: "Acme"

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Name")

Rótulo pelo qual o objeto é conhecido. Quando subclasse, a propriedade pode ser substituída para ser uma propriedade de chave.

Essa propriedade é herdada de CIM_ManagedSystemElement.

PNPClass

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("WMI")

Aviso

Essa propriedade, apesar de estar listada no arquivo MOF, não existe na classe . A propriedade é descrita aqui apenas para fins de integridade e para esclarecer o próprio arquivo MOF.

 

O nome do tipo desse 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: essa propriedade não está no arquivo MOF.

PNPDeviceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

O Windows Plug and Play identificador de dispositivo do dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Exemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Não implementado.

Essa propriedade é herdada de CIM_LogicalDevice.

Desconhecido (0)

As capacidades relacionadas à energia são desconhecidas.

Sem suporte (1)

Capacidades relacionadas à energia não têm suporte para este dispositivo.

Desabilitado (2)

As capacidades relacionadas à energia foram desabilitadas.

Habilitado (3)

Os recursos de gerenciamento de energia estão habilitados no momento, mas o conjunto exato de recursos é desconhecido ou as informações não estão disponíveis.

Modos de economia de energia inseridos automaticamente (4)

O dispositivo pode alterar seu estado de energia com base no uso ou em outros critérios.

Power State Settable (5)

Há suporte para o método SetPowerState . Esse método é encontrado na classe de CIM_LogicalDevice pai e pode ser implementado. Para obter mais informações, consulte Criando classes MOF (Formato de Objeto Gerenciado).

Power Cycling com suporte (6)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 ("Power Cycle").

Com suporte para Ligar /Hora (7)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 ("Power Cycle") e o parâmetro Time definido como uma data e hora específicas, ou intervalo, para ativação.

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Não implementado.

Essa propriedade é herdada de CIM_LogicalDevice.

Presente

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("WMI")

Se esse Plug and Play dispositivo está atualmente no 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: não há suporte para essa propriedade.

Serviço

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("WMI")

Nome do serviço que dá suporte a esse dispositivo Plug and Play. Para obter mais informações, consulte Win32_SystemDriverPnPEntity.

Exemplo: "atapi"

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Status atual do objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Falha de Pred" (um elemento, como uma unidade de disco rígido habilitada para SMART, pode estar funcionando corretamente, mas prevendo uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". Este último, "Serviço", pode ser aplicado durante espelho resilvering de um disco, recarregamento de uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado Operacional|003.3")

Estado do dispositivo lógico. Se essa propriedade não se aplicar ao dispositivo lógico, o valor 5 (Não Aplicável) deverá ser usado.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Habilitado (3)

Desabilitado (4)

Não aplicável (5)

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Propagado ("CIM_System. CreationClassName"), CIM_Key

Valor da propriedade CreationClassName do computador de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Propagado ("CIM_System. Nome"), CIM_Key

Nome do sistema de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

Comentários

A classe Win32_PnPEntity é derivada de CIM_LogicalDevice.

Exemplos

O Get-BrokenHardware.ps1 exemplo do PowerShell na Galeria do TechNet usa para Win32_PnPEntity para recuperar uma lista de hardware não funcionando usando o WMI.

O exemplo de código VBScript a seguir se conecta a um grupo de computadores remotos no mesmo domínio criando uma matriz de nomes de computador remoto e, em seguida, exibindo nomes dos dispositivos Plug and Play — instâncias de Win32_PnPEntity — em cada computador.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

CIM_LogicalDevice

Classes de hardware do sistema de computador

Conectando-se ao WMI em um computador remoto

Tarefas do WMI: Hardware do Computador