CIM_NetworkAdapter 클래스

아티클
06/13/2023

CIM_NetworkAdapter 클래스는 일반적인 네트워킹 하드웨어 개념(예: 영구 주소 또는 작업 속도)을 정의하는 추상 클래스입니다. 정보는 CIM_DeviceSAPImplementation 연결을 사용하여 전달됩니다.

네트워크 어댑터 및 관련 엔드포인트는 피어 간의 연결 가능성을 나타냅니다. 연결 가능성은 master 또는 하위 및 컨트롤러 또는 CIM_Controller 제어되는 관계와 크게 다릅니다. 그러나 파이버 채널 어댑터가 컴퓨터 시스템의 SCSI 컨트롤러로 작동하는 경우와 같이 단일 디바이스가 네트워크 어댑터와 컨트롤러 역할을 하는 경우가 있습니다. 이 경우 디바이스의 측면은 네트워크 지향이고 다른 측면은 컨트롤러 지향입니다. 컨트롤러 및 어댑터 클래스를 인스턴스화해야 하며 디바이스의 다양한 측면을 연결하기 위해 디바이스 ID 관계도 만들어야 합니다.

중요

DMTF(분산 관리 태스크 포스) CIM(일반 정보 모델) 클래스는 WMI 클래스를 빌드하는 부모 클래스입니다. WMI는 현재 CIM 2.x 버전 스키마만 지원합니다.

MOF(Managed Object Format) 코드에서 간결하게 표기된 다음 구문은 상속된 속성을 모두 포함합니다. 속성은 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 클래스에는 이러한 메서드가 있습니다.

메서드	Description
다시 설정	논리 디바이스의 재설정을 요청합니다. 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)

테스트 중 (5)

해당 없음 (6)

전원 끄기 (7)

오프라인 (8)

오프 듀티 (9)

성능 저하됨 (10)

설치되지 않음 (11)

설치 오류 (12)

절전 - 알 수 없음 (13)

디바이스는 절전 모드인 것으로 알려져 있지만 정확한 상태 알 수 없습니다.

절전 - 저전력 모드 (14)

디바이스가 절전 상태이지만 여전히 작동 중이며 성능이 저하될 수 있습니다.

절전 - 대기 (15)

디바이스가 작동하지 않지만 신속하게 전원을 완전히 공급할 수 있습니다.

전원 주기 (16)

절전 - 경고 (17)

디바이스는 절전 모드에도 있지만 경고 상태입니다.

일시 중지됨 (18)

디바이스가 일시 중지되었습니다.

준비 안 됨 (19)

디바이스가 준비되지 않았습니다.

구성되지 않음 (20)

장치가 구성되지 않았습니다.

정지됨 (21)

장치가 조용합니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen (64), DisplayName ("Caption")

개체에 대한 간단한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

ConfigManagerErrorCode

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

Windows Configuration Manager 오류 코드입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

이 디바이스가 제대로 작동합니다. (0)

디바이스가 제대로 작동합니다.

이 디바이스가 올바르게 구성되지 않았습니다. (1)

디바이스가 올바르게 구성되지 않았습니다.

Windows에서 이 디바이스에 대한 드라이버를 로드할 수 없습니다. (2)

이 디바이스의 드라이버가 손상되었거나 시스템에서 메모리 또는 기타 리소스가 부족할 수 있습니다. (3)

이 디바이스의 드라이버가 손상되었거나 시스템이 메모리 또는 기타 리소스가 부족할 수 있습니다.

이 디바이스가 제대로 작동하지 않습니다. 드라이버 또는 레지스트리 중 하나가 손상되었을 수 있습니다. (4)

디바이스가 제대로 작동하지 않습니다. 드라이버 또는 레지스트리 중 하나가 손상되었을 수 있습니다.

이 디바이스의 드라이버에는 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

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

TRUE이면 디바이스가 사용자 정의 구성을 사용하고 있습니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

CreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: CIM_Key

instance 만드는 데 사용되는 클래스 또는 하위 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용할 경우 이 속성을 사용하면 클래스의 모든 인스턴스와 해당 서브클래스를 고유하게 식별할 수 있습니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("설명")

개체에 대한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

DeviceID

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: CIM_Key

논리 디바이스의 이름을 고유하게 지정하기 위한 주소 또는 기타 식별 정보입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

ErrorCleared

데이터 형식: boolean
액세스 형식: 읽기 전용

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
액세스 형식: 읽기 전용
한정자: 단위 ("초당 비트")

네트워크 어댑터의 최대 속도(BPS(초당 비트)입니다.

스크립트에서 uint64 값을 사용하는 방법에 대한 자세한 내용은 WMI 스크립트 만들기를 참조하세요.

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Name")

개체가 알려진 레이블입니다. 서브클래스를 사용하면 이 속성을 키 속성으로 재정의할 수 있습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

NetworkAddresses

데이터 형식: 문자열 배열
액세스 형식: 읽기 전용
한정자: MaxLen (64), MappingStrings ("MIF. DMTF| 네트워크 어댑터 802 포트|001.3")

어댑터의 네트워크 주소 목록입니다.

PermanentAddress

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (64), MappingStrings ("MIF. DMTF| 네트워크 어댑터 802 포트|001.2")

어댑터에 하드 코딩된 네트워크 주소입니다. 하드 코딩된 주소는 펌웨어 업그레이드 또는 소프트웨어 구성을 사용하여 변경할 수 있습니다. 변경된 경우 변경될 때 필드를 업데이트해야 합니다. 네트워크 어댑터에 대해 하드 코딩된 주소가 없는 경우 이 속성은 비워 두어야 합니다.

PNPDeviceID

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

Win32 플러그 앤 플레이 논리 디바이스의 디바이스 식별자입니다. 이 속성은 CIM_LogicalDevice 상속됩니다.

예: "*PNP030b"

PowerManagementCapabilities

데이터 형식: uint16 배열
액세스 형식: 읽기 전용

논리 디바이스의 특정 전원 관련 기능 배열입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

알 수 없음 (0)

지원되지 않음 (1)

사용 안 함 (2)

사용 (3)

전원 관리 기능은 현재 사용하도록 설정되어 있지만 정확한 기능 집합을 알 수 없거나 정보를 사용할 수 없습니다.

절전 모드가 자동으로 입력됨 (4)

디바이스는 사용량 또는 기타 기준에 따라 전원 상태를 변경할 수 있습니다.

전원 상태 설정 가능 (5)

SetPowerState 메서드가 지원됩니다. 이 메서드는 부모 CIM_LogicalDevice 클래스에서 찾을 수 있으며 구현할 수 있습니다. 자세한 내용은 MOF(Managed Object Format) 클래스 디자인을 참조하세요.

Power Cycling 지원 (6)

SetPowerState 메서드는 PowerState 매개 변수를 5(Power Cycle)로 설정하여 호출할 수 있습니다.

시간 제한 전원 켜기 지원 됨(7)

PowerState 메서드는 PowerState 매개 변수를 5(전원 주기)로 설정하고 Power-On의 경우 특정 날짜 및 시간 또는 간격으로 설정된 시간을 사용하여 호출할 수 있습니다.

PowerManagementSupported

데이터 형식: boolean
액세스 형식: 읽기 전용

TRUE인 경우 디바이스는 전원 관리, 즉 절전 상태로 전환될 수 있습니다. FALSE이면 정수 값 1("지원되지 않음")이 PowerManagementCapabilities 배열의 유일한 항목이어야 합니다.

이 속성은 전원 관리 기능이 현재 사용하도록 설정되어 있는지 또는 사용하도록 설정되어 있는지 여부를 나타내지 않습니다. 지원되는 기능은 없습니다. 자세한 내용은 PowerManagementCapabilities 배열을 참조하세요. 이 속성은 CIM_LogicalDevice 상속됩니다.

속도

데이터 형식: uint64
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIB. IETF| RFC1213-MIB.ifSpeed", "MIF. DMTF| 네트워크 어댑터 802 포트|001.5"), 단위 ("초당 비트")

현재 대역폭(BPS)의 추정치입니다. 대역폭이 다른 엔드포인트 또는 정확한 추정을 수행할 수 없는 엔드포인트의 경우 이 속성에는 명목 대역폭이 포함되어야 합니다.

스크립트에서 uint64 값을 사용하는 방법에 대한 자세한 내용은 WMI 스크립트 만들기를 참조하세요.

상태

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (10), DisplayName ("상태")

개체의 현재 상태.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

여기에는 다음 값이 포함됩니다.

OK ("OK")

오류 ("오류")

성능 저하됨 ("Degraded")

알 수 없음 ("알 수 없음")

사전 실패 ("사전 실패")

시작 중("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

StatusInfo

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 작동 상태|003.3")

논리 디바이스의 상태입니다. 이 속성이 논리 디바이스에 적용되지 않는 경우 값 5(해당 없음)를 사용해야 합니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

기타 (1)

알 수 없음 (2)

사용 (3)

사용 안 함 (4)

해당 없음 (5)

SystemCreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파됨 ("CIM_System. CreationClassName"), CIM_Key

범위 지정 시스템의 생성 클래스 이름입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

SystemName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파( "CIM_System. 이름"), 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_LogicalDevice

CIM_NetworkAdapter 클래스

구문

멤버

메서드

속성

설명

요구 사항

추가 정보

피드백

피드백

추가 리소스