Mgmtclassgen.exe (Gerador de Classe Fortemente Tipada de Gerenciamento)

A ferramenta Gerador de Classes Fortemente Tipadas de Gerenciamento permite gerar rapidamente uma classe gerenciada Early Bound para uma classe WMI (Instrumentação de Gerenciamento do Windows) especificada. A classe gerada simplifica o código que você deve gravar para acessar uma instância da classe WMI.

Syntax

mgmtclassgen
WMIClass [options]

Comentários

Mgmtclassgen.exe usa o método ManagementClass.GetStronglyTypedClassCode. Por isso, é possível usar qualquer provedor de código personalizado para gerar código em linguagens gerenciadas que não sejam C#, Visual Basic e JScript.

As classes geradas são associadas ao esquema para o qual são geradas. Se o esquema subjacente mudar, você deverá gerar novamente a classe se quiser refletir alterações no esquema.

A seguinte tabela mostra como tipos CIM (Common Information Model) são mapeados para tipos de dados em uma classe gerada:

Observer os seguintes comportamentos quando você gera uma classe WMI:

• É possível que uma propriedade ou um método público padrão tenha o mesmo nome de uma propriedade ou um método existente. Se isso ocorrer, a ferramenta alterará o nome da propriedade ou do método na classe gerada para evitar conflitos de nomenclatura.

• É possível que o nome de uma propriedade ou de um método em uma classe gerada seja uma palavra-chave na linguagem de programação de destino. Se isso ocorrer, a ferramenta alterará o nome da propriedade ou do método na classe gerada para evitar conflitos de nomenclatura.

• No WMI, os qualificadores são os modificadores que contêm informações para descrever uma classe, uma instância, uma propriedade ou um método. O WMI usa qualificadores padrão, como Leitura, Gravação e Key para descrever uma propriedade em uma classe gerada. Por exemplo, uma propriedade modificada com um Read qualificador é definida apenas com um acessador de propriedade get na classe gerada. Como uma propriedade marcada com o Read qualificador destina-se a ser somente leitura, um set acessador não é definido.

• Uma propriedade numérica pode ser modificada pelos qualificadores e ValueMaps para Values indicar que a propriedade pode ser definida apenas para valores permitidos especificados. Uma enumeração é gerada com elas Values e ValueMaps a propriedade é mapeada para a enumeração.

• O WMI usa o termo singleton para descrever uma classe que só pode ter uma instância. Por isso, o construtor sem parâmetros de uma classe singleton inicializará a classe com a única instância da classe.

• Uma classe WMI pode ter as propriedades que são objetos. Ao gerar uma classe fortemente tipada para esse tipo de classe WMI, você deve levar em consideração a geração de classes fortemente tipadas para os tipos das propriedades de objeto inseridas. Isso permitirá acessar os objetos inseridos de maneira fortemente tipada. Observe que o código gerado talvez não seja capaz de detectar o tipo de objeto inserido. Nesse caso, um comentário será criado no código gerado para notificar você desse problema. Em seguida, é possível modificar o código gerado para tipar a propriedade para a outra classe gerada.

• No WMI, o valor de dados do tipo de dados CIM_DATETIME pode representar uma data e hora específicas ou um intervalo de tempo. Se o valor de dados representar uma data e hora, o tipo de dados na classe gerada será DateTime. Se o valor de dados representar um intervalo de tempo, o tipo de dados na classe gerada será TimeSpan.

Também é possível gerar uma classe fortemente tipada usando-se a Extensão de Gerenciamento do Gerenciador de Servidores no Visual Studio .NET.

Para obter mais informações sobre WMI, consulte o tópico Instrumentação de Gerenciamento do Windows na documentação do SDK da Plataforma.

Exemplos

O comando a seguir gera uma classe gerenciada no código do C# para a classe WMI Win32_LogicalDisk no namespace Root\cimv2. A ferramenta grava a classe gerenciada no arquivo de origem em c:\disk.cs no namespace ROOT.CIMV2.Win32.

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

O código a seguir mostra como usar uma classe gerada programaticamente. Primeiro, uma instância da classe é enumerada e o caminho é impresso. Em seguida, uma instância da classe gerada a ser inicializada é criada com uma instância de WMI. Process é a classe gerada para Win32_Process e LogicalDisk é a classe gerada para Win32_LogicalDisk no namespace Root\cimv2.

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);
   }
}

Confira também

• System.Management
• ManagementClass.GetStronglyTypedClassCode
• System.CodeDom.Compiler.CodeDomProvider
• Ferramentas
• Shells de linha de comando do desenvolvedor