Classe Win32_NetworkAdapter

A classe Win32_NetworkAdapter foi preterida. Em vez disso, use a classe MSFT_NetAdapter . A classe WMIWin32_NetworkAdapter representa um adaptador de rede de um computador que executa um sistema operacional Windows.

Win32_NetworkAdapter fornece apenas dados IPv4. Para obter mais informações, consulte Suporte a IPv6 e IPv4 no WMI.

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("{8502C4C0-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkAdapter : CIM_NetworkAdapter
{
  string   AdapterType;
  uint16   AdapterTypeID;
  boolean  AutoSense;
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   GUID;
  uint32   Index;
  datetime InstallDate;
  boolean  Installed;
  uint32   InterfaceIndex;
  uint32   LastErrorCode;
  string   MACAddress;
  string   Manufacturer;
  uint32   MaxNumberControlled;
  uint64   MaxSpeed;
  string   Name;
  string   NetConnectionID;
  uint16   NetConnectionStatus;
  boolean  NetEnabled;
  string   NetworkAddresses[];
  string   PermanentAddress;
  boolean  PhysicalAdapter;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   ProductName;
  string   ServiceName;
  uint64   Speed;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  datetime TimeOfLastReset;
};

Membros

A classe Win32_NetworkAdapter tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

A classe Win32_NetworkAdapter tem esses métodos.

Método	Descrição
Desativar	Desabilita o adaptador de rede.
Habilitar	Habilita o adaptador de rede.
Redefinir	Não implementado. Para obter mais informações sobre como implementar esse método, consulte o método Reset em CIM_NetworkAdapter.
SetPowerState	Não implementado. Para obter mais informações sobre como implementar esse método, consulte o método SetPowerState em CIM_NetworkAdapter.

 

Propriedades

A classe Win32_NetworkAdapter tem essas propriedades.

AdapterType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_USE")

Meio de rede em uso. Os adaptadores de rede são os seguintes:

Ethernet 802.3 ("Ethernet 802.3")

Token Ring 802.5 ("Token Ring 802.5")

Interface de dados distribuídos de fibra (FDDI) ("Interface de dados distribuídos de fibra (FDDI)")

WAN (Rede de Longa Distância) ("WAN (Rede de Longa Distância)")

LocalTalk ("LocalTalk")

Ethernet usando o formato de cabeçalho DIX ("Ethernet usando o formato de cabeçalho DIX")

ARCNET ("ARCNET")

ARCNET (878.2) ("ARCNET (878.2)")

CAIXA ELETRÔNICO ("CAIXA ELETRÔNICO")

Sem fio ("Sem fio")

Infrared Wireless ("Infrared Wireless")

Bpc ("Bpc")

CoWan ("CoWan")

1394 ("1394")

AdapterTypeID

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_USE")

Meio de rede em uso. Retorna as mesmas informações que a propriedade AdapterType , exceto que as informações estão na forma de um inteiro.

Ethernet 802.3 (0)

Anel de Token 802.5 (1)

FDDI (Interface de Dados Distribuídos de Fibra) (2)

WAN (Rede de Longa Distância) (3)

LocalTalk (4)

Ethernet usando o formato de cabeçalho DIX (5)

ARCNET (6)

ARCNET (878.2) (7)

CAIXA ELETRÔNICO (8)

Sem fio (9)

Sem fio infravermelho (10)

Bpc (11)

CoWan (12)

1394 (13)

Auto

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se True, o adaptador de rede poderá determinar automaticamente a velocidade da mídia anexada ou de rede.

Essa propriedade é herdada de CIM_NetworkAdapter.

Essa propriedade ainda não foi implementada. Ele retorna um valor NULL por padrão.

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 completa/em execução (3)

Energia completa ou em execução

Aviso (4)

Em Teste (5)

Não aplicável (6)

Desligar (7)

Off Line (8)

Desativada (9)

Degradado (10)

Não Instalado (11)

Erro de instalação (12)

Economia de energia – Desconhecido (13)

O dispositivo é conhecido por estar em um estado de economia de energia, mas seu status exato é desconhecido.

Economia de energia – modo de energia baixa (14)

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

Economia de energia – espera (15)

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

Ciclo de Energia (16)

Economia de energia – Aviso (17)

O dispositivo está em um estado de aviso, embora também em um estado 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 — uma cadeia de caracteres de uma linha.

Essa propriedade é herdada de CIM_ManagedSystemElement.

ConfigManagerErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Código de erro do Windows Configuration Manager.

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 deste dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos. (3)

O driver para este dispositivo pode estar corrompido ou o sistema pode estar com 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 aparecer na cadeia de herança usada na criação de uma instância. Quando usada com as outras propriedades principais 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 ("Win32Registry| System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318}")

Identificador exclusivo do adaptador de rede de outros dispositivos no sistema.

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 quaisquer ações corretivas que possam ser executadas.

Essa propriedade é herdada de CIM_LogicalDevice.

GUID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Identificador global exclusivo para a conexão.

Index

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32Registry| System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318}")

Número de índice do adaptador de rede, armazenado no registro do sistema.

Exemplo: 0

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.

Essa propriedade ainda não foi implementada. Ele retorna um valor NULL por padrão.

Instalado

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: PRETERIDO, MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| DriverDate")

Se True, o adaptador de rede será instalado no sistema.

Interfaceindex

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Valor de índice que identifica exclusivamente o adaptador de rede local. O valor nessa propriedade é o mesmo que o valor na propriedade InterfaceIndex na instância de Win32_IP4RouteTable que representa o adaptador de rede na tabela de rotas.

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.

MACAddress

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções de entrada e saída do dispositivo| DeviceIoControl")

Endereço de controle de acesso de mídia para este adaptador de rede. Um endereço MAC é um número exclusivo de 48 bits atribuído ao adaptador de rede pelo fabricante. Ele identifica exclusivamente esse adaptador de rede e é usado para mapear comunicações de rede TCP/IP.

Fabricante

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| Fabricante")

Nome do fabricante do adaptador de rede.

Exemplo: "3COM"

MaxNumberControlled

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Porta do Barramento|001.9| Número máximo de anexos")

Número máximo de portas endereçáveis diretamente compatíveis com esse adaptador de rede. Um valor de 0 (zero) deve ser usado se o número for desconhecido.

Maxspeed

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: unidades ("bits por segundo")

Velocidade máxima, em bits por segundo, para o adaptador de rede.

Essa propriedade é herdada de CIM_NetworkAdapter.

Essa propriedade ainda não foi implementada. Ele retorna um valor NULL por padrão.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

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.

NetConnectionID

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Nome da conexão de rede como ela aparece no programa Painel de Controle Conexões de Rede.

NetConnectionStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Estado da conexão do adaptador de rede com a rede.

Desconectado (0)

Conexão (1)

Conectado (2)

Desconexão (3)

Hardware não presente (4)

Hardware desabilitado (5)

Falha de hardware (6)

Mídia Desconectada (7)

Autenticação (8)

Autenticação bem-sucedida (9)

Falha na autenticação (10)

Endereço inválido (11)

Credenciais necessárias (12)

Outros

13–65535

NetEnabled

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o adaptador está habilitado ou não. Se True, o adaptador estará habilitado. Você pode habilitar ou desabilitar a NIC usando os métodos Habilitar e Desabilitar .

NetworkAddresses

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), MappingStrings ("MIF. DMTF| Adaptador de rede 802 Porta|001.3")

Matriz de endereços de rede para um adaptador.

Essa propriedade é herdada de CIM_NetworkAdapter.

Essa propriedade ainda não foi implementada. Ele retorna um valor NULL por padrão.

PermanentAddress

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), MappingStrings ("MIF. DMTF| Adaptador de rede 802 Porta|001.2")

Endereço de rede embutido em código em um adaptador. Esse endereço embutido em código pode ser alterado por atualização de firmware ou configuração de software. Nesse caso, esse campo deverá ser atualizado quando a alteração for feita. A propriedade deverá ser deixada em branco se nenhum endereço embutido em código existir para o adaptador de rede.

Essa propriedade é herdada de CIM_NetworkAdapter.

Essa propriedade ainda não foi implementada. Ele retorna um valor NULL por padrão.

PhysicalAdapter

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o adaptador é um adaptador físico ou lógico. Se True, o adaptador será físico.

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

Matriz das funcionalidades específicas relacionadas à energia de um dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Desconhecido (0)

Sem suporte (1)

Desabilitado (2)

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)

Com suporte para Power-On cronometrado

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

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se True, o dispositivo pode ser gerenciado por energia (pode ser colocado no modo de suspensão e assim por diante). A propriedade não indica que os recursos de gerenciamento de energia estão habilitados no momento, apenas que o dispositivo lógico é capaz de gerenciamento de energia.

Essa propriedade é herdada de CIM_LogicalDevice.

ProductName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| ServiceName")

Nome do produto do adaptador de rede.

Exemplo: "Fast EtherLink XL"

ServiceName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| ProductName")

Nome do serviço do adaptador de rede. Esse nome geralmente é menor que o nome completo do produto.

Exemplo: "Elnkii"

Velocidade

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIB. IETF| RFC1213-MIB.ifSpeed", "MIF. DMTF| Adaptador de rede 802 Porta|001,5"), Unidades ("bits por segundo")

Estimativa da largura de banda atual em bits por segundo. Para pontos de extremidade que variam em largura de banda ou para aqueles em que nenhuma estimativa precisa pode ser feita, essa propriedade deve conter a largura de banda nominal.

Essa propriedade é herdada de CIM_NetworkAdapter.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Status atual do objeto. 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.

TimeOfLastReset

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009| Tempo de Configuração do Sistema")

Data e hora em que o adaptador de rede foi redefinido pela última vez.

Comentários

A classe Win32_NetworkAdapter é derivada de CIM_NetworkAdapter.

A lista a seguir descreve as classes associadores para Win32_NetworkAdapter:

• Win32_PnPEntity
• Win32_ComputerSystem
• Win32_NetworkAdapterConfiguration
• Win32_IRQResource
• Win32_DeviceMemoryAddress
• Win32_PortResource
• Win32_NetworkProtocol
• Win32_SystemDriver

Muitos sistemas têm vários adaptadores de rede. Considere usar o seguinte como referência para localizar os adaptadores atuais:

AdapterType: "Ethernet 802.3"
MACAddress: String Length > 16
Availability: 3
PNPDeviceID: InStr ( PNPDeviceID, "PCI") = 1
Installed: vbTrue
ConfigManagerErrorCode: 0
: <keep this as an index to Win32_NetworkAdapterConfiguration>

Mesmo usando os qualificadores acima, você provavelmente recuperará mais de um adaptador de rede válido. Se esse for o caso, você poderá usar as seguintes informações para qualificar ainda mais a pesquisa do Win32_NetworkAdapterConfiguration:

Index: <match to DeviceID above>
MACAddress: Length > 16
DefaultIPGateway: String Length > 6
DNSServerSearchOrder: Array of strings with length > 6
IPEnabled: vbTrue
IPAddress: Array of strings with length > 6

Depois de fazer isso, você provavelmente terá reduzido sua lista para um ou dois adaptadores configurados.

Você também pode usar o seguinte procedimento para encontrar o adaptador padrão:

1. Execute a seguinte consulta:

   "SELECT InterfaceIndex, Destination FROM Win32_IP4RouteTable WHERE Destination='0.0.0.0'"

   Você deve ter apenas um destino de rede padrão 0.0.0.0.

2. Use o InterfaceIndex para recuperar o Adaptador de Rede desejado.

   "SELECT * FROM Win32_NetworkAdapter WHERE InterfaceIndex=" + insertVariableHere

Exemplos

O exemplo de código do PowerShell duas funções WMI na Galeria do TechNet usa Win32_NetworkAdapter para recriar o cmdlet Get-NetAdapter do Windows.

O exemplo Get-ComputerInfo – Consultar informações do computador de computadores locais/remotos – (WMI) no TechNet Gallery usa várias chamadas para hardware e software, incluindo Win32_NetworkAdapter, para exibir informações sobre um sistema local ou remoto.

O exemplo de código C# a seguir usa o namespace Microsoft.Management.Infrastructure para recuperar os adaptadores de rede atuais no computador local.

using Microsoft.Management.Infrastructure;
...
static void QueryInstanceFunc()
        {
 
            CimSession session = CimSession.Create("localHost");
            IEnumerable<CimInstance> queryInstance = session.QueryInstances(@"root\cimv2", "WQL", "SELECT * FROM Win32_NetworkAdapter");

            foreach (CimInstance cimObj in queryInstance)
            {
                Console.WriteLine(cimObj.CimInstanceProperties["Name"].ToString());
                Console.WriteLine(cimObj.CimInstanceProperties["Description"].ToString());
                Console.WriteLine();
            }

            Console.ReadLine();
        }

O exemplo de código C# a seguir usa https://msdn.microsoft.com/library/system.management.aspx namespace para recuperar os adaptadores de rede atuais no computador local.

Observação

https://msdn.microsoft.com/library/system.management.aspx contém as classes originais usadas para acessar o WMI; no entanto, eles são considerados mais lentos e geralmente não são dimensionados, bem como seus equivalentes Microsoft.Management.Infrastructure .

 

using System.Management;
...
        static void oldSchoolQueryInstanceFunc()
        {

            ObjectQuery query = new ObjectQuery("SELECT * FROM Win32_NetworkAdapter");
            ManagementObjectSearcher searcher = new ManagementObjectSearcher(query);


            ManagementObjectCollection queryCollection = searcher.Get();
            foreach (ManagementObject m in queryCollection)
            {
                Console.WriteLine("ServiceName : {0}", m["Name"]);
                Console.WriteLine("MACAddress : {0}", m["Description"]);
                Console.WriteLine();
            }
            Console.ReadLine();

        }

O exemplo de código VBScript a seguir descreve como recuperar os adaptadores de rede atuais no computador local.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_NetworkAdapter")

For Each objItem in colItems 
    Wscript.Echo "Name: " & objItem.Name
    Wscript.Echo "Description: " & objItem.Description
    Wscript.Echo
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_NetworkAdapter

Classes de hardware do sistema de computador

Tarefas do WMI: Rede

Suporte a IPv6 e IPv4 no WMI