CIM_NetworkAdapter クラス

[アーティクル]
06/03/2023

CIM_NetworkAdapter クラスは、一般的なネットワークハードウェアの概念 (永続的なアドレスや操作速度など) を定義する抽象クラスです。情報は、 CIM_DeviceSAPImplementation 関連付けを使用して伝達されます。

ネットワークアダプターと関連エンドポイントは、ピア間の接続の可能性を表します。接続の可能性は、マスター、下位、コントローラー、または CIM_Controllerの制御された関係とは大きく異なります。ただし、ファイバーチャネルアダプターがコンピューターシステムの SCSI コントローラーとして動作する場合など、1 つのデバイスがネットワークアダプターとコントローラーの両方として機能する場合があります。その場合、デバイスの側面はネットワーク指向であり、他の側面はコントローラー指向です。コントローラークラスとアダプタークラスをインスタンス化し、デバイスのさまざまな側面をリンクするためにデバイス ID リレーションシップも作成する必要があります。

重要

DMTF (分散管理タスクフォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョンスキーマのみがサポートされています。

次の構文は、マネージドオブジェクトフォーマット (MOF) コードを簡素化しており、継承されたすべてのプロパティを含んでいます。プロパティは、MOF の順序ではなく、アルファベット順に一覧表示されます。

構文

[Abstract, UUID("{8502C532-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_NetworkAdapter : CIM_LogicalDevice
{
  boolean  AutoSense;
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint64   MaxSpeed;
  string   Name;
  string   NetworkAddresses[];
  string   PermanentAddress;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint64   Speed;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

メンバー

CIM_NetworkAdapter クラスには、次の種類のメンバーがあります。

メソッド
プロパティ

メソッド

CIM_NetworkAdapter クラスには、これらのメソッドがあります。

メソッド	説明
リセット	論理デバイスのリセットを要求します。 WMI によって実装されていません。
SetPowerState	論理デバイスの目的の電源状態と、デバイスをその状態にする必要があるタイミングを定義します。 WMI によって実装されていません。

プロパティ

CIM_NetworkAdapter クラスには、これらのプロパティがあります。

AutoSense

データ型: boolean
アクセスの種類: 読み取り専用

TRUE の場合、ネットワークアダプターは、接続されているネットワークメディアの速度やその他の通信特性を自動的に決定できます。

可用性

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|運用状態|003.5"、"MIB。IETF|HOST-RESOURCES-MIB.hrDeviceStatus")

デバイスの可用性と状態。

このプロパティは 、CIM_LogicalDeviceから継承されます。

その他 (1)

不明 (2)

実行中/完全電源 (3)

警告 (4)

In Test (5)

該当なし (6)

電源オフ (7)

Off Line (8)

オフデューティ (9)

機能低下 (10)

インストールされていません (11)

インストールエラー (12)

省電力 - 不明 (13)

デバイスは省電力モードであることが知られていますが、正確な状態は不明です。

省電力 - 低電力モード (14)

デバイスは省電力状態ですが、引き続き機能しており、パフォーマンスが低下する可能性があります。

省電力 - スタンバイ (15)

デバイスは機能していませんが、すぐに完全な電力を供給できる可能性があります。

電源サイクル (16)

省電力 - 警告 (17)

デバイスは警告状態ですが、省電力モードでもあります。

一時停止 (18)

デバイスが一時停止しています。

準備ができていません (19)

デバイスの準備ができていません。

未構成 (20)

デバイスが構成されていません。

休止 ( 21)

デバイスは静かです。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの短いテキスト説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

ConfigManagerErrorCode

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")

Windows Configuration Managerエラーコード。

このプロパティは 、CIM_LogicalDeviceから継承されます。

このデバイスは正常に動作しています。 (0)

デバイスが正常に動作しています。

このデバイスが正しく構成されていません。 (1)

デバイスが正しく構成されていません。

Windows では、このデバイスのドライバーを読み込めません。 (2)

このデバイスのドライバーが破損しているか、システムがメモリやその他のリソースで不足している可能性があります。 (3)

このデバイスのドライバーが破損しているか、システムのメモリやその他のリソースが不足している可能性があります。

このデバイスは正常に動作していません。そのドライバーまたはレジストリの 1 つが破損している可能性があります。 (4)

デバイスが正しく動作していません。そのドライバーまたはレジストリの 1 つが破損している可能性があります。

このデバイスのドライバーには、Windows で管理できないリソースが必要です。 (5)

デバイスのドライバーには、Windows で管理できないリソースが必要です。

このデバイスのブート構成が他のデバイスと競合しています。 (6)

デバイスのブート構成が他のデバイスと競合しています。

フィルター処理できません。 (7)

デバイスのドライバーローダーがありません。 (8)

デバイスのドライバーローダーがありません。

制御ファームウェアがデバイスのリソースを誤って報告しているため、このデバイスは正常に動作していません。 (9)

デバイスが正しく動作していません。制御ファームウェアがデバイスのリソースを誤って報告しています。

このデバイスを起動できません。 (10)

デバイスを起動できません。

このデバイスは失敗しました。 (11)

デバイスに障害が発生しました。

このデバイスは、使用できる十分な空きリソースを見つけることができません。 (12)

デバイスで使用できる十分な空きリソースが見つかりません。

Windows では、このデバイスのリソースを確認できません。 (13)

Windows では、デバイスのリソースを確認できません。

コンピューターを再起動するまで、このデバイスは正常に動作しません。 (14)

コンピューターが再起動されるまで、デバイスは正常に動作しません。

再列挙の問題が発生している可能性があるため、このデバイスは正常に動作していません。 (15)

再列挙の問題が発生したため、デバイスが正常に動作していません。

Windows では、このデバイスが使用するすべてのリソースを識別することはできません。 (16)

Windows では、デバイスが使用するすべてのリソースを識別できません。

このデバイスは、不明なリソースの種類を要求しています。 (17)

デバイスが不明なリソースの種類を要求しています。

このデバイスのドライバーを再インストールします。 (18)

デバイスドライバーを再インストールする必要があります。

VxD ローダーの使用に失敗しました。 (19)

レジストリが破損している可能性があります。 (20)

レジストリが破損している可能性があります。

システムエラー: このデバイスのドライバーを変更してみてください。問題が解決しない場合は、ハードウェアのドキュメントを参照してください。Windows はこのデバイスを削除しています。 (21)

システム障害。デバイスドライバーを変更しても効果がない場合は、ハードウェアのドキュメントを参照してください。 Windows はデバイスを削除しています。

このデバイスは無効になっています。 (22)

デバイスが無効になっています。

システムエラー: このデバイスのドライバーを変更してみてください。それでも問題が解決しない場合は、ハードウェアのドキュメントを参照してください。 (23)

システム障害。デバイスドライバーを変更しても効果がない場合は、ハードウェアのドキュメントを参照してください。

このデバイスが存在しない、正しく動作していない、またはすべてのドライバーがインストールされていない。 (24)

デバイスが存在しない、正しく動作しない、またはすべてのドライバーがインストールされていない。

Windows は引き続きこのデバイスを設定しています。 (25)

Windows は引き続きデバイスを設定しています。

Windows は引き続きこのデバイスを設定しています。 (26)

Windows は引き続きデバイスを設定しています。

このデバイスには有効なログ構成がありません。 (27)

デバイスに有効なログ構成がありません。

このデバイスのドライバーはインストールされていません。 (28)

デバイスドライバーがインストールされていません。

デバイスのファームウェアで必要なリソースが提供されていないため、このデバイスは無効になっています。 (29)

デバイスが無効になっています。デバイスファームウェアが必要なリソースを提供しませんでした。

このデバイスは、別のデバイスが使用している割り込み要求 (IRQ) リソースを使用しています。 (30)

デバイスは、別のデバイスが使用している IRQ リソースを使用しています。

Windows はこのデバイスに必要なドライバーを読み込むことができないため、このデバイスは正常に動作していません。 (31)

デバイスが正しく動作していません。Windows では、必要なデバイスドライバーを読み込めません。

ConfigManagerUserConfig

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")

TRUE の場合、デバイスはユーザー定義の構成を使用します。

このプロパティは、 CIM_LogicalDeviceから継承されます。

CreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: CIM_Key

インスタンスの作成で使用されるクラスまたはサブクラスの名前。クラスの他のキープロパティと共に使用する場合、このプロパティを使用すると、クラスとそのサブクラスのすべてのインスタンスを一意に識別できます。

このプロパティは、 CIM_LogicalDeviceから継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Description")

オブジェクトのテキストの説明。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

DeviceID

データ型: string
アクセスの種類: 読み取り専用
修飾子: CIM_Key

論理デバイスに一意の名前を付けるアドレスまたはその他の識別情報。

このプロパティは、 CIM_LogicalDeviceから継承されます。

ErrorCleared

データ型: ブール値
アクセスの種類: 読み取り専用

TRUE の場合、LastErrorCode プロパティで報告されたエラーはクリアされます。

このプロパティは、 CIM_LogicalDeviceから継承されます。

ErrorDescription

データ型: string
アクセスの種類: 読み取り専用

LastErrorCode プロパティに記録されたエラーと実行する修正アクションに関する情報を提供する自由形式の文字列。

このプロパティは、 CIM_LogicalDeviceから継承されます。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされた日時。このプロパティには、オブジェクトがインストールされていることを示す値は必要ありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

LastErrorCode

データ型: uint32
アクセスの種類: 読み取り専用

論理デバイスによって報告された最後のエラーコード。

このプロパティは、 CIM_LogicalDeviceから継承されます。

MaxSpeed

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: 単位 ("bits/second")

ネットワークアダプターの最大速度 (ビット/秒 (BPS)。

スクリプトでの uint64 値の使用の詳細については、「 WMI でのスクリプト作成」を参照してください。

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Name")

オブジェクトが認識されるラベル。サブクラス化すると、このプロパティをキープロパティとしてオーバーライドできます。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

NetworkAddresses

データ型: 文字列 配列
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 MappingStrings ("MIF。DMTF|ネットワークアダプター 802 ポート|001.3")

アダプターのネットワークアドレスの一覧。

PermanentAddress

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 MappingStrings ("MIF。DMTF|ネットワークアダプター 802 ポート|001.2")

アダプターにハードコーディングされたネットワークアドレス。ハードコーディングされたアドレスは、ファームウェアのアップグレードまたはソフトウェア構成を使用して変更できます。変更された場合は、変更時にフィールドを更新する必要があります。ネットワークアダプターにハードコーディングされたアドレスが存在しない場合は、このプロパティを空白のままにする必要があります。

PNPDeviceID

データ型: string
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")

Win32 プラグアンドプレイ論理デバイスのデバイス識別子です。このプロパティは、 CIM_LogicalDeviceから継承されます。

例: "*PNP030b"

PowerManagementCapabilities

データ型: uint16 配列
アクセスの種類: 読み取り専用

論理デバイスの特定の電源関連機能の配列。

このプロパティは、 CIM_LogicalDeviceから継承されます。

不明 (0)

サポートされていません (1)

無効 (2)

有効 (3)

電源管理機能は現在有効になっていますが、正確な機能セットが不明であるか、情報が使用できません。

自動的に入力された省電力モード (4)

デバイスは、使用状況やその他の条件に基づいて電源状態を変更できます。

電源状態設定可能 (5)

SetPowerState メソッドがサポートされています。このメソッドは親 CIM_LogicalDevice クラスで見つかり、実装できます。詳細については、「マネージドオブジェクト形式 (MOF) クラスの設計」を参照してください。

電源循環がサポートされています (6)

SetPowerState メソッドは、PowerState パラメーターを 5 (Power Cycle) に設定して呼び出すことができます。

時間指定の電源オンがサポートされています (7)

SetPowerState メソッドは、PowerState パラメーターを 5 (Power Cycle) に設定し、Time を特定の日付と時刻または間隔に設定して電源をオンにして呼び出すことができます。

PowerManagementSupported

データ型: ブール値
アクセスの種類: 読み取り専用

TRUE の場合、デバイスを電源管理できます。つまり、省電力状態になります。 FALSE の場合、PowerManagementCapabilities 配列の唯一のエントリは整数値 1 ("サポートされていません") である必要があります。

このプロパティは、電源管理機能が現在有効になっているか、有効になっているか、どの機能がサポートされているかを示しません。詳細については、「 PowerManagementCapabilities 配列」を参照してください。このプロパティは、 CIM_LogicalDeviceから継承されます。

速度

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIB.IETF|RFC1213-MIB.ifSpeed", "MIF.DMTF|ネットワークアダプター 802 ポート|001.5") 、単位 ("ビット/秒")

BPS での現在の帯域幅の見積もり。帯域幅が異なるエンドポイントの場合、または正確な推定ができないエンドポイントの場合、このプロパティには公称帯域幅を含める必要があります。

スクリプトでの uint64 値の使用の詳細については、「 WMI でのスクリプト作成」を参照してください。

状態

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

StatusInfo

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|運用状態|003.3")

論理デバイスの状態。このプロパティが論理デバイスに適用されない場合は、値 5 (該当なし) を使用する必要があります。

このプロパティは、 CIM_LogicalDeviceから継承されます。

その他 (1)

不明 (2)

有効 (3)

無効 (4)

適用なし (5)

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_System。CreationClassName") )、CIM_Key

スコーピングシステムの作成クラス名。

このプロパティは 、CIM_LogicalDeviceから継承されます。

Systemname

データ型: string
アクセスの種類: 読み取り専用
修飾子: 伝達 ( "CIM_System。Name") )、CIM_Key

スコープシステムの名前。

このプロパティは 、CIM_LogicalDeviceから継承されます。

解説

CIM_NetworkAdapter クラスは、CIM_LogicalDeviceから派生します。

WMI では、このクラスは実装されません。 CIM_NetworkAdapterから派生したクラスについては、「Win32 クラス」を参照してください。

このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

次の方法で共有

CIM_NetworkAdapter クラス

構文

メンバー

メソッド

プロパティ

解説

要件

関連項目

フィードバック

その他のリソース