Win32_PnPEntity 클래스
Win32_PnPEntityWMI 클래스는 플러그 앤 플레이 디바이스의 속성을 나타냅니다. 플러그 앤 플레이 엔터티는 제어판 있는 장치 관리자 항목으로 표시됩니다.
다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.
구문
[Dynamic, Provider("CIMWin32"), UUID("{FE28FD98-C875-11d2-B352-00104BC97924}"), AMENDMENT]
class Win32_PnPEntity : CIM_LogicalDevice
{
uint16 Availability;
string Caption;
string ClassGuid;
string CompatibleID[];
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
string HardwareID[];
datetime InstallDate;
uint32 LastErrorCode;
string Manufacturer;
string Name;
string PNPClass;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
boolean Present;
string Service;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
};
멤버
Win32_PnPEntity 클래스에는 다음과 같은 형식의 멤버가 있습니다.
메서드
Win32_PnPEntity 클래스에는 이러한 메서드가 있습니다.
메서드 | 설명 |
---|---|
사용 안 함 | 이 플러그 앤 플레이 디바이스를 사용하지 않도록 설정합니다. |
사용 | 이 플러그 앤 플레이 디바이스를 사용하도록 설정합니다. |
GetDeviceProperties | 이 플러그 앤 플레이 디바이스의 지정된 속성을 가져옵니다. |
재설정 | 구현되지 않았습니다. 이 메서드를 구현하려면 CIM_LogicalDevice Reset 메서드를 참조하세요. |
SetPowerState | 구현되지 않았습니다. 이 메서드를 구현하려면 CIM_LogicalDevice SetPowerState 메서드를 참조하세요. |
속성
Win32_PnPEntity 클래스에는 이러한 속성이 있습니다.
-
가용성
-
-
데이터 형식: 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 상속됩니다.
ClassGuid
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("WMI")
이 플러그 앤 플레이 디바이스의 GUID(Globally Unique Identifier)입니다.
CompatibleID
-
데이터 형식: 문자열 배열
-
액세스 형식: 읽기 전용
설치 프로그램에서 디바이스를 INF 파일과 일치시키는 데 사용하는 공급업체 정의 ID 문자열입니다. 디바이스에는 연결된 호환 ID 목록이 있을 수 있습니다. 호환되는 ID는 적합성을 줄이는 순서대로 나열되어야 합니다. 설치 프로그램에서 디바이스의 하드웨어 ID 중 하나와 일치하는 INF 파일을 찾을 수 없는 경우 호환 ID를 사용하여 INF 파일을 찾습니다. 호환되는 ID는 HardwareID와 동일한 형식입니다. 자세한 내용은 Windows 드라이버 키트를 참조 하세요.
ConfigManagerErrorCode
-
데이터 형식: uint32
-
액세스 형식: 읽기 전용
-
한정자: 스키마 ("Win32")
Win32 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
인스턴스를 만드는 데 사용되는 상속 체인에 표시할 첫 번째 구체적인 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용하면 이 클래스의 모든 인스턴스와 해당 서브클래스를 고유하게 식별할 수 있습니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
설명
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: DisplayName ("Description")
개체에 대한 설명입니다.
이 속성은 CIM_ManagedSystemElement 상속됩니다.
DeviceID
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: 키, 재정의("DeviceId"), MappingStrings("WMI")
플러그 앤 플레이 디바이스의 식별자입니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
ErrorCleared
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
TRUE이면 LastErrorCode에 보고된 오류가 이제 지워집니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
ErrorDescription
-
데이터 형식: string
-
액세스 형식: 읽기 전용
LastErrorCode에 기록된 오류에 대한 자세한 내용 및 수행할 수 있는 모든 수정 작업에 대한 정보입니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
HardwareID
-
데이터 형식: 문자열 배열
-
액세스 형식: 읽기 전용
설치 프로그램에서 디바이스를 INF 파일과 일치시키는 데 사용하는 공급업체 정의 ID 문자열입니다. 일반적으로 디바이스에는 연결된 하드웨어 ID 목록이 있습니다. 예외는 하드웨어 ID를 사용하지 않는 1394 버스 드라이버입니다. 목록의 첫 번째 하드웨어 ID는 디바이스 ID여야 합니다. 다시 기본 ID는 적합성을 줄이는 순서대로 나열되어야 합니다.
하드웨어 ID는 다음 형식으로 표시됩니다.
enumerator\enumerator-specific-device-ID
이는 개별 PnP 디바이스에 가장 일반적인 형식입니다. 열거자의 예는 BIOS 또는 ISAPNP입니다.
*열거자별 ID
별표(*)는 둘 이상의 열거자가 사용했음을 나타냅니다.
디바이스 클래스별 ID
사용자 지정 형식입니다.
하드웨어 ID의 예는 다음과 같습니다.
- root\\\\*PNPOF08
- PC\\VEN\_1000&DEV\_001&SUBSYS\_00000000&REV\_02
자세한 내용은 Windows 드라이버 키트를 참조하세요.
InstallDate
-
데이터 형식: datetime
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("MIF. DMTF|ComponentID|001.5"), DisplayName ("설치 날짜")
개체가 설치된 날짜 및 시간입니다. 이 속성은 개체가 설치되었음을 나타내는 값이 필요하지 않습니다.
이 속성은 CIM_ManagedSystemElement 상속됩니다.
LastErrorCode
-
데이터 형식: uint32
-
액세스 형식: 읽기 전용
논리 디바이스에서 보고한 마지막 오류 코드입니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
제조업체
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("WMI")
플러그 앤 플레이 디바이스 제조업체의 이름입니다.
예: "Acme"
이름
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: DisplayName ("Name")
개체가 알려진 레이블입니다. 서브클래스를 사용하면 속성을 키 속성으로 재정의할 수 있습니다.
이 속성은 CIM_ManagedSystemElement 상속됩니다.
PNPClass
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("WMI")
Warning
이 속성은 MOF 파일에 나열되어 있음에도 불구하고 실제로 클래스에 존재하지 않습니다. 이 속성은 완전성을 위해서만 여기에 설명되어 있으며 MOF 파일 자체를 명확하게 설명합니다.
이 플러그 앤 플레이 디바이스 형식의 이름입니다.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 및 Windows Vista: 이 속성은 MOF 파일에 없습니다.
PNPDeviceID
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: 스키마 ("Win32")
논리 디바이스의 Windows 플러그 앤 플레이 디바이스 식별자입니다.
이 속성은 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)
SetPowerState 메서드는 PowerState 매개 변수를 5로 설정하고("Power Cycle") 시간 매개 변수를 특정 날짜 및 시간 또는 간격으로 설정하여 호출할 수 있습니다.
PowerManagementSupported
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
구현되지 않았습니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
있음
-
데이터 형식: boolean
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("WMI")
이 플러그 앤 플레이 디바이스가 현재 시스템에 있는지 여부입니다.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 및 Windows Vista: 이 속성은 지원되지 않습니다.
서비스
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("WMI")
이 플러그 앤 플레이 디바이스를 지원하는 서비스의 이름입니다. 자세한 내용은 Win32_SystemDriverPnPEntity 참조하세요.
예: "atapi"
상태
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: MaxLen(10), DisplayName("Status")
개체의 현재 상태. 다양한 운영 및 비 운용 상태 정의할 수 있습니다. 작동 상태 "OK", "Degraded" 및 "Pred Fail"(SMART 지원 하드 디스크 드라이브와 같은 요소가 제대로 작동하지만 가까운 장래에 오류를 예측할 수 있음)이 포함됩니다. 비 운용성 상태에는 "오류", "시작 중", "중지" 및 "서비스"가 포함됩니다. 후자의 "서비스"는 디스크를 다시 미러, 사용자 권한 목록의 다시 로드 또는 기타 관리 작업 중에 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나도 아닙니다.
이 속성은 CIM_ManagedSystemElement 상속됩니다.
여기에는 다음 값이 포함됩니다.
확인 ("확인")
오류 ("오류")
성능이 저하됨 ("Degraded")
알 수 없음 ("알 수 없음")
사전 실패 ("사전 실패")
시작 ("시작")
중지 ("중지")
서비스 ("서비스")
스트레스("스트레스")
NonRecover ("NonRecover")
연락처 없음("연락처 없음")
로스트 커밋 ("로스트 커밋")
StatusInfo
-
데이터 형식: uint16
-
액세스 형식: 읽기 전용
-
한정자: MappingStrings ("MIF. DMTF|작동 상태|003.3")
논리 디바이스의 상태입니다. 이 속성이 논리 디바이스에 적용되지 않는 경우 값 5(해당 없음)를 사용해야 합니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
기타 (1)
알 수 없음 (2)
사용(3)
사용 안 함 (4)
해당 없음 (5)
SystemCreationClassName
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: 전파됨("CIM_System.CreationClassName"), CIM_Key
범위 지정 컴퓨터 의 CreationClassName 속성 값입니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
SystemName
-
데이터 형식: 문자열
-
액세스 형식: 읽기 전용
-
한정자: 전파됨("CIM_System.이름"), CIM_Key
범위 지정 시스템의 이름입니다.
이 속성은 CIM_LogicalDevice 상속됩니다.
설명
Win32_PnPEntity 클래스는 CIM_LogicalDevice 파생됩니다.
예제
다음 VBScript 코드 예제에서는 원격 컴퓨터 이름 배열을 만든 다음 각 컴퓨터에 플러그 앤 플레이 디바이스의 이름(Win32_PnPEntity 인스턴스)을 표시하여, 동일한 도메인에 있는 원격 컴퓨터 그룹에 연결합니다.
On Error Resume Next
arrComputers = Array("Computer1","Computer2","Computer3")
For Each strComputer In arrComputers
WScript.Echo
WScript.Echo "===================================="
WScript.Echo "Computer: "& strComputer
WScript.Echo "===================================="
Set objWMIService = GetObject("winmgmts:\\" _
& strComputer& "\root\CIMV2")
Set colItems = objWMIService.ExecQuery( _
"SELECT * FROM Win32_PnPEntity",,48)
For Each objItem in colItems
Wscript.Echo "-----------------------------------"
Wscript.Echo "Win32_PnPEntity instance"
Wscript.Echo "-----------------------------------"
Wscript.Echo "Name: "& objItem.Name
Wscript.Echo "Status: "& objItem.Status
Next
Next
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows Vista |
지원되는 최소 서버 |
Windows Server 2008 |
네임스페이스 |
Root\CIMV2 |
MOF |
|
DLL |
|
참고 항목