物理アダプタの取得
PCI デバイスの取得
アダプタ設定の取得
チーム構成の取得
チーム設定の取得
VLAN 構成の取得
VLAN 設定の取得
IP プロトコル情報の取得
Boot Agent 情報の取得
Boot Agent 設定の取得
現在の設定を読み込むために、クライアントはセッション ハンドルを取得する必要はありません。クライアントは NULL コンテキストを使用することができますが、管理されているマシンでは、すべてのエラー メッセージはデフォルトの言語で返されます。次の表の {} で囲まれたアイテムは、オブジェクトのパスです。これらのパスは、以前の WQL クエリで取得されたと仮定します。クライアントでは、クエリなしでオブジェクト パスを作成する必要はありません。各オブジェクトの __PATH 属性には、そのオブジェクトのオブジェクト パスが含まれます。
以下の使用例では、WQL クエリの実行に IWbemServices::ExecQuery メソッド、または IWbemServices::ExecQueryAsync メソッドを使用しています。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| 全アダプタの列挙 | SELECT * FROM IANet_EthernetAdapter | IANet_EthernetAdapter | すべての IANet_EthernetAdapters を返す
IWbemServices::CreateInstanceEnumAsync と同様 |
| アダプタが仮想アダプタかどうかの判定 | ASSOCIATORS OF {アダプタのパス} WHERE AssocClass = IANet_NetworkVirtualAdapter | IANet_TeamOfAdapters | クエリで何もクラスが返されない場合は、アダプタは実際のアダプタです。 |
| アダプタがゴースト アダプタかどうかの判定 | ASSOCIATORS OF {アダプタのパス} WHERE ResultClass = IANet_EthernetPCIDevice |
IANet_EthernetPCIDevice | アダプタが仮想アダプタではなく、このクエリによってオブジェクトが返されない場合、アダプタはゴースト アダプタです。 |
アダプタの主なクラスは IANet_EthernetAdapter です。このクラスは物理アダプタと仮想アダプタの両方に使用されます。クライアントで両者を識別する方法がわかっていることが必要です。
主なクラスは IANet_EthernetPCIDevice、IANet_PCIDevice、および IANet_AdapterDevice (アダプタをデバイスに関連付ける関連クラス) です。
この場合、関連クラスにはデータは含まれません。つまり、関連クラスにはデータはありません。IANet_EthernetPCIDevice は IANet_PCIDevice から継承され、イーサネット アダプタである PCI デバイスに特有な追加の属性を含みます。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| ネットワーク PCI デバイスの列挙 | SELECT * FROM IANet_PCIDevice | IANet_PCIDevice | クエリで Intel(R) PROSet では設定されないモデムやその他のデバイスが返される場合があります。
IWbemServices::CreateInstanceEnumAsync と同様 |
| Intel(R) PROSet で設定されたアダプタで使用されるすべての PCI デバイスを列挙 | SELECT * FROM IANet_EthernetPCIDevice | IANet_EthernetPCIDevice | クエリでは、Intel(R) PROSet で管理される PCI デバイスのみが返されます。 IWbemServices::CreateInstanceEnumAsync と同様 |
| アダプタがインストールされているかどうかの判定 | 該当なし | IANet_EthernetPCIDevice | IANet_EthernetPCIDevice の Availability 属性を確認します。この属性が 10 - Not Installed (インストールされていない) の場合、デバイスはインストールされていません。注:この時点では、デバイスについて確認されている情報はあまりありません。 |
| アダプタに関連付けられている PCI デバイスの取得 | ASSOCIATORS OF { IANet イーサネット アダプタのパス} WHERE ResultClass = IANet_EthernetPCIDevice | IANet_EthernetPCIDevice | オブジェクトが返されない場合、アダプタは仮想アダプタか、ゴースト アダプタです。 |
| PCI デバイスに関連付けられたアダプタの取得 | ASSOCIATORS OF {イーサネット PCI デバイスのパス} WHERE ResultClass = IANet_EthernetAdapter | IANet_EthernetAdapter | このクエリは、Provider に最適なものではありません。クライアントは、アダプタのある状態で起動するのが理想的です。 |
設定オブジェクトは、アダプタと直接関連付けられてはいません。CIM 標準に準拠して、設定オブジェクトは構成オブジェクトと関連付けられ、構成オブジェクトがアダプタと関連付けられます。
スキーマのこの部分に関わるクラスは、IANet_EthernetAdapter、IANet_Configuration、IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection および IANetSettingSlider です。
関連クラスである IANet_AdapterConfiguration と IANet_SettingContext には、実際のデータは含まれません。これらのクラスは、設定と親オブジェクトの橋渡しの役割を果たします。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| アダプタの構成オブジェクトの取得 | ASSOCIATORS OF { IANet イーサネット アダプタのパス} WHERE ResultClass = IANet_Configuration | IANet_Configuration | 1 つのオブジェクトのみを返します。設定がない場合でも、常に構成オブジェクトは存在します。次のクエリでは、このオブジェクトからのオブジェクト パスが使用されます。 |
| アダプタに関連付けられている設定の取得 | ASSOCIATORS OF {IANet の構成パス} WHERE AssocClass = IANet_SettingContext | IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection、 および IANet_SettingSlider が混在します。 |
アダプタに関連付けられているすべての設定クラスを返します。クライアントで各設定のタイプを判定するには、__CLASS 属性を使用します。 |
チーム化スキーマの主なクラスには、IANet_EthernetAdapter、IANet_TeamOfAdapters、IANet_NetworkVirtualAdapter、および IANet_TeamedMemberAdapter があります。
このスキーマで問題になるのは、IANet_EthernetAdapter のインスタンスが各物理アダプタと各仮想アダプタに存在するという点です。クライアントでは、チームの仮想アダプタと、チームのメンバーであるアダプタを区別できることが必要です。
関連クラス IANet_NetworkVirtualAdapter には、実際に使用されるデータは含まれません。クライアントで問題となるのは、この関連のエンドポイントのみです。IANet_TeamedMemberAdapter には、チーム内でメンバー アダプタがどのように使用されるかについて、有用なデータは含まれていません。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| すべてのチームの列挙 | SELECT * FROM IANet_TeamOfAdapters | IANet_TeamOfAdapters | 各チームに対し、IANet_TeamOfAdapters のインスタンスが 1 つ存在します。 IWbemServices::CreateInstanceEnumAsync と同様 |
| チームの仮想アダプタの取得 | ASSOCIATORS OF {IANet アダプタ チームのパス} WHERE AssocClass = IANet_NetworkVirtualAdapter | IANet_EthernetAdapter | チーム内の仮想アダプタのアダプタ オブジェクトのみを返します。チームが作成されていても、Apply が呼び出されていない場合は、このアダプタは存在しません(下記の設定の更新の項を参照してください)。 |
| チームのメンバー アダプタの列挙 | ASSOCIATORS OF {IANet アダプタ チームのパス} WHERE AssocClass = IANet_TeamedMemberAdapter | IANet_EthernetAdapter | チーム内のアダプタを返しますが、各アダプタの役割は表示されません。 |
| チーム内のアダプタの役割の判定 | REFERENCES OF {IANet イーサネット アダプタのパス} WHERE ResultClass = IANet_TeamedMemberAdapter | IANet_TeamedMemberAdapter | このクラスには、メンバー アダプタとチームの関係およびチーム内での現在の状態に関する情報が含まれます。 |
設定オブジェクトは、チームと直接関連付けられてはいません。CIM 標準に準拠して、設定オブジェクトは構成オブジェクトと関連付けられ、構成オブジェクトがチームの仮想 IANet_EthernetAdapter と関連付けられます。また、同じ構成オブジェクトがチームの IANet_TeamOfAdapters オブジェクトにも関連付けられます。
スキーマのこの部分に関わるクラスは、IANet_EthernetAdapter、IANet_TeamOfAdapters、IANet_Configuration、IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection、および IANetSettingSlider です。
関連クラスである IANet_AdapterConfiguration と IANet_SettingContext には、実際のデータは含まれません。これらのクラスは、設定と親オブジェクトの橋渡しの役割を果たします。これは、アダプタ設定の場合と同じです。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| 仮想アダプタから始まる、チームの構成オブジェクトの取得 | ASSOCIATORS OF { IANet イーサネット アダプタのパス} WHERE ResultClass = IANet_Configuration | IANet_Configuration | 1 つのオブジェクトのみを返します。設定がない場合でも、構成オブジェクトは常に存在します。次のクエリでは、このオブジェクトからのオブジェクト パスが使用されます。 |
| アダプタのチームから始まる、チームの構成オブジェクトの取得 | ASSOCIATORS OF { IANet アダプタ チームのパス} WHERE ResultClass = IANet_Configuration | ||
| アダプタに関連付けられている設定の取得 | ASSOCIATORS OF {IANet の構成パス} WHERE AssocClass = IANet_SettingContext | IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection、 および IANet_SettingSlider が混在します。 |
アダプタに関連付けられているすべての設定クラスを返します。クライアントで各設定のタイプを判定するには、__CLASS 属性を使用します。 |
VLAN をサポートする各アダプタには、関連クラス IANet_Device802do1QVVLANServiceImplementation を使用して、IANet_802dot1QVLANService が関連付けられています。アダプタにこのクラスのインスタンスが関連付けられていない場合、そのアダプタは VLAN をサポートしません。
各 VLAN は、IANet_VLAN のインスタンスで表されます。VLAN はアダプタと直接関連付けられてはいません。VLAN はアダプタの IANet_802dot1QVLANService に関連付けられます。
各 VLAN を適切な IANet_802dot1QVLANService と関連付けるために、関連クラス IANet_VLANFor が使用されます。このクラスには、ユーザに有用なデータは含まれていません。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| アダプタに関連付けられている 802.1q VLAN サービス オブジェクトの取得 | ASSOCIATORS OF {IANet イーサネット アダプタのパス} WHERE ResultClass = IANet_802dot1QVLANService | IANet_802dot1QVLANService | 1 つのオブジェクトを返すか、オブジェクトを返しません。 |
| アダプタの VLAN の取得 | ASSOCIATORS OF {IANet 802dot1QVLANService パス} WHERE ResultClass = IANet_VLAN | IANet_VLAN | VLAN がインストールされていない場合は、オブジェクトが返されません。 |
設定オブジェクトは、VLAN と直接関連付けられてはいません。CIM 標準に準拠して、設定オブジェクトは構成オブジェクトと関連付けられ、構成オブジェクトが VLAN の IANet_VLAN オブジェクトと関連付けられます。
スキーマのこの部分に関わるクラスは、IANet_VLAN、IANet_Configuration、IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection および IANetSettingSlider です。
関連クラスである IANet_VLANConfiguration と IANet_SettingContext には、実際のデータは含まれません。これらのクラスは、設定と親オブジェクトの橋渡しの役割を果たします。これは、アダプタ設定の場合と同じです。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| VLAN の構成オブジェクトの取得 | ASSOCIATORS OF { IANet VLAN のパス} WHERE ResultClass = IANet_Configuration | IANet_Configuration | 1 つのオブジェクトのみを返します。設定がない場合でも、常に構成オブジェクトは存在します。次のクエリでは、このオブジェクトからのオブジェクト パスが使用されます。 |
| VLAN に関連付けられている設定の取得 | ASSOCIATORS OF {IANet の構成パス} WHERE AssocClass = IANet_SettingContext | IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection、および IANet_SettingSlider が混在します。 | VLAN に関連付けられているすべての設定クラスを返します。クライアントで各設定のタイプを判定するには、__CLASS 属性を使用します。 |
アダプタ、VLAN、およびチームに関連付けられた IP プロトコル エンドポイントについて、Provider から限られた情報が提供されます。このほかのプロトコルはサポートされていません。
プロトコル情報を含む主なクラスは IANet_IPProtocolEndpoint です。関連クラスには、IANet_VLANProtocolDependency と IANet_AdapterProtocolImplementation の 2 つがあります。チームの IP エンドポイントを取得するには、まずチームの仮想 IANet_EthernetAdapter (このインスタンスに関連付けられた IP エンドポイント) を取得します。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| アダプタに関連付けられている IP プロトコル エンドポイントの取得 | ASSOCIATORS OF {IANet イーサネット アダプタのパス} WHERE ResultClass = IANet_IPProtocolEndpoint | IANet_IPProtocolEndpoint |
アダプタによっては複数の IP アドレスを持つものもありますが、これらのアドレスはすべて 1 つの IP プロトコル エンドポイントに関連付けられます。 |
| VLAN に関連付けられている IP プロトコル エンドポイントの取得 | ASSOCIATORS OF {IANet VLAN のパス} WHERE ResultClass = IANet_IPProtocolEndpoint | IANet_IPProtocolEndpoint | VLAN に関連付けられている IP プロトコル エンドポイントは 1 つです。 |
フラッシュ ROM の Boot Agent をサポートできる各アダプタには、関連クラス IANet_DeviceBootServiceImplementation を使用して、IANet_BootAgent インスタンスが関連付けられています。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| アダプタに関連付けられている Boot Agent の取得 | ASSOCIATORS OF {IANet イーサネット アダプタのパス} WHERE ResultClass = IANet_BootAgent | IANet_BootAgent | 次の読み取り専用の属性では、このアダプタの起動 ROM イメージの情報が提供されます。 InvalidImageSignature、Version、UpdateAvailable、FlashImageType |
設定オブジェクトは、Boot Agent と直接関連付けられてはいません。CIM 標準に準拠して、設定オブジェクトは構成オブジェクトと関連付けられ、構成オブジェクトが Boot Agent と関連付けられます。
スキーマのこの部分に関わるクラスは、IANet_BootAgent、IANet_Configuration、IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection および IANetSettingSlider です。
関連クラスである IANet_BootAgentConfiguration と IANet_SettingContext には、実際のデータは含まれません。これらのクラスは、設定と親オブジェクトの橋渡しの役割を果たします。
| タスク | WQL クエリ | 結果のクラス | 注釈 |
| Boot Agent の構成オブジェクトの取得 | ASSOCIATORS OF { IANet Boot Agent のパス} WHERE ResultClass = IANet_Configuration | IANet_Configuration | 1 つのオブジェクトのみを返します。設定がない場合でも、構成オブジェクトは常に存在します。次のクエリでは、このオブジェクトからのオブジェクト パスが使用されます。 |
| Boot Agent に関連付けられている設定の取得 | ASSOCIATORS OF {IANet の構成パス} WHERE AssocClass = IANet_SettingContext | IANet_SettingInt、IANet_SettingString、IANet_SettingEnum、IANet_SettingMultiSelection、および IANet_SettingSlider が混在します。 | アダプタに関連付けられているすべての設定クラスを返します。クライアントで各設定のタイプを判定するには、__CLASS 属性を使用します。 |
制限と免責条項をすべてお読みください。