WMI.NET 공급자 확장을 사용하여 결합된 WMI 공급자 작성 2.0
WMI.NET 공급자 확장을 사용하여 결합된 WMI 공급자 작성 2.0
가브리엘 기즐라
Microsoft Corporation
2008년 1월
요약: .NET Framework 3.5에 제공된 WMI.NET 공급자 확장 2.0을 사용하여 결합된 WMI 공급자를 작성하는 방법에 대해 자세히 설명합니다.
콘텐츠
소개
간단한 .NET 클래스
어셈블리 수준 특성
클래스 수준 WMI.NET 특성
런타임 요구 사항
WMI를 사용하여 등록
상속을 통해 클래스 확장
메서드 구현
예외 및 오류 보고
기타 팁
결론
목록 1 – SCMInterop.cs
목록 2 – WIN32ServiceHost.cs
소개
WMI(Windows Management Instrumentation)는 Windows 및 Windows 애플리케이션을 관리하는 데 널리 사용되는 인프라입니다. 시스템 관리자 및 관리 애플리케이션에서 매우 확장 가능하고 인기가 있음에도 불구하고 많은 개발자는 구현해야 하는 네이티브 인터페이스의 복잡성으로 인해 WMI 공급자를 작성하는 것에 대해 생각할 수 있습니다.
.NET Framework 초기 버전에는 WMI 공급자를 구현하기 위한 개체 및 패턴 집합이 함께 제공되었지만 애플리케이션 관리로 제한되었지만 메서드를 정의할 수 없었고 인스턴스의 키가 자동으로 생성되었습니다. WMI.NET 공급자 확장 v2(WMI.NET)는 전체 WMI 공급자 기능을 구현할 수 있는 Orcas(.NET Framework 3.5)의 새로운 인프라입니다. 이 새로운 인프라는 이전 버전의 WMI.NET 공급자 모델과 공존하지만 훨씬 더 강력하고 확장 가능합니다.
이 문서의 초점은 WMI.NET 가장 중요한 기능 중 하나인 WMI 결합 공급자를 작성하는 방법입니다. 문서가 WMI.NET 사용하여 모든 종류의 WMI 공급자를 작성하려고 하는 독자에게 좋은 시작을 제공할 수 있도록 분리된 공급자를 작성하는 방식에는 큰 차이가 없습니다. 이 문서에서는 간단한 .NET 클래스에서 시작하여 결합된 WMI 공급자를 만든 다음 몇 가지 추가 기능으로 보강하는 방법을 보여줍니다. 목표는 Windows 서비스를 호스팅하는 프로세스를 열거하고 이러한 각 프로세스에서 Windows 서비스를 열거하고 이 기능을 WMI에 통합할 수 있도록 하는 것입니다.
간단한 .NET 클래스
먼저 Windows 서비스를 호스팅하는 프로세스를 모델링하는 C# 클래스를 만듭니다. 각 instance 연결된 프로세스에서 호스트된 서비스 목록을 표시합니다. 클래스에는 시스템에서 실행되는 서비스 호스트에 연결된 모든 인스턴스를 반환하는 정적 메서드가 있습니다.
public 클래스 WIN32ServiceHost
{
클래스는 Process 클래스에 대한 래퍼입니다. innerProcess 필드는 Process 개체에 대한 참조를 저장합니다.
innerProcess 처리;
클래스에는 프로세스 개체를 매개 변수로 허용하는 하나의 생성자가 있습니다.
public WIN32ServiceHost(Process innerProcess)
{
this.innerProcess = innerProcess;
}
프로세스 ID에 대한 접근자를 포함합니다.
public int ID
{
get { return this.innerProcess.Id; }
}
Services 속성은 호스트된 서비스의 이름을 가진 배열을 반환합니다. 프로세스에서 실행 중인 서비스가 없는 경우 이 속성은 null입니다.
public string[] Services
{
Get
{
유휴 프로세스는 서비스를 호스트하지 않습니다.
if (innerProcess.Id == 0)
반환 null;
시스템의 모든 Windows 서비스 목록 가져오기
ServiceController[] services = ServiceController.GetServices();
ServiceController> 서비스 나열<ForProcess = new List<ServiceController>();
using (SCM scm = new SCM())
{
for (int svcIndex = 0; svcIndex < services. 길이; svcIndex++)
{
ServiceController crtService = services[svcIndex];
int processId = scm. GetProcessId(crtService.ServiceName);
서비스가 실행 중인 프로세스의 ID를 현재 프로세스의 ID와 비교합니다.
if (processId == innerProcess.Id)
{
servicesForProcess.Add(services[svcIndex]);
}
}
}
if(servicesForProcess.Count == 0)
반환 null;
서비스 이름으로 배열 준비, 채우기 및 반환
string[] servicesNames = new string[servicesForProcess.Count];
for (int serviceIdx = 0; serviceIdx < servicesForProcess.Count; serviceIdx++)
{
servicesNames[serviceIdx] = servicesForProcess[serviceIdx]. Servicename;
}
return servicesNames;
}
}
EnumerateServiceHosts는 실행 중인 모든 서비스 호스트를 통과하기 위해 IEnumerable을 반환하는 정적 메서드입니다.
static public IEnumerable EnumerateServiceHosts()
{
Process[] process = Process.GetProcesses();
foreach(프로세스의 프로세스 crtProcess)
{
WIN32ServiceHost crtServiceHost = new WIN32ServiceHost(crtProcess);
if(crtServiceHost.Services != null)
{
yield return crtServiceHost;
}
}
}
}
개발자는 모든 .NET 애플리케이션에서 이 클래스를 사용할 수 있습니다. 그러나 이 경우 다른 다양한 관리 애플리케이션에서 사용할 방법이 없습니다. WMI.NET 이 예제의 클래스를 WMI 세계에 노출하는 후크가 있으며 다음 단락의 프로세스를 설명합니다. WMI는 이러한 개체를 활용하여 시스템 관리 서버 또는 Operations Manager와 같은 엔터프라이즈 규모 관리 애플리케이션에 통합하고, 원격 상호 작용을 제공하며, 여러 플랫폼에서 이 클래스를 보고 사용할 수 있는 모델을 제공합니다.
어셈블리 수준 특성
WMI.NET 사용하여 계측을 위해 어셈블리를 노출하는 첫 번째 단계는 어셈블리 수준에서 WmiConfiguration 특성을 설정하는 것입니다. 이 특성은 어셈블리를 WMI.NET 공급자를 구현하는 것으로 표시하고 노출될 네임스페이스를 포함하여 공급자가 구현하는 클래스에 대한 다양한 항목을 구성할 수 있도록 합니다. 이 예제에서는 WMI 네임스페이스를 root\Test 로 정의하고 호스팅 모델을 NetworkService 보안 컨텍스트에서 결합된 공급자 모델로 설정합니다. 모든 작업은 가장을 통해 호출하는 사용자의 보안 컨텍스트에서 실행됩니다.
[assembly: WmiConfiguration(@"root\Test", HostingModel = ManagementHostingModel.NetworkService)]
클래스 수준 WMI.NET 특성
WMI.NET 사용하여 클래스를 계측하려면 클래스, 해당 메서드, 필드 및 속성이 WMI.NET 공개되고 WMI.NET 특성으로 올바르게 표시되어야 합니다. 특성은 WMI에서 기존 C# 클래스를 WMI 클래스로 사용하는 데 필요한 메타데이터를 생성하는 데 사용됩니다.
.NET 클래스 계측
ManagementEntity 특성은 .NET 클래스를 계측되는 것으로 표시합니다. 배포 시 WMI.NET 인프라는 WMI 리포지토리에서 동일한 이름의 해당 WMI 클래스를 생성합니다. 이 이름을 수정하려면 ManagementEntity 특성의 인수 목록에 명명된 매개 변수 이름을 제공해야 합니다. Name 은 대부분의 특성에 대한 계측 이름을 변경하는 명명된 매개 변수로 사용됩니다. 이 예제에서는 .NET 클래스의 이름을 변경하지 않고 WMI 클래스 WIN32_ServiceHost 이름을 지정하도록 선택합니다.
[ManagementEntity(Name = "WIN32_ServiceHost")]
public 클래스 WIN32ServiceHost
엔터티의 이름은 약간 까다로울 수 있습니다. C#은 대/소문자를 구분하지만 WMI는 그렇지 않습니다. 따라서 모든 이름은 WMI.NET 인프라 관점에서 대/소문자를 구분하지 않는 것으로 처리됩니다. 동일한 클래스의 멤버인 두 필드 또는 두 메서드의 이름이 대/소문자별로만 다른 경우 어셈블리가 WMI에 등록되지 않습니다.
WMI 클래스 스키마 제어
instance 페이로드는 해당 속성에 의해 제공됩니다. ManagementProbe, ManagementConfiguration 또는 ManagementKey 특성을 사용하여 WMI 세계에 반영할 모든 속성을 표시해야 합니다. ManagementProbe 는 WMI에만 읽은 것으로 노출된 속성을 표시하는 특성입니다. 샘플에서 Services 속성은 관리 세계에 노출하려는 페이로드 속성입니다. 직접 수정할 수 없는 프로세스의 상태를 표시하므로 ManagementProbe로 표시합니다. 읽기/쓰기 속성의 경우 ManagementConfiguration 특성을 사용해야 합니다. 이 경우 속성 자체에 setter와 getter가 모두 있어야 합니다.
[ManagementProbe]
public string[] Services
ID는 프로세스 자체를 식별할 때 WIN32ServiceHost 페이로드의 일부이기도 합니다. 클래스의 instance 고유하게 식별하는 속성은 WMI 세계에서 해당 클래스의 키입니다. WMI.NET 모든 클래스는 키를 정의하고 이미 키를 정의하는 클래스에서 추상, 싱글톤 또는 상속되지 않는 한 인스턴스를 고유하게 식별하도록 구현해야 합니다. 키는 ManagementKey 특성으로 표시됩니다. 이 샘플에서 프로세스 ID는 프로세스를 고유하게 식별합니다. 따라서 클래스의 인스턴스를 고유하게 식별합니다.
[ManagementKey]
public int ID
런타임 요구 사항
클래스와 해당 속성 컬렉션을 표시하면 클래스 스키마를 WMI에 노출할 수 있지만 클래스가 실제 데이터를 노출하도록 하는 것으로는 충분하지 않습니다. instance 가져오거나 만들거나 삭제하고 인스턴스를 열거하기 위한 진입점을 정의해야 합니다. instance 열거형에 대한 코드를 제공할 뿐만 아니라 기능 WMI 공급자에 대한 최소값인 특정 instance 검색합니다.
인스턴스 열거
인스턴스를 열거하려면 WMI.NET IEnumerable 인터페이스를 반환하는 매개 변수가 없는 정적 public 메서드를 예상합니다. 전체 클래스와 관련된 기능을 구현하므로 정적이어야 합니다. 이 메서드는 ManagementEnumerator 특성으로 표시되어야 합니다. 샘플에 이미 정의된 EnumerateServiceHosts 는 모든 요구 사항을 충족하므로 이 용도로 특성이 지정되고 사용될 수 있습니다.
[ManagementEnumerator]
static public IEnumerable EnumerateServiceHosts()
이 메서드는 열거형에 반환된 각 요소가 계측된 클래스의 instance 있는지 확인하는 것이 매우 중요합니다. 그렇지 않으면 런타임 오류가 발생합니다.
instance 바인딩
특정 instance(WMI.NET 바인딩이라고 함)를 검색하려면 이를 식별하는 키의 값에 따라 instance 반환하는 메서드가 있어야 합니다. 키와 동일한 수의 매개 변수를 가진 메서드가 필요하며, 매개 변수의 이름과 형식이 키와 같습니다. 반환 형식은 계측된 클래스 자체여야 합니다. 정적 메서드를 사용하고 클래스의 키를 매개 변수에 연결하려면 키와 동일한 계측된 매개 변수 이름을 지정해야 합니다. 샘플에서 ID 는 WIN32_ServiceHost 클래스의 키이며 바인딩 메서드 ID 에 대한 매개 변수 이름을 지정하거나 ManagementName 특성을 사용하여 매개 변수를 "ID"라는 이름으로 WMI에 노출해야 합니다. WMI.NET 인프라는 ManagementBind 특성으로 표시될 때 바인딩 메서드 또는 생성자를 인식합니다.
[ManagementBind]
static public WIN32ServiceHost GetInstance([ManagementName("ID")] int processId)
{
다음을 시도해 보세요.
{
프로세스 프로세스 = Process.GetProcessById(processId);
WIN32ServiceHost crtServiceHost = new WIN32ServiceHost(process);
if (crtServiceHost.Services != null)
{
return crtServiceHost;
}
else
{
반환 null;
}
}
지정된 ID가 있는 프로세스가 없는 경우 GetProcessById에서 throw됨
catch(ArgumentException)
{
반환 null;
}
}
instance 찾을 수 없으면 메서드가 null을 반환한다는 점에 유의해야 합니다. 이 경우 요청된 프로세스를 전혀 찾지 못하거나 발견된 프로세스가 Windows 서비스를 호스팅하지 않는 경우 이를 수행합니다.
WMI를 사용하여 등록
클래스는 작업을 수행할 준비가 되었지만 WMI에 등록하고 로드할 디스크의 액세스 가능한 위치에 배치해야 합니다.
GAC(전역 어셈블리 캐시)는 어셈블리를 배치할 위치입니다. 이렇게 하면 .NET에서 전체 .NET 이름으로 검색할 수 있습니다. GAC에 등록하려면 어셈블리에 .NET 강력한 이름이 있어야 합니다. 이 예제에서는 .NET gacutil.exe 도구를 사용하여 GAC에 어셈블리를 저장합니다.
계측된 어셈블리에서 WMI 메타데이터로 정보를 얻으려면 .NET 도구 InstallUtil.exe 사용하여 DefaultManagementInstaller라는 WMI.NET 클래스를 호출해야 합니다. DefaultManagementInstaller 는 계측된 클래스의 전체 어셈블리를 구문 분석하고 해당 WMI 메타데이터를 생성하는 방법을 알고 있습니다. InstallUtil.exe RunInstaller 특성으로 표시된 클래스가 필요하므로 InstallUtil.exe 호출할 DefaultManagementInstaller 에서 파생된 빈 클래스를 정의합니다.
[System.ComponentModel.RunInstaller(true)]
public 클래스 MyInstall: DefaultManagementInstaller
{
}
WMI를 사용하여 등록하는 작업은 오프라인 또는 온라인으로 수행할 수 있습니다. 온라인 등록은 어셈블리의 계측 메타데이터를 WMI 리포지토리에 바로 저장합니다. 메타데이터를 WMI 리포지토리에 직접 설치하려면 어셈블리 이름을 매개 변수로 사용하여 InstallUtil.exe 명령이 호출됩니다. InstallUtil.exe 실행하기 전에 어셈블리가 GAC에 있어야 합니다. 이 예제에서 생성된 어셈블리의 경우 WMIServiceHost.dll 다음 명령을 사용합니다.
C:>gacutil.exe /i WMIServiceHost.dll
C:>Installutil.exe WMIServiceHost.dll
오프라인 등록에는 두 단계가 필요합니다. 첫 번째 단계는 어셈블리와 연결된 WMI 메타데이터를 생성하고 MOF 파일에 저장하는 것입니다. 두 번째 단계는 mofcomp.exe 도구를 사용하거나 설치 패키지의 일부로 대상 머신에 대한 실제 등록입니다. 오프라인 등록의 장점은 MOF 파일을 필요에 따라 지역화하고 수정할 수 있다는 것입니다. 이 예제에서는 다음과 같이 MOF 매개 변수를 사용하여 WMIServiceHost.mof라는 파일에 WMI 메타데이터를 생성하고 저장할 수 있습니다.
C:>Installutil.exe /MOF=WMIServiceHost.mof WMIServiceHost.dll
온라인 사례와 마찬가지로 어셈블리는 대상 컴퓨터의 GAC에 있어야 합니다. 배포의 유효성을 검사하기 위해 wmic.exe 시스템 도구를 사용하여 이 클래스의 인스턴스와 값을 확인할 수 있습니다.
C:>wmic /NAMESPACE:\\root\test PATH win32_servicehost 가져오기 /value
개발하는 동안 어셈블리가 저장되는 GAC의 동일한 폴더에 기호를 배포하는 것이 유용합니다. 이렇게 하면 오류 또는 크래시로 인해 보고된 스택에는 코드의 잘못된 부분을 식별하는 데 도움이 되는 전체 소스 경로와 줄 번호가 포함됩니다.
상속을 통해 클래스 확장
WIN32_ServiceHost 서비스 호스트에 관한 것이며 제공하는 정보는 Windows 서비스를 호스팅하는 프로세스로 제한됩니다. 메모리 사용량, 실행 경로, 세션 ID 등과 같은 프로세스별 정보를 포함하도록 이 정보를 확장하는 것이 흥미로울 것입니다. 이 정보를 얻으려면 스키마를 확장하고 필요한 만큼 정보를 검색하는 코드를 더 작성할 수 있습니다. 추가 코드를 작성하는 좋은 대안은 root\cimv2 네임스페이스의 기본 제공 운영 체제에 있는 기존 WIN32_Process 클래스를 활용하고 시스템에서 실행되는 모든 프로세스에 대해 이 모든 추가 정보를 제공하는 것입니다. 이 클래스는 실행 중인 프로세스에 대한 광범위한 정보를 제공하며 WMI 파생을 사용하여 자체 클래스로 확장할 수 있습니다.
WMI 상속은 WMI.NET 코딩 모델에서 클래스 상속으로 변환됩니다. 파생하려는 클래스는 코드에서 실제로 구현하지 않는 WMI 공간의 클래스이므로 특정 방식으로 표시해야 합니다.
파생을 작성하기 전에 WIN32_Process 클래스에 대한 두 가지 중요한 사항을 유의해야 합니다. 첫 번째 WIN32_Processroot\cimv2 네임스페이스에 있으며 파생을 사용하려면 동일한 네임스페이스에 win32_servicehost 클래스를 등록해야 합니다. 따라서 WmiConfiguration 특성 문을 약간 변경합니다.
[assembly: WmiConfiguration(@"root\cimv2", HostingModel = ManagementHostingModel.NetworkService)]
또한 슈퍼클래스인 win32_process 핸들 속성이 키로 정의되어 있습니다. 이 키는 로 변환되는 CIM_STRING 형식입니다. NET의 System.String. ID를 키 속성으로 사용하지 말고 대신 Handle 속성을 사용해야 합니다.
win32_process 일치하도록 WMI.NET 외부 클래스를 정의하려면 스키마를 미러 사용하려는 속성만 포함합니다. 클래스 계층 구조의 키는 항상 필요합니다. 이때 핸들은 키이므로 유일한 흥미로운 속성이며 특정 instance 바인딩하는 데 필요합니다.
[ManagementEntity(External = true)]
추상 공용 클래스 Win32_Process
{
보호된 문자열 핸들;
[ManagementKey]
public string Handle
{
get {
이.handle을 반환합니다.
}
}
}
ManagementEntity 특성에서 External를 true로 설정하면 인프라가 배포 시 WMI 메타데이터를 생성하지 않지만 파생 클래스에 대한 키와 속성을 찾아야 할 때 런타임에 사용 현황에 대해 선언된 정보를 유지합니다. 키가 WMI 하위 시스템에 의해 다양한 공급자의 정보를 병합하는 데 사용되므로 기본 클래스의 키 콘텐츠를 제어하는 것이 매우 중요합니다.
WMI 클래스를 WIN32_ServiceHost WMI 클래스 Win32Process를 상속하려면 .NET 월드에서 새로 만든 추상 클래스에서 WIN32ServiceHost를 파생합니다.
[ManagementEntity(Name = "WIN32_ServiceHost")]
public 클래스 WIN32ServiceHost: Win32_Process
ID 속성을 제거합니다.
[ManagementKey]
public int ID
{
get { return this.innerProcess.Id; }
}
생성자를 변경하여 기본 클래스의 핸들 필드에 새 키를 채웁니다.
public WIN32ServiceHost(Process innerProcess)
{
this.innerProcess = innerProcess;
this.handle = innerProcess.Id.ToString();
}
Handle이라는 문자열 인수로 작동하도록 GetInstance를 수정합니다. 나머지 줄은 동일하게 유지됩니다.
[ManagementBind]
static public WIN32ServiceHost GetInstance(string Handle)
{
int processId;
if (! Int32.TryParse(Handle, out processId))
{
반환 null;
}
다음을 시도해 보세요.
[...]
GAC에서 새 어셈블리를 다시 컴파일하고 다시 배포해야 합니다. InstallUtil.exe 사용하여 새 스키마를 배포합니다. 약간 수정된wmic.exe명령을 사용하여 시스템을 쿼리할 수 있습니다 .
C:>wmic /NAMESPACE:\\root\cimv2 PATH win32_servicehost 가져오기 /value
반환된 인스턴스는 win32_process 및 win32_servicehost 두 클래스의 정보로 채워집니다. 출력에서 서비스는 win32_servicehost 제공되지만 다른 모든 것은 win32_process 제공됩니다. 출력을 단순화하기 위해 원하는 열을 지정할 수 있습니다.
C:>wmic PATH win32_servicehost 핸들, 캡션, CommandLine, Services /value 가져오기
win32_process 열거하려고 할 때 더욱 흥미로워집니다. 이러한 쿼리는 모든 프로세스를 반환하고 win32_servicehost 인스턴스에 대한 서비스 필드를 채웁니다.
C:>wmic PATH win32_process 가져오기 /value
출력은 약간 압도적일 수 있으므로 명령줄 끝에 out.txt 추가하여 > 파일에 덤프하고 메모장에서 열어 Services 속성을 검색합니다. 무슨 일이 일어나고 있는지 이해하기 위해 각 instance WMI 클래스를 식별할 시스템 속성을 표시할 수 있습니다.
C:>wmic PATH win32_process 핸들, CommandLine, __CLASS /value 가져오기
결과 목록에서 win32_ServiceHost instance 선택하고 해당 값을 표시합니다.
C:>wmic path WIN32_Process.Handle="536" get /value
Windows 스크립팅, Microsoft PowerShell, 관리 코드 또는 네이티브 코드를 사용하여 모든 WMI 클라이언트 애플리케이션에서 유사한 작업을 수행할 수 있습니다. 시스템은 이 어셈블리를 다른 공급자를 처리하는 것과 동일한 방식으로 처리합니다.
메서드 구현
WMI.NET 정적 및 instance 단위의 메서드를 지원합니다. 이 경우 프로세스가 호스트하는 모든 서비스를 중지하는 메서드를 추가하여 서비스가 실행되는 동안 프로세스를 종료하지 않고 프로세스를 깔끔하게 중지할 수 있도록 합니다. WMI에서 공용 메서드를 표시하려면 ManagementTask 특성으로 표시합니다.
[ManagementTask]
public bool StopServices(int millisecondsWait)
{
if (innerProcess.Id == 0)
return false;
ServiceController[] services = ServiceController.GetServices();
bool oneFailed = false;
using (SCM scm = new SCM())
{
for (int svcIndex = 0; svcIndex < services. 길이; svcIndex++)
{
ServiceController crtService = services[svcIndex];
int processId = scm. GetProcessId(crtService.ServiceName);
if (processId == innerProcess.Id)
{
다음을 시도해 보세요.
{
crtService.Stop();
if (millisecondsWait != 0)
{
crtService.WaitForStatus( ServiceControllerStatus.Stopped,
new TimeSpan((long)millisecondsWait * 10000));
}
}
catch(System.ServiceProcess.TimeoutException)
{
oneFailed = true;
}
catch(System.ComponentModel.Win32Exception)
{
oneFailed = true;
}
catch(InvalidOperationException)
{
oneFailed = true;
}
}
}
}
return !oneFailed;
}
이 메서드를 호출하려면 win32_servicehost 클래스의 instance 필요합니다. 다음을 입력하는 사용 가능한 서비스 호스트 목록을 가져옵니다.
C:>wmic 경로 win32_servicehost 핸들 가져오기,서비스
가장 양성 서비스 목록이 있는 서비스를 선택하고(시스템을 중단하지 않도록 일부 서비스도 중지할 수 없음) Handle 속성을 사용하여 호출의 instance 식별합니다.
C:>wmic 경로 win32_servicehost. Handle="540" CALL StopServices(0)
예외 및 오류 보고
예외는 WMI.NET 중요한 측면입니다. 인프라는 일부 예외를 사용하여 정보를 전달하며 대부분의 예외를 처리되지 않은 것으로 처리합니다.
허용되는 예외
WMI.NET 문서에서 자세히 설명할 몇 가지 예외만 처리합니다. 다른 모든 예외는 프로그래밍 오류로 간주되며 WMI 공급자 호스트가 충돌하는 처리되지 않은 예외로 처리되지 않은 예외로 처리됩니다. WMI.NET Windows 이벤트 로그에서 처리되지 않은 예외를 보고합니다.
허용되는 예외는 실제로 WMI 오류 코드로 변환되고 표 1에 표시된 대로 클라이언트 코드로 다시 전송됩니다. 따라서 WMI.NET 공급자는 다른 네이티브 공급자로 작동합니다.
System.OutOfMemoryException |
WBEM_E_OUT_OF_MEMORY |
System.Security.SecurityException |
WBEM_E_ACCESS_DENIED |
System.ArgumentException |
WBEM_E_INVALID_PARAMETER |
System.ArgumentOutOfRangeException |
WBEM_E_INVALID_PARAMETER |
System.InvalidOperationException |
WBEM_E_INVALID_OPERATION |
System.Management.Instrumentation.InstanceNotFoundException |
WBEM_E_NOT_FOUND |
System.Management.Instrumentation.InstrumentationException |
내부 예외에서 문서에 자세히 설명되어 있습니다. |
Table1 – 예외를 WMI 오류로 변환
위의 목록에서 두 가지를 제외한 모든 항목은 일반적인 .NET Framework 예외입니다. 나열된 모든 예외를 throw하여 이러한 예외가 나타내는 특정 상태 클라이언트에 보고할 수 있습니다.
자세한 설명에 따라 System.Management.Instrumentation 네임스페이스에 두 가지 새로운 예외가 추가되었습니다.
InstanceNotFoundException
이 예외는 요청된 instance 찾을 수 없음을 알리는 역할을 합니다. 이 문서의 샘플에서는 GetInstance 정적 메서드를 사용하여 지정된 instance 바인딩하고 instance 찾을 수 없는 경우 null을 반환합니다. 생성자는 동일한 용도로 사용할 수 있지만 필요한 instance 찾을 수 없는 경우 InstanceNotFoundException을 throw해야 합니다. GetInstance 정적 메서드를 대체할 생성자는 다음과 같습니다.
[ManagementBind]
public WIN32ServiceHost(string Handle)
{
int processId;
(! Int32.TryParse(Handle, out processId))
{
throw 새 InstanceNotFoundException();
}
다음을 시도해 보세요.
{
프로세스 프로세스 = Process.GetProcessById(processId);
this.innerProcess = process;
this.handle = Handle;
if (this. 서비스 == null)
{
throw 새 InstanceNotFoundException();
}
}
지정된 ID가 있는 프로세스가 없으면 GetProcessById에서 throw됨
catch(ArgumentException)
{
throw 새 InstanceNotFoundException();
}
}
InstrumentationException
InstrumentationException은 처리된 예외에 대한 래퍼입니다. 공급자는 클라이언트 쪽에서 발생한 오류를 클라이언트에 알리도록 선택할 수 있습니다. 이렇게 하려면 InstrumentationException을 throw합니다. 개발자는 예외가 WMI 시스템으로 돌아가는 것을 염두에 두어야 합니다. 따라서 WMI.NET COM HRESULT로 변환하기 위해 최선을 다할 것입니다. 정확한 오류 코드를 클라이언트에 다시 throw하려면 InstrumentationException 에 대한 내부 예외로 기본 예외 클래스에서 내부 HResult를 직접 설정할 수 있는 Exception 클래스로 전달해야 합니다.
오류 보고
이전 섹션에 나열되지 않은 예외는 처리되지 않은 예외로 인해 "처리되지 않은 예외('System.ExecutionEngineException')가 wmiprvse.exe[<NNNN]에서 발생했습니다.", NNNN>이 프로세스 번호로 보고됩니다. 오류 및 스택은 이벤트 로그에 보고됩니다. 어셈블리와 동일한 폴더에 기호가 있으면 파일 이름과 줄 번호가 포함된 잘못된 스택이 완료된 것으로 표시됩니다.
또 다른 오류 사례는 어셈블리가 GAC에 배포되지 않았기 때문에 로드할 수 없는 경우입니다. WMI.NET 이 경우 공급자 로드 실패(WBEM_E_PROVIDER_LOAD_FAILURE)를 반환합니다.
공급자 개발 중에 자주 발생한 문제는 WMI 스키마와 코드 간의 불일치입니다. WMI에 스키마를 배포하지 않고 새 어셈블리를 배포하거나 런타임에만 정보를 사용할 수 있으므로 InstallUtil.exe 사용하여 배포할 때 문제가 발생하지 않을 때 발생할 수 있습니다. 예를 들어 열거 중에 잘못된 형식이 반환된 경우입니다. WMI.NET 인프라는 클라이언트에 공급자 오류(WMI 오류 WBEM_E_PROVIDER_FAILURE)로 보고하고 런타임 문제를 설명하는 메시지를 Windows 이벤트 로그에 생성합니다.
기타 팁
모든 특성 및 WMI.NET 코드는 System.Management.Instrumentation 네임스페이스에 있습니다. WMI.NET 어셈블리를 빌드하려면 프로젝트에 특성과 런타임 코드의 정의가 각각 포함되어 있으므로 System.Core.dll 및 System.Management.Infrastructure.dll 대한 참조가 있어야 합니다. 나중에 계측된 어셈블리를 로드하고, 계측된 클래스를 WMI 리포지토리와 일치시키고, 그에 따라 호출하는 방법을 알고 있습니다.
특정 종류의 애플리케이션에 대한 모든 클래스를 동일한 어셈블리에 유지합니다. 이렇게 하면 유지 관리 및 배포가 훨씬 쉬워집니다.
문서의 모든 코드를 배포하고 관리자 권한으로 실행해야 합니다. Windows Vista에서 관리자 권한으로 실행하려면 관리자 권한 보안 명령 프롬프트가 필요합니다. 공급자는 일반적으로 예제와 같이 특별히 보안된 시스템 데이터에 액세스하지 않는 한 클라이언트가 관리자가 될 필요가 없습니다.
결론
.NET Framework 3.5의 새로운 관리 라이브러리는 개발자에게 WMI 공급자 작성을 위한 강력한 도구를 제공합니다. 프로그래밍 모델의 단순성을 감안할 때 WMI 공급자를 작성하는 것은 대부분의 WMI 기능을 구현할 수 있는 다소 쉬운 작업이 됩니다. 이 문서의 샘플에서는 간단한 WMI 공급자만 작성하는 방법을 보여 주지만 라이브러리는 분리된 공급자 개발 및 싱글톤, 상속, 추상 클래스, 참조 및 연결 클래스 구현을 지원하여 WMI.NET Provider Extension v2를 WMI 네이티브 인터페이스를 사용한 개발에 대한 심각한 대안으로 만듭니다.
목록 1 – SCMInterop.cs
using System;
System.Runtime.InteropServices 사용
System.ServiceProcess 사용
namespace External.PInvoke
{
[StructLayout(LayoutKind.Sequential)]
내부 구조체 SERVICE_STATUS_PROCESS
{
public uint dwServiceType;
public uint dwCurrentState;
public uint dwControlsAccepted;
public uint dwWin32ExitCode;
public uint dwServiceSpecificExitCode;
public uint dwCheckPoint;
public uint dwWaitHint;
public uint dwProcessId;
public uint dwServiceFlags;
public static readonly int SizeOf = Marshal.SizeOf(typeof(SERVICE_STATUS_PROCESS));
}
[플래그]
internal enum SCM_ACCESS : uint
{
SC_MANAGER_CONNECT = 0x00001
}
[플래그]
internal enum SERVICE_ACCESS : uint
{
STANDARD_RIGHTS_REQUIRED = 0xF0000
SERVICE_QUERY_CONFIG = 0x00001
SERVICE_CHANGE_CONFIG = 0x00002,
SERVICE_QUERY_STATUS = 0x00004
SERVICE_ENUMERATE_DEPENDENTS = 0x00008
SERVICE_START = 0x00010,
SERVICE_STOP = 0x00020,
SERVICE_PAUSE_CONTINUE = 0x00040
SERVICE_INTERROGATE = 0x00080
SERVICE_USER_DEFINED_CONTROL = 0x00100
SERVICE_ALL_ACCESS = (STANDARD_RIGHTS_REQUIRED |
SERVICE_QUERY_CONFIG |
SERVICE_CHANGE_CONFIG |
SERVICE_QUERY_STATUS |
SERVICE_ENUMERATE_DEPENDENTS |
SERVICE_START |
SERVICE_STOP |
SERVICE_PAUSE_CONTINUE |
SERVICE_INTERROGATE |
SERVICE_USER_DEFINED_CONTROL)
}
내부 열거형 SC_STATUS_TYPE
{
SC_STATUS_PROCESS_INFO = 0
}
internal 클래스 ServiceHandle : SafeHandle
{
public ServiceHandle()
: base(IntPtr.Zero, true)
{
}
public void OpenService(SafeHandle scmHandle, string serviceName)
{
IntPtr serviceHandle = SCM. OpenService(scmHandle, serviceName, SERVICE_ACCESS. SERVICE_QUERY_STATUS);
if (serviceHandle == IntPtr.Zero)
{
throw 새 System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error(),
"SCM. QueryServiceStatusEx");
}
SetHandle(serviceHandle);
}
protected override bool ReleaseHandle()
{
는 SCM을 반환합니다. CloseServiceHandle(base.handle);
}
public override bool IsInvalid
{
get { return IsClosed || handle == IntPtr.Zero; }
}
}
내부 클래스 SCM: SafeHandle
{
[DllImport("advapi32.dll", EntryPoint = "OpenSCManagerW", CharSet = CharSet.Unicode,
SetLastError = true)]
public static extern IntPtr OpenSCManager(string machineName,
string databaseName,
[MarshalAs(UnmanagedType.U4)] SCM_ACCESS dwAccess);
[DllImport("advapi32.dll", EntryPoint = "OpenServiceW", CharSet = CharSet.Unicode,
SetLastError = true)]
public static extern IntPtr OpenService(SafeHandle hSCManager,
[MarshalAs(UnmanagedType.LPWStr)] 문자열 lpServiceName,
[MarshalAs(UnmanagedType.U4)] SERVICE_ACCESS dwDesiredAccess);
[DllImport("advapi32.dll", EntryPoint = "QueryServiceStatusEx", CharSet = CharSet.Auto,
SetLastError = true)]
public static extern bool QueryServiceStatusEx(SafeHandle hService,
SC_STATUS_TYPE InfoLevel,
ref SERVICE_STATUS_PROCESS dwServiceStatus,
int cbBufSize,
ref int pcbBytesNeeded);
[DllImport("advapi32.dll", EntryPoint = "CloseServiceHandle", CharSet = CharSet.Auto,
SetLastError = true)]
public static extern bool CloseServiceHandle(IntPtr hService);
public SCM()
: base(IntPtr.Zero, true)
{
IntPtr handle = OpenSCManager(null, null, SCM_ACCESS. SC_MANAGER_CONNECT);
기본. SetHandle(handle);
}
protected override bool ReleaseHandle()
{
는 SCM을 반환합니다. CloseServiceHandle(base.handle);
}
public override bool IsInvalid
{
get { return IsClosed || handle == IntPtr.Zero; }
}
public void QueryService(string serviceName, out SERVICE_STATUS_PROCESS statusProcess)
{
statusProcess = new SERVICE_STATUS_PROCESS();
int cbBytesNeeded = 0;
using (ServiceHandle serviceHandle = new ServiceHandle())
{
serviceHandle.OpenService(this, serviceName);
bool scmRet = SCM. QueryServiceStatusEx(serviceHandle,
SC_STATUS_TYPE. SC_STATUS_PROCESS_INFO
ref statusProcess,
SERVICE_STATUS_PROCESS. Sizeof
ref cbBytesNeeded);
if (!scmRet)
{
throw 새 System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error(),
"SCM. QueryServiceStatusEx");
}
}
}
public int GetProcessId(string serviceName)
{
SERVICE_STATUS_PROCESS serviceStatus;
이. QueryService(serviceName, out serviceStatus);
return (int)serviceStatus.dwProcessId;
}
}
}
목록 2 – WIN32ServiceHost.cs
using System;
System.Collections 사용
using System.Collections.Generic;
Using System.Linq;
using System.Text;
System.ServiceProcess 사용
System.Diagnostics 사용
Using External.PInvoke;
System.Management.Instrumentation 사용
[assembly: WmiConfiguration(@"root\cimv2", HostingModel = ManagementHostingModel.NetworkService)]
네임스페이스 TestWMI.Hosted
{
[System.ComponentModel.RunInstaller(true)]
public 클래스 MyInstall: DefaultManagementInstaller
{
}
[ManagementEntity(External = true)]
추상 공용 클래스 Win32_Process
{
보호된 문자열 핸들;
[ManagementKey]
public string Handle
{
get {
이.handle을 반환합니다.
}
}
}
[ManagementEntity(Name = "WIN32_ServiceHost")]
public 클래스 WIN32ServiceHost: Win32_Process
{
innerProcess 처리;
<요약>
///
</요약>
<param name="innerProcess"></param>
public WIN32ServiceHost(Process innerProcess)
{
this.innerProcess = innerProcess;
this.handle = innerProcess.Id.ToString();
}
public int ID
{
get { return this.innerProcess.Id; }
}
[ManagementProbe]
public string[] Services
{
Get
{
if (innerProcess.Id == 0)
반환 null;
ServiceController[] services = ServiceController.GetServices();
ServiceController> 서비스 나열<ForProcess = new List<ServiceController>();
using (SCM scm = new SCM())
{
for (int svcIndex = 0; svcIndex < services. 길이; svcIndex++)
{
ServiceController crtService = services[svcIndex];
int processId = scm. GetProcessId(crtService.ServiceName);
if (processId == innerProcess.Id)
{
servicesForProcess.Add(services[svcIndex]);
}
}
}
if (servicesForProcess.Count == 0)
반환 null;
string[] servicesNames = new string[servicesForProcess.Count];
for (int serviceIdx = 0; serviceIdx < servicesForProcess.Count; serviceIdx++)
{
servicesNames[serviceIdx] = servicesForProcess[serviceIdx]. Servicename;
}
return servicesNames;
}
}
[ManagementEnumerator]
static public IEnumerable EnumerateServiceHosts()
{
Process[] process = Process.GetProcesses();
foreach(프로세스의 프로세스 crtProcess)
{
WIN32ServiceHost crtServiceHost = new WIN32ServiceHost(crtProcess);
if(crtServiceHost.Services != null)
{
yield return crtServiceHost;
}
}
}
[ManagementBind]
public WIN32ServiceHost(string Handle)
{
int processId;
(! Int32.TryParse(Handle, out processId))
{
throw 새 InstanceNotFoundException();
}
다음을 시도해 보세요.
{
프로세스 프로세스 = Process.GetProcessById(processId);
this.innerProcess = process;
this.handle = Handle;
if (this. 서비스 == null)
{
throw 새 InstanceNotFoundException();
}
}
지정된 ID가 있는 프로세스가 없으면 GetProcessById에서 throw됨
catch(ArgumentException)
{
throw 새 InstanceNotFoundException();
}
}
static public WIN32ServiceHost GetInstance(string Handle)
{
int processId;
(! Int32.TryParse(Handle, out processId))
{
반환 null;
}
다음을 시도해 보세요.
{
프로세스 프로세스 = Process.GetProcessById(processId);
WIN32ServiceHost crtServiceHost = new WIN32ServiceHost(process);
if(crtServiceHost.Services != null)
{
return crtServiceHost;
}
else
{
반환 null;
}
}
지정된 ID가 있는 프로세스가 없으면 GetProcessById에서 throw됨
catch(ArgumentException)
{
반환 null;
}
}
[ManagementTask]
public bool StopServices(int millisecondsWait)
{
if (innerProcess.Id == 0)
return false;
ServiceController[] services = ServiceController.GetServices();
bool oneFailed = false;
using (SCM scm = new SCM())
{
for (int svcIndex = 0; svcIndex < services. 길이; svcIndex++)
{
ServiceController crtService = services[svcIndex];
int processId = scm. GetProcessId(crtService.ServiceName);
if (processId == innerProcess.Id)
{
다음을 시도해 보세요.
{
crtService.Stop();
if(밀리초Wait != 0)
{
crtService.WaitForStatus( ServiceControllerStatus.Stopped,
new TimeSpan((long)millisecondsWait * 10000));
}
}
catch(System.ServiceProcess.TimeoutException)
{
oneFailed = true;
}
catch(System.ComponentModel.Win32Exception)
{
oneFailed = true;
}
catch(InvalidOperationException)
{
oneFailed = true;
}
}
}
}
return !oneFailed;
}
}
}
© 2008 Microsoft Corporation. All rights reserved.