Win32_WMISetting 클래스

  • 아티클

Win32_WMISetting 싱글톤 WMI 클래스에는 WMI 서비스에 대한 작업 매개 변수가 포함되어 있습니다. 이 클래스에는 각 Windows 시스템에 대해 항상 존재하며 삭제할 수 없는 인스턴스가 하나만 있을 수 있습니다. 추가 인스턴스를 만들 수 없습니다.

MOF(Managed Object Format) 코드에서 간결하게 표기된 다음 구문은 상속된 속성을 모두 포함합니다. 속성 및 메서드는 MOF 순서가 아닌 알파벳순입니다.

구문

[Singleton, Dynamic, Provider("WBEMCORE"), UUID("{A83EF166-CA8D-11d2-B33D-00104BCC4B4A}"), AMENDMENT]
class Win32_WMISetting : CIM_Setting
{
  string   Caption;
  string   Description;
  string   SettingID;
  string   ASPScriptDefaultNamespace = "\\\\root\\cimv2";
  boolean  ASPScriptEnabled;
  string   AutorecoverMofs[];
  uint32   AutoStartWin9X;
  uint32   BackupInterval;
  datetime BackupLastTime;
  string   BuildVersion;
  string   DatabaseDirectory;
  uint32   DatabaseMaxSize;
  boolean  EnableAnonWin9xConnections;
  boolean  EnableEvents;
  boolean  EnableStartupHeapPreallocation;
  uint32   HighThresholdOnClientObjects;
  uint32   HighThresholdOnEvents;
  string   InstallationDirectory;
  uint32   LastStartupHeapPreallocation;
  string   LoggingDirectory;
  uint32   LoggingLevel;
  uint32   LowThresholdOnClientObjects;
  uint32   LowThresholdOnEvents;
  uint32   MaxLogFileSize;
  uint32   MaxWaitOnClientObjects;
  uint32   MaxWaitOnEvents;
  string   MofSelfInstallDirectory;
};

멤버

Win32_WMISetting 클래스에는 다음과 같은 형식의 멤버가 있습니다.

속성

Win32_WMISetting 클래스에는 이러한 속성이 있습니다.

ASPScriptDefaultNamespace

데이터 형식: 문자열

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|기본 네임스페이스")

기본 스크립트 네임스페이스입니다. 이 속성은 호출자가 지정하지 않은 경우 WMI용 Scripting API의 호출에 사용되는 네임스페이스를 포함합니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM\    스크립팅|기본 네임스페이스

예: root\cimv2

이 속성을 사용하는 예제 스크립트는 설명 섹션을 참조하세요.

ASPScriptEnabled

데이터 형식: boolean

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|ASP에 사용")

True이면 ASP(Active Server Pages)에서 WMI 스크립팅을 사용할 수 있습니다. 이 속성은 지원되지 않는 버전의 Windows만 실행하는 시스템에서 유효합니다. 지원되는 Windows 시스템의 경우 WMI 스크립팅은 항상 ASP에서 허용됩니다.

AutorecoverMofs

데이터 형식: 문자열 배열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|MOF 자동 복구")

WMI 리포지토리를 초기화하거나 복구하는 데 사용되는 정규화된 MOF 파일 이름 목록입니다. 목록에는 MOF 파일이 컴파일되는 순서가 결정됩니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|MOF 자동 복구

AutoStartWin9X

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|AutostartWin9X")

지원되지 않습니다.

시작 안 함(0)

자동 시작 (1)

다시 부팅 시 시작(2)

BackupInterval

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|백업 간격 임계값"), 단위 ("분")

지원되지 않습니다. 대신 WMI 리포지토리를 수동으로 백업합니다.

BackupLastTime

데이터 형식: datetime

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32API|시간 함수|GetTimeZoneInformation")

마지막 백업이 수행된 날짜 및 시간입니다.

BuildVersion

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|빌드")

현재 설치된 WMI 서비스에 대한 버전 정보입니다.

WMI 데이터베이스의 백업 간에 경과되는 시간입니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|빌드

캡션

데이터 형식: string

액세스 형식: 읽기 전용

한정자: MaxLen(64)

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

이 속성은 CIM_Setting 상속됩니다.

DatabaseDirectory

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|리포지토리 디렉터리")

WMI 리포지토리를 포함하는 디렉터리 경로입니다.

DatabaseMaxSize

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|최대 DB 크기"), 단위 ("킬로바이트")

WMI 리포지토리의 최대 크기입니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

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

이 속성은 CIM_Setting 상속됩니다.

EnableAnonWin9x커넥트ions

데이터 형식: boolean

액세스 형식: 읽기/쓰기

한정자: MappingStrings("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableAnon커넥트ions")

지원되지 않습니다.

EnableEvents

데이터 형식: boolean

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableEvents")

True이면 WMI 이벤트 하위 시스템을 사용하도록 설정해야 합니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|CIMOM|EnableEvents

EnableStartupHeapPreallocation

데이터 형식: boolean

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableStartupHeapPreallocation")

True이면 WMI가 초기화될 때 WMI가 LastStartupHeapPreallocation 값의 크기로 미리 할당된 힙을 만듭니다.

HighThresholdOnClientObjects

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|클라이언트 개체의 높은 임계값"), 단위 ("초당 개체 수")

공급자가 만든 개체를 클라이언트에 배달할 수 있는 최대 속도입니다. 공급자와 클라이언트 간의 속도 차등을 수용하기 위해 WMI는 소비자에게 전달하기 전에 개체를 큐에 보관합니다. 효율성을 높이기 위해 소비자는 공급자와 일치하는 속도로 개체를 수집해야 합니다. 데이터 정렬되지 않은 개체가 보유한 메모리가 LowThresholdOnObjects에 도달하면 WMI에서 새 개체를 큐에 추가하는 속도가 느려집니다. 수집되지 않은 이벤트가 계속 누적되고 사용된 메모리가 HighThresholdOnClientObjects의 값에 있는 동안 MaxWaitOnClientObjects에서 이벤트를 배달하기 위한 최대 대기에 도달하면 WMI는 공급자의 개체를 더 이상 허용하지 않고 클라이언트에 WBEM_E_OUT_OF_MEMORY 반환합니다.

HighThresholdOnEvents

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|이벤트에 대한 높은 임계값"), 단위 ("초당 이벤트 수")

클라이언트에 이벤트를 배달할 최대 속도입니다. 공급자와 클라이언트 간의 속도 차등을 수용하기 위해 WMI는 이벤트를 소비자에게 전달하기 전에 큐에 넣습니다. 효율성을 높이기 위해 소비자는 공급자와 일치하는 속도로 이벤트를 수집해야 합니다. 수집되지 않은 이벤트에 의해 유지되는 메모리가 LowThresholdOnObjects에 도달하면 WMI는 새 이벤트를 큐에 추가하는 속도를 늦추게 됩니다. 사용된 메모리가 HighThresholdOnEvents의 값에 있는 동안 수집되지 않은 이벤트가 계속 누적되고 MaxWaitOnEvents에서 이벤트를 배달하기 위한 최대 대기에 도달하면 WMI는 공급자의 더 이상 이벤트를 수락하지 않고 클라이언트에 WBEM_E_OUT_OF_MEMORY 반환합니다.

참고 항목

제한은 영구 이벤트 소비자에 대해서만 수행되므로 이벤트가 WMI 내부 이벤트 큐에서 백업될 때 임시 소비자는 제한을 기대하지 않아야 합니다.

 

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|클라이언트 개체의 높은 임계값(B)

InstallationDirectory

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|설치 디렉터리")

WMI 소프트웨어가 설치된 디렉터리 경로입니다. 기본 위치는 \System32\Wbem입니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|설치 디렉터리

LastStartupHeapPreallocation

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|LastStartupHeapPreallocation"), 단위 ("바이트")

초기화 중에 WMI에서 만든 미리 할당된 힙의 크기입니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|CIMOM|LastStartupHeapPreallocation

LoggingDirectory

데이터 형식: 문자열

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|로깅 디렉터리")

WMI 시스템 로그 파일의 위치를 포함하는 디렉터리 경로입니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|CIMOM|로깅 디렉터리

LoggingLevel

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|로깅")

이벤트 로깅 및 사용된 로깅의 세부 정보 수준을 사용하도록 설정합니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|CIMOM|로깅

Off (0)

오류 로깅 (1)

자세한 정보 표시 오류 로깅 (2)

LowThresholdOnClientObjects

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|클라이언트 개체의 낮은 임계값"), 단위 ("초당 개체 수")

WMI가 클라이언트에 대해 만들어진 새 개체의 생성 속도를 늦추기 시작하는 속도입니다. 공급자와 클라이언트 간의 속도 차등을 수용하기 위해 WMI는 소비자에게 전달하기 전에 개체를 큐에 보관합니다. 효율성을 높이기 위해 소비자는 공급자와 일치하는 속도로 개체를 수집해야 합니다. 개체에 대한 요청 속도가 LowThresholdOnClientObjects에 도달하면 WMI는 클라이언트의 사용률에 맞게 새 개체를 만드는 속도가 점차 느려집니다. 이 속도 저하는 개체를 만드는 속도가 이 속성의 값을 초과할 때 시작됩니다. HighThresholdOnClientObjects를 참조 하세요.

이 속성은 레지스트리 값을 반영합니다.

\KEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|클라이언트 개체의 높은 임계값(B)

LowThresholdOnEvents

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|낮은 이벤트 임계값"), 단위 ("초당 이벤트 수")

WMI가 새 이벤트 배달 속도를 늦추기 시작하는 속도입니다. 공급자와 클라이언트 간의 속도 차등을 수용하기 위해 WMI는 이벤트를 소비자에게 전달하기 전에 큐에 넣습니다. 효율성을 높이기 위해 소비자는 공급자와 일치하는 속도로 개체를 수집해야 합니다. 큐가 제어할 수 없는 경우 WMI 제한은 느려지고 클라이언트 속도에 맞게 이벤트를 점진적으로 배달합니다. 이 속도 저하는 이벤트가 생성되는 속도가 이 속성의 값을 초과할 때 시작됩니다. HighThresholdOnEvents를 참조 하세요.

참고 항목

제한은 영구 이벤트 소비자에 대해서만 수행되므로 이벤트가 WMI 내부 이벤트 큐에 백업될 때 임시 소비자는 제한을 기대하지 않아야 합니다.

 

이 속성은 레지스트리 값을 반영합니다.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|클라이언트 개체 {B}의 높은 임계값

MaxLogFileSize

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|로그 파일 최대 크기"), 단위 ("바이트")

WMI 서비스에서 생성된 로그 파일의 최대 크기입니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|CIMOM|로그 파일 최대 크기

MaxWaitOnClientObjects

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|최대 이벤트 대기 시간"), 단위 ("밀리초")

새로 만든 개체가 디스카드 및 오류 값이 반환되기 전에 클라이언트에서 사용할 때까지 대기하는 시간입니다. 이 속성은 LowThresholdOnClientObjects 및 HighThresholdOnClientObjects 속성과 상호 작용하여 소비자가 개체를 너무 느리게 수신할 때 소비자에게 개체를 전달하는 것을 제한합니다.

MaxWaitOnEvents

데이터 형식: uint32

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|최대 이벤트 대기 시간"), 단위 ("밀리초")

디스카드 전에 클라이언트로 전송된 이벤트가 큐에 대기되는 시간입니다. 이 속성은 LowThresholdOnEvents 및 HighThresholdOnEvents와 상호 작용하여 소비자가 개체를 너무 느리게 수신할 때 소비자에게 개체를 배달하는 것을 제한합니다.

이 속성은 레지스트리 값을 반영합니다.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|최대 이벤트 대기(ms)

MofSelfInstallDirectory

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|MOF 자체 설치 디렉터리")

WMI 리포지토리에 MOF 파일을 설치하는 애플리케이션의 디렉터리 경로입니다. WMI는 이 디렉터리에 배치된 모든 MOF 파일을 자동으로 컴파일하고 성공에 따라 MOF를 양수 또는 불량 레이블이 지정된 하위 디렉터리로 이동합니다. # pragma 자동 복구 명령이 포함된 경우 WMI가 리포지토리를 초기화하거나 복구할 때 사용되는 AutorecoverMofs 목록에 정규화된 파일 이름이 추가됩니다. 목록은 MOF가 컴파일되는 순서를 결정합니다.

이 속성은 레지스트리 키의 값을 반영합니다.

\HKEY_LOCAL_MACHINE 소프트웨어\Microsoft\WBEM|CIMOM|MOF Self=Install Directory

SettingID

데이터 형식: string

액세스 형식: 읽기 전용

한정자: MaxLen(256)

현재 개체가 알려진 식별자입니다.

이 속성은 CIM_Setting 상속됩니다.

설명

Win32_WMISetting 클래스는 CIM_Setting 파생됩니다. 이 클래스의 인스턴스는 컴퓨터에 하나만 있을 수 있습니다.

스크립트를 디버깅하거나 WMI 서비스 자체의 문제를 해결할 때 컴퓨터에서 WMI를 구성하는 방법을 아는 것이 매우 유용할 수 있습니다. 예를 들어 많은 WMI 스크립트는 root\cimv2가 대상 컴퓨터의 기본 네임스페이스라는 가정 하에 작성됩니다. 따라서 다음 코드 샘플과 같이 "Root\CIMv2"의 클래스에 액세스해야 하는 스크립트 작성기는 GetObject 모니커에 네임스페이스를 포함하지 못하는 경우가 많습니다.

Set colServices = GetObject("winmgmts:").ExecQuery ("SELECT * FROM Win32_Service")

root\cimv2가 대상 컴퓨터의 기본 네임스페이스가 아니면 이 스크립트가 실패합니다. 이러한 일이 발생하지 않도록 하려면 다음 코드 샘플과 같이 네임스페이스 root\cimv2를 모니커에 포함해야 합니다.

Set colServices = GetObject("winmgmts:root\cimv2").ExecQuery("SELECT * FROM Win32_Service")

대상 컴퓨터의 기본 네임스페이스가 스크립트에서 가정한 네임스페이스와 다른 경우 스크립트가 실패합니다. 그 위에 사용자에게 "잘못된 클래스"라는 다소 오해의 소지가 있는 오류 메시지가 표시됩니다. 사실 실패는 클래스가 잘못되었기 때문이 아니라 기본 네임스페이스에서 클래스를 찾을 수 없기 때문입니다. 지정된 네임스페이스(또는 이 경우에는 그렇지 않음)에 문제가 있는 것이 아니라 클래스의 가능한 문제를 조사할 가능성이 높기 때문에 이 문제를 해결하기 어려운 문제입니다.

Win32_WMISetting 클래스를 사용하여 컴퓨터에서 WMI가 구성된 방법을 확인할 수 있습니다. 기본 네임스페이스 또는 WMI 빌드 번호와 같은 구성 세부 정보는 스크립트 문제 해결에 유용할 수 있습니다. 또한 이러한 설정은 WMI 오류가 컴퓨터에 기록되는 방법 또는 여부와 WMI 리포지토리를 다시 빌드해야 하는 경우 자동으로 다시 로드되는 WMI 공급자와 같은 중요한 관리 정보를 제공합니다.

예제

다음 VBScript 코드 예제에서는 로컬 컴퓨터에서 실행 중인 WMI의 버전을 가져오는 방법을 보여줍니다. "Win32_WMISetting=@"는 클래스의 단일 인스턴스를 나타냅니다. 자세한 내용은 WMI 버전을 참조하세요.

set objWMIService = GetObject("winmgmts:{impersonationLevel=Impersonate}!/Root/CIMv2")

set objWMISetting = objWMIService.Get("Win32_WMISetting=@")

WScript.Echo  objWMISetting.BuildVersion

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
네임스페이스
 Root\CIMV2
MOF
CIMWin32.mof
DLL
Wbemcore.dll

참고 항목

CIM_Setting

WMI 서비스 관리 클래스