Mgmtclassgen.exe (厳密型クラス ジェネレーター)

厳密型クラス ジェネレーター (Mgmtclassgen.exe) ツールを使用すると、指定した WMI (Windows Management Instrumentation) クラスに対して、事前バインディングされたマネージド クラスをすばやく生成できます。 生成されたクラスを使用すると、WMI クラスのインスタンスにアクセスするために書く必要のあるコードを簡略化できます。

構文

mgmtclassgen
WMIClass [options]

Remarks

Mgmtclassgen.exe は、ManagementClass.GetStronglyTypedClassCode メソッドを使用します。 したがって、任意のカスタム コード プロバイダーを使用して、C#、Visual Basic、および JScript 以外のマネージド言語でコードを生成できます。

生成されたクラスは、それらのクラスを生成する目的となったスキーマにバインドされます。 基になるスキーマが変更された場合に、その変更をこのスキーマに反映するには、クラスを生成し直す必要があります。

WMI CIM (Common Information Model) 型の、生成されたクラスのデータ型への割り当てを次の表に示します。

WMI クラスを生成する場合は、次の動作に注意してください｡

• 標準パブリック プロパティまたはメソッドの名前と既存のプロパティまたはメソッドの名前が同じになる可能性があります。 このような事態が発生した場合、このツールは生成したクラスのプロパティまたはメソッドの名前を変更して、名前付けの競合を回避します。

• 生成したクラスのプロパティまたはメソッドの名前がプログラミング言語のキーワード名と同じになる可能性があります。 このような事態が発生した場合、このツールは生成したクラスのプロパティまたはメソッドの名前を変更して、名前付けの競合を回避します。

• WMI では、修飾子は、クラス、インスタンス、プロパティ、またはメソッドを説明する情報を含む修飾子となります。 WMI は、Read、Write、Key などの標準の修飾子を使用して、生成したクラスのプロパティについて説明します。 たとえば、Read 修飾子で修飾されたプロパティは、生成したクラスではプロパティ get アクセサーだけを伴って定義されます。 Read 修飾子でマークされたプロパティは読み取り専用であるため、set アクセサーは定義されません。

• 数値プロパティを Values 修飾子および ValueMaps 修飾子によって修飾すると、このプロパティには、指定した許容値しか設定できないことを示すことができます。 列挙体は、このような Values および ValueMaps を使用して生成され、このプロパティは列挙体に割り当てられます。

• WMI では、インスタンスを 1 つだけを持つことのできるクラスを説明するために、シングルトンという用語を使用します。 したがって、シングルトン クラスのパラメーターなしのコンストラクターは、クラスをそのクラスの唯一のインスタンスに初期化します。

• WMI クラスは、オブジェクトであるプロパティを持つ場合があります。 そのような型の WMI クラスに対して、厳密に型指定されたクラスを生成する場合は、埋め込まれたオブジェクト プロパティの型それぞれに対して厳密に型指定されたクラスを生成することを検討してください。 これにより、厳密に型指定する方法で、埋め込まれたオブジェクトにアクセスできるようになります。 生成されたコードが、埋め込まれたオブジェクトの型を検出できない場合もあります。 このような場合は、生成されたコード内に、その旨をユーザーに通知するコメントが作成されます。 これに応じて、生成された他のクラスをプロパティの型として指定するように、生成したコードを変更できます。

• WMI では、CIM_DATETIME データ型のデータ値は、特定の日時または時間間隔を表すことができます。 データ値が日時を表す場合、生成されたクラスのデータ型は DateTime です。 データ値が時間間隔を表す場合、生成されたクラスのデータ型は TimeSpan です。

Visual Studio .NET のサーバー エクスプローラー管理拡張機能を使用して、厳密に型指定されたクラスを生成することもできます。

WMI の詳細については、プラットフォーム SDK の「Windows Management Instrumentation」のトピックを参照してください。

使用例

Root\cimv2 名前空間内の Win32_LogicalDisk WMI クラスに対してマネージド クラスを C# コードで生成するコマンドを次に示します。 このツールは、ROOT.CIMV2.Win32 名前空間内の c:\disk.cs にあるソース ファイルにマネージド クラスを書き込みます。

mgmtclassgen Win32_LogicalDisk /n root\cimv2 /l CS /p c:\disk.cs  

生成したクラスをプログラムによって使用する方法を次のコード例に示します。 まず、クラスのインスタンスが列挙され、パスが出力されます。 次に、初期化の対象となる生成したクラスのインスタンスが、WMI のインスタンスを使用して作成されます。 Root\cimv2 名前空間において Process は Win32_Process に対して生成されたクラスであり、LogicalDisk は Win32_LogicalDisk に対して生成されたクラスです。

Imports System  
Imports System.Management  
Imports ROOT.CIMV2.Win32  
  
Public Class App
   Public Shared Sub Main()
      ' Enumerate instances of the Win32_process.  
      ' Print the Name property of the instance.  
      Dim ps As Process
      For Each ps In  Process.GetInstances()  
         Console.WriteLine(ps.Name)  
      Next ps  
  
      ' Initialize the instance of LogicalDisk with  
      ' the WMI instance pointing to logical drive d:.  
      Dim dskD As New LogicalDisk(New _  
         ManagementPath("win32_LogicalDisk.DeviceId=""d:"""))  
      Console.WriteLine(dskD.Caption)  
   End Sub  
End Class  

using System;  
using System.Management;  
using ROOT.CIMV2.Win32;  
  
public class App  
{  
   public static void Main()  
   {  
      // Enumerate instances of the Win32_process.  
      // Print the Name property of the instance.  
      foreach(Process ps in Process.GetInstances())  
      {  
         Console.WriteLine(ps.Name);  
      }  
  
      // Initialize the instance of LogicalDisk with  
      // the WMI instance pointing to logical drive d:.  
      LogicalDisk dskD = new LogicalDisk(new ManagementPath(  
        "win32_LogicalDisk.DeviceId=\"d:\""));  
      Console.WriteLine(dskD.Caption);  
   }  
}  

関連項目

• System.Management
• ManagementClass.GetStronglyTypedClassCode
• System.CodeDom.Compiler.CodeDomProvider
• ツール
• 開発者コマンドライン シェル