Atualizar uma instância inteira

O meio mais comum de atualizar uma instância de classe WMI é atualizar toda a instância de uma só vez. Ao atualizar uma instância inteira, o WMI não precisa analisar a instância em propriedades individuais e enviá-las para seu aplicativo. Em vez disso, o WMI pode simplesmente enviar a instância inteira. Quando você termina, o WMI pode copiar toda a instância alterada na instância original.

O procedimento a seguir descreve como modificar ou atualizar uma instância usando o PowerShell.

Para modificar ou atualizar uma instância usando o PowerShell

1. Recupere uma cópia local do objeto com uma chamada para Get-WmiObject.

   $mySettings = get-WMIObject Win32_WmiSetting
   

2. Se necessário, exiba as propriedades do objeto com uma chamada para a coleção Properties.

   Embora não seja necessário, talvez você queira saber o valor da propriedade antes de alterá-la.

   $mySettings.Properties
   

3. Faça alterações nas propriedades do objeto local.

   Isso altera apenas a cópia local. Para salvar suas alterações no WMI, você deve colocar a cópia inteira de volta no repositório WMI.

   $mySettings.LoggingLevel = 1
   

4. Coloque o objeto de volta no repositório WMI usando uma chamada para o método Put.

   $mySettings.Put()
   

O procedimento a seguir descreve como modificar ou atualizar uma instância usando C#.

Para modificar ou atualizar uma instância usando C# (Microsoft.Management.Infrastructure)

1. Recupere uma cópia local do objeto com uma chamada para CimSession.GetInstance, conforme descrito em Recuperar uma instância do WMI.

   using Microsoft.Management.Infrastructure;
   ...
   string Namespace = @"root\cimv2";
   string className = "win32_logicalDisk";
   
   CimInstance diskDrive = new CimInstance(className, Namespace);
   diskDrive.CimInstanceProperties.Add(CimProperty.Create("DeviceID", "C:", CimFlags.Key));
   
   CimSession session = CimSession.Create("localhost");
   CimInstance myDisk = session.GetInstance(Namespace, diskDrive);
   

2. Se necessário, exiba as propriedades do objeto com uma chamada para a coleção Properties.

   Embora não seja necessário, talvez você queira saber o valor da propriedade antes de alterá-la.

   foreach (CimProperty property in myDisk.CimInstanceProperties)
   {
      Console.WriteLine(property.ToString());
   }
   
   Console.ReadLine();
   

3. Faça alterações nas propriedades do objeto local.

   Isso altera apenas a cópia local. Para salvar suas alterações no WMI, você deve colocar a cópia inteira de volta no repositório WMI.

   myDisk.CimInstanceProperties["VolumeName"].Value = "NewName";
   

4. Coloque o objeto de volta no repositório do WMI usando uma chamada para CimSession.ModifyInstance.

   session.ModifyInstance(Namespace,myDisk);
   

O procedimento a seguir descreve como modificar ou atualizar uma instância usando o PowerShell.

Para modificar ou atualizar uma instância usando C# (Microsoft.Management)

1. Recupere uma cópia local do objeto com uma chamada para ManagementObject.Get.

   using System.Management;
   ...
   ManagementObject myDisk = new ManagementObject("Win32_LogicalDisk.DeviceID='C:'");
   myDisk.Get();
   

2. Se necessário, exiba as propriedades do objeto com uma chamada para a coleção Properties.

   Embora não seja necessário, talvez você queira saber o valor da propriedade antes de alterá-la.

   foreach (PropertyData property in myDisk.Properties)
   {
      Console.WriteLine(property.Name + " " + property.Value);
   }
   
   Console.ReadLine();
   

3. Faça alterações nas propriedades do objeto local.

   Isso altera apenas a cópia local. Para salvar suas alterações no WMI, você deve colocar a cópia inteira de volta no repositório WMI.

   myDisk["VolumeName"] = "newName";
   

4. Coloque o objeto de volta no repositório WMI usando uma chamada para o ManagementObject.Put ou método.

   myDisk.Put();
   

O procedimento a seguir descreve como modificar ou atualizar uma instância usando VBScript.

Para modificar ou atualizar uma instância usando o VBScript

1. Recupere uma cópia local do objeto com uma chamada para GetObject.

2. Se necessário, exiba as propriedades do objeto com uma chamada para o método Properties_.

   Embora não seja necessário, talvez você queira saber o valor da propriedade antes de alterá-la.

3. Faça alterações nas propriedades do objeto com uma chamada para o método SWbemProperty.Value.

   O método Value altera apenas a cópia local. Para salvar suas alterações no WMI, você deve colocar a cópia inteira de volta no repositório WMI.

4. Coloque o objeto de volta no repositório do WMI com uma chamada aos métodos SWbemObject.Put_ ou SWbemObject.PutAsync_.

Como os nomes implicam, Put_ é atualizado de forma síncrona enquanto PutAsync_ é atualizado de forma assíncrona. Qualquer um dos métodos copia pela instância original com a instância modificada. No entanto, para aproveitar o processamento assíncrono, você deve criar um objeto SWbemSink. Para obter mais informações, consulte Chamar um método.

O procedimento a seguir descreve como modificar ou atualizar uma instância usando C++.

Para modificar ou atualizar uma instância usando o C++

1. Recupere uma cópia local da instância com uma chamada para IWbemServices::GetObject ou IWbemServices::GetObjectAsync.

2. Se necessário, exiba as propriedades do objeto com uma chamada para o método IWbemClassObject::Get.

   Embora não seja necessário, talvez você queira saber o valor da propriedade antes de alterá-la.

3. Faça as alterações necessárias na cópia com uma chamada para IWbemClassObject::Put.

   O método Put altera apenas a cópia local. Para salvar suas alterações no WMI, você deve colocar a cópia inteira de volta no repositório WMI.

4. Coloque sua cópia de volta no repositório do WMI com uma chamada para os métodos IWbemServices::PutInstance ou IWbemServices::PutInstanceAsync.

   Como os nomes implicam, PutInstance é atualizado de forma síncrona enquanto PutInstanceAsync é atualizado de forma assíncrona. Qualquer um dos métodos copia pela instância original com a instância modificada. No entanto, para aproveitar o processamento assíncrono, você deve implementar a interface IWbemObjectSink.

   Você deve estar ciente de que uma operação de atualização em uma instância que pertence a uma hierarquia de classe pode não ter êxito devido a um erro envolvendo outra classe na hierarquia. O WMI chama o método PutInstanceAsync de cada um dos provedores responsáveis pelas classes das quais a classe que possui a instância original deriva. Se algum desses provedores falhar, a solicitação de atualização original falhará. Para obter mais informações , confira a seção Comentários de PutInstanceAsync.

Para obter mais informações, consulte Chamar um método Provider.