Voltar à página do índice

Obtenção da configuração atual: Guia do usuário de provedores WMI e CDM dos adaptadores de rede Intel® PRO

Obtenção dos adaptadores físicos
Obtenção dos dispositivos PCI
Obtenção das configurações do adaptador
Obtenção das configurações do grupo
Obtenção das definições do grupo
Obtenção da configuração da VLAN
Obtenção das definições da VLAN
Obtenção das informações sobre o protocolo IP
Obtenção das informações sobre o boot agent
Obtenção das definições do boot agent


O cliente não precisa obter um identificador da sessão para ler a configuração atual. Os clientes podem usar um contexto NULL; entretanto, as mensagens de erro serão retornadas na linguagem padrão da máquina gerenciada. Na tabela a seguir, os itens entre { } são caminhos de objeto. Pressupõe-se que esses caminhos foram obtidos de consultas WQL anteriores. O cliente nunca deve ter necessidade de criar um caminho de objeto sem fazer um consulta. O atributo __PATH de todo objeto contém o caminho do mesmo.

Em todos os casos de uso a seguir, os métodos IWbemServices::ExecQuery e IWbemServices::ExecQueryAsync são usados para executar consultas WQL .

Obtenção dos adaptadores físicos

Tarefa Consulta WQL Classe do resultado Comentário
Enumere todos os adaptadores SELECT * FROM IANet_EthernetAdapter IANet_EthernetAdapter Retorna todos os IANet_EthernetAdapters.

Equivale a IWbemServices::CreateInstanceEnumAsync.

Determine se o adaptador é virtual. ASSOCIATORS OF {caminho do adaptador} WHERE AssocClass = IANet_NetworkVirtualAdapter IANet_TeamOfAdapters Se o resultado da consulta não for nenhuma classe, o adaptador é real.
Determine se o adaptador é fantasma ASSOCIATORS OF {caminho do adaptador} WHERE ResultClass = IANet_EthernetPCIDevice
 
IANet_EthernetPCIDevice Se o adaptador não for virtual e a consulta não retornar nenhum objeto, o adaptador é fantasma.

A classe principal dos adaptadores é IANet_EthernetAdapter. Essa classe é usada para adaptadores físicos e virtuais; o cliente deve saber fazer a distinção entre eles.

Voltar ao início


Obtenção dos dispositivos PCI

As classes principais são IANet_EthernetPCIDevice, IANet_PCIDevice e IANet_AdapterDevice (uma classe de associação para associar um adaptador a esse dispositivo).

Nesse caso, a classe de associação não contém dados, ou seja, não tem valor por si mesma. IANet_EthernetPCIDevice herda de IANet_PCIDevice e contém atributos extra que são específicos para um dispositivo PCI que é um adaptador Ethernet.

 
Tarefa Consulta WQL Classe do resultado Comentário
Enumere os dispositivos PCI de rede SELECT * FROM IANet_PCIDevice IANet_PCIDevice A consulta pode retornar modems e outros dispositivos que o Intel® PROSet não configura.

Equivale a IWbemServices::CreateInstanceEnumAsync.

Enumere todos os dispositivos PCI usados pelos adaptadores configurados pelo Intel® PROSet. SELECT * FROM IANet_EthernetPCIDevice IANet_EthernetPCIDevice A consulta retorna somente os dispositivos PCI que o Intel® PROSet gerencia.

Equivale a IWbemServices::CreateInstanceEnumAsync.

Determine se o adaptador está instalado. N/D IANet_EthernetPCIDevice Verifique o atributo “Availability” do IANet_EthernetPCIDevice. Se for igual a 10 - “Not Installed”, o dispositivo não está instalado. Nota: Nesse estágio, não se tem muita informação sobre o dispositivo.
Obtenha o dispositivo PCI associado ao adaptador ASSOCIATORS OF {caminho de IANet_EthernetAdapter} WHERE ResultClass = IANet_EthernetPCIDevice IANet_EthernetPCIDevice Se o comando não retornar nenhum objeto, o adaptador é virtual ou fantasma.
Obtenha o adaptador associado a um dispositivo PCI ASSOCIATORS OF {caminho do dispositivo Ethernet PCI}  WHERE ResultClass = IANet_EthernetAdapter IANet_EthernetAdapter Essa consulta não é ideal para o provedor — é melhor que o cliente inicie com o adaptador.

Voltar ao início


Obtenção das configurações do adaptador

Os objetos de definição não estão associados diretamente ao adaptador. Em conformidade com o padrão CIM, eles estão associados a um objeto de configuração, associado ao adaptador.

As classes envolvidas nessa parte do esquema são IANet_EthernetAdapter, IANet_Configuration, IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection e IANetSettingSlider.

As classes de associação IANet_AdapterConfiguration e IANet_SettingContext não contêm dados reais — elas atuam como uma "cola" entre as definições e o objeto pai.

 
Tarefa Consultas WQL Classe do resultado Comentários
Obtenha o objeto de configuração para o adaptador. ASSOCIATORS OF {caminho de IANet_EthernetAdapter} WHERE ResultClass = IANet_Configuration IANet_Configuration Retorna exatamente um objeto; mesmo se não houver definições, sempre haverá um objeto de configuração. O caminho desse objeto é usado na próxima consulta.
Obtenha as definições associadas ao adaptador ASSOCIATORS OF {caminho de IANet_Configuration} WHERE AssocClass = IANet_SettingContext Uma mescla de IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection,
IANet_SettingSlider
Retorna todas as classes de definição associadas ao adaptador. O cliente deve usar o atributo __CLASS para determinar o tipo de cada definição.

Voltar ao início


Obtenção da configuração do grupo

As classes principais do esquema de agrupamento são IANet_EthernetAdapter, IANet_TeamOfAdapters, IANet_NetworkVirtualAdapter e IANet_TeamedMemberAdapter.

A dificuldade desse esquema é que existe uma instância de IANet_EthernetAdapter para cada adaptador físico e virtual. O cliente deve ter a capacidade de fazer a distinção entre o adaptador virtual de um grupo e os adaptadores que são membros do grupo.

A classe de associação IANet_NetworkVirtualAdapter não contém dados úteis — na verdade, os clientes só estão interessados nos pontos de extremidade dessa associação. IANet_TeamedMemberAdapter contém dados úteis sobre o uso do adaptador membro dentro do grupo.

 
Tarefa Consultas WQL Classe do resultado Comentários
Enumere todos os grupos SELECT * FROM IANet_TeamOfAdapters IANet_TeamOfAdapters Há uma instância de IANet_TeamOfAdapters para cada grupo.

Equivale a IWbemServices::CreateInstanceEnumAsync.

Obtenha o adaptador virtual de um grupo ASSOCIATORS OF {caminho de IANet_TeamOfAdapters} WHERE AssocClass = IANet_NetworkVirtualAdapter IANet_EthernetAdapter Retorna somente o objeto de adaptador para o adaptador virtual do grupo. Esse adaptador não existe quando o grupo foi criado mas Apply não foi chamado. (veja abaixo como atualizar a configuração).
Enumere os adaptadores dos membros do grupo ASSOCIATORS OF {caminho de IANet_TeamOfAdapters} WHERE AssocClass = IANet_TeamedMemberAdapter IANet_EthernetAdapter Retorna os adaptadores que estão no grupo, mas não descreve a função desempenhada pelo adaptador.
Determine a função do adaptador em um grupo REFERENCES OF {caminho de IANet_EthernetAdapter} WHERE ResultClass = IANet_TeamedMemberAdapter IANet_TeamedMemberAdapter A classe contém informações sobre a relação entre o adaptador membro e o grupo e sobre o status atual dentro do grupo.

Voltar ao início


Obtenção das definições do grupo

Os objetos de definição não estão associados diretamente ao grupo. Em conformidade com o padrão CIM, eles estão associados a um objeto de configuração, associado ao IANet_EthernetAdapter virtual do grupo. O mesmo objeto de configuração também está associado ao objeto IANet_TeamOfAdapters do grupo.

As classes envolvidas nessa parte do esquema são IANet_EthernetAdapter, IANet_TeamOfAdapters, IANet_Configuration, IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection e IANetSettingSlider.

As classes de associação IANet_AdapterConfiguration e IANet_SettingContext não contêm dados reais — elas atuam como uma "cola" entre as definições e o objeto pai. É exatamente igual ao caso das definições de adaptador.

 
Tarefa Consultas WQL Classe do resultado Comentários
Obtenha o objeto de configuração do grupo, começando pelo adaptador virtual ASSOCIATORS OF {caminho de IANet_EthernetAdapter} WHERE ResultClass = IANet_Configuration IANet_Configuration Retorna exatamente um objeto. Mesmo se não houver definições, sempre haverá um objeto de configuração. O caminho desse objeto é usado na próxima consulta.
Obtenha o objeto de configuração do grupo, começando pelo grupo de adaptadores ASSOCIATORS OF {caminho de IANet_TeamOfAdapters} WHERE ResultClass = IANet_Configuration
Obtenha as definições associadas ao adaptador ASSOCIATORS OF {caminho de IANet_Configuration} WHERE AssocClass = IANet_SettingContext Uma mescla de IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection,
IANet_SettingSlider
Retorna todas as classes de definição associadas ao adaptador. O cliente deve usar o atributo __CLASS para determinar o tipo de cada definição.

Voltar ao início


Obtenção da configuração da VLAN

Cada adaptador que suporta VLANs tem um IANet_802dot1QVLANService associado a ele, usando a classe de associação IANet_Device802do1QVVLANServiceImplementation. Se o adaptador não tiver uma instância dessa classe associada a ele, o adaptador não suporta VLANs.

Cada VLAN é representada por uma instância de IANet_VLAN. A VLAN não é associada diretamente ao adaptador — é associada ao IANet_802dot1QVLANService do adaptador.

A classe de associação IANet_VLANFor é usada para associar cada instância da VLAN ao IANet_802dot1QVLANService correto. Essa classe não contém dados úteis para o usuário.

 
Tarefa Consultas WQL Classe do resultado Comentários
Obtenha o objeto de serviço 802.1q VLAN associado ao adaptador ASSOCIATORS OF {caminho de IANet_EthernetAdapter} WHERE ResultClass = IANet_802dot1QVLANService IANet_802dot1QVLANService Retorna um objeto ou nenhum.
Obtenha as VLANS em um adaptador. ASSOCIATORS OF {caminho de IANet_802dot1QVLANService} WHERE ResultClass = IANet_VLAN IANet_VLAN Pode não retornar nenhum objeto se não houver VLANs instaladas.

Voltar ao início


Obtenção das definições de VLAN

Os objetos de definição não estão associados diretamente à VLAN. Em conformidade com o padrão CIM, eles estão associados a um objeto de configuração, associado ao OBJETO IANet_VLAN da VLAN.

As classes envolvidas nessa parte do esquema são are IANet_VLAN, IANet_Configuration, IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection e IANetSettingSlider.

As classes de associação IANet_VLANConfiguration e IANet_SettingContext não contêm dados reais — elas atuam como uma "cola" entre as definições e o objeto pai. É exatamente igual ao caso das definições de adaptador.

 
Tarefa Consultas WQL Classe do resultado Comentários
Obtenha o objeto de configuração para a VLAN. ASSOCIATORS OF {caminho da IANet_VLAN} WHERE ResultClass = IANet_Configuration IANet_Configuration Retorna exatamente um objeto; mesmo se não houver definições, sempre haverá um objeto de configuração. O caminho desse objeto é usado na próxima consulta.
Obtenha as definições associadas à VLAN ASSOCIATORS OF {caminho de IANet_Configuration} WHERE AssocClass = IANet_SettingContext Uma mescla de IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection, IANet_SettingSlider Retorna todas as classes de definição associadas à VLAN. O cliente deve usar o atributo __CLASS para determinar o tipo de cada definição.

Voltar ao início


Obtenção das informações sobre o protocolo IP

O provedor fornece algumas informações limitadas sobre os pontos de extremidade do protocolo IP que estão associadas a adaptadores, VLANs e grupos. Não há suporte para outros protocolos.

A classe principal que contém as informações sobre protocolo é IANet_IPProtocolEndpoint. Há duas classes de associação: IANet_VLANProtocolDependency e IANet_AdapterProtocolImplementation. Para obter o ponto de extremidade IP de um grupo, primeiro obtenha o IANet_EthernetAdapter virtual do grupo, ou seja, o ponto de extremidade IP é associado a essa instância.

 
Tarefa Consultas WQL Classe do resultado Comentários
Obtenha os pontos de extremidade de protocolo IP associados ao adaptador ASSOCIATORS OF {caminho de IANet_EthernetAdapter} WHERE ResultClass = IANet_IPProtocolEndpoint  IANet_IPProtocolEndpoint
 
 
Embora alguns adaptadores tenham mais de um endereço IP, eles estarão associados a apenas uma instância de ponto de extremidade de protocolo IP.
Obtenha os pontos de extremidade de protocolo IP associados à VLAN. ASSOCIATORS OF {caminho de IANet_VLAN} WHERE ResultClass = IANet_IPProtocolEndpoint IANet_IPProtocolEndpoint Haverá um ponto de extremidade de protocolo IP associado à VLAN.

Voltar ao início


Obtenção de informações sobre o boot agent

Cada adaptador pode suportar um boot agent em ROM Flash terá uma instância de IANet_BootAgent associada a ele usando a classe de associação IANet_DeviceBootServiceImplementation.

 
Tarefa Consultas WQL Classe do resultado Comentários
Obtenha o boot agent associado ao adaptador ASSOCIATORS OF {caminho de IANet_EthernetAdapter} WHERE ResultClass = IANet_BootAgent IANet_BootAgent Os atributos "somente leitura" a seguir fornecem informações sobre a imagem ROM de inicialização para o adaptador.
InvalidImageSignature, Version, UpdateAvailable, FlashImageType

Voltar ao início


Obtenção das definições do boot agent

Os objetos de definição não estão associados diretamente ao boot agent. Em conformidade com o padrão CIM, eles estão associados a um objeto de configuração, associado ao boot agent.

As classes envolvidas nessa parte do esquema são IANet_BootAgent, IANet_Configuration, IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection e IANetSettingSlider.

As classes de associação IANet_BootAgentConfiguration e IANet_SettingContext não contêm dados reais — elas atuam como "cola" entre as definições e o objeto pai.

 
Tarefa Consultas WQL Classe do resultado Comentários
Obtenha o objeto de configuração para o boot agent. ASSOCIATORS OF {caminho de IANet_BootAgent} WHERE ResultClass = IANet_Configuration IANet_Configuration Retorna exatamente um objeto. Mesmo se não houver definições, sempre haverá um objeto de configuração. O caminho desse objeto é usado na consulta a seguir.
Obtenha as definições associadas ao boot agent ASSOCIATORS OF {caminho de IANet_Configuration} WHERE AssocClass = IANet_SettingContext Uma mescla de IANet_SettingInt, IANet_SettingString, IANet_SettingEnum, IANet_SettingMultiSelection, IANet_SettingSlider Retorna todas as classes de definição associadas ao adaptador. O cliente deve usar o atributo __CLASS para determinar o tipo de cada definição.


Leia todas as restrições e isenções de responsabilidade.


Voltar à página do Índice   Voltar ao início