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