{"id":12341,"date":"2011-10-20T00:01:00","date_gmt":"2011-10-20T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/10\/20\/use-the-set-wmiinstance-powershell-cmdlet-to-ease-configuration\/"},"modified":"2011-10-20T00:01:00","modified_gmt":"2011-10-20T00:01:00","slug":"use-the-set-wmiinstance-powershell-cmdlet-to-ease-configuration","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-the-set-wmiinstance-powershell-cmdlet-to-ease-configuration\/","title":{"rendered":"Use the Set-WmiInstance PowerShell Cmdlet to Ease Configuration"},"content":{"rendered":"

Summary:<\/strong> Learn how to use the Set-WmiInstance<\/strong> Windows PowerShell cmdlet to ease configuration of computers.<\/span><\/span><\/p>\n

 <\/span><\/p>\n

\"Hey,<\/span>Hey, Scripting Guy! I was using the Get-Command<\/b> cmdlet to look at what things I can do with Windows PowerShell, and I noticed a cmdlet called Set-WmiInstance<\/b>. I looked at the help, but I don’t get it. What is the big deal? <\/span><\/p>\n

—BL<\/span><\/p>\n

 <\/span><\/p>\n

\"Hey,<\/span>Hello BL, <\/span><\/p>\n

Microsoft Scripting Guy Ed Wilson here. Well, the Scripting Wife and I have had a lot of fun in Montreal this week. In a few days, we will be leaving and heading home. The Windows PowerShell class I have been teaching this week has been great, and the students have asked many good questions. In addition, they have given me many ideas for Hey, Scripting Guy! Posts for the future. These questions and ideas usually take the shape of, I am trying to do such and such, but I am having a hard time finding out what I need to do.<\/i><\/span><\/p>\n

BL, the Set-WmiInstance<\/b> cmdlet is cool, but using it can be a bit complicated. The class <\/i>parameter sets a property directly on a WMI class. Unfortunately, this works only on singleton WMI classes, of which there are very few. The one singleton class used by network administrators is Win32_Operatingsystem<\/b>, but unfortunately, it does not work with the class <\/i>parameter. Therefore, I only use the Set-WmiInstance<\/b> cmdlet with the path <\/i>parameter. The trick to using the Set-WmiInstance<\/b> class with the path <\/i>parameter is to know what a WMI path actually is and how to retrieve the WMI path for a WMI instance of a class. <\/span><\/p>\n

Note<\/b>   In the help files, the example uses the Win32_WMISetting<\/b>, and it changes the logginglevel<\/b> <\/i>property. This works on Windows Server 2003 and earlier, but beginning with Windows Vista, WMI uses ETL logs and does not use this legacy parameter. <\/span><\/p>\n

One of the good things about working with a singleton class is that the path to the class is easy. The path is the WMI class name equals the @ symbol. This translates into syntax such as that shown here:<\/span><\/p>\n

WMISingleTonClass=@<\/span><\/p>\n

When using the Set-WmiInstance<\/b> on a WMI class, the property to be set uses a hash table as it passes to the arguments <\/i>parameter. The pairs are the property name and the value to assign to the property name. An example of this syntax is shown here:<\/span><\/p>\n

@{propertyName=Value}<\/span><\/p>\n

To assign a new description to the Win32_OperatingSystem<\/b> singleton class, I perform the following steps (these steps require administrator rights on the target computer):<\/span><\/p>\n

    \n
  1. I use the Set-WmiInstance class<\/span><\/span><\/li>\n
  2. I supply the path to the Win32_OperatingSystem class to the path <\/i>parameter<\/span><\/span><\/li>\n
  3. I create a hash table using the WMI property name and the value to update the property with<\/span><\/span><\/li>\n<\/ol>\n

    The following command illustrates this technique:<\/span><\/p>\n

    Set-WmiInstance -Path win32_operatingsystem=@ -argument @{description=”iammred”}<\/span><\/p>\n

    If I did not have the Set-WmiInstance<\/b> cmdlet, I would need to use several steps to set the Operating System<\/b> description property. The steps required to assign a new value to the description<\/b> <\/i>property of the Win32_OperatingSystem<\/b> class are shown here:<\/span><\/p>\n

      \n
    1. Use the Get-WmiObject<\/b> cmdlet to retrieve an instance of the Win32_Operatingsystem<\/b> WMI class.<\/span><\/span><\/li>\n
    2. Store the returned management object in a variable.<\/span><\/span><\/li>\n
    3. Assign a new value for the description<\/b> <\/i>property.<\/span><\/span><\/li>\n
    4. Call the put<\/b> <\/i>method to write the information back to WMI.<\/span><\/span><\/li>\n<\/ol>\n

      The following commands illustrate this technique (the commands must run with elevated permissions):<\/span><\/p>\n

      $os = Get-WmiObject –class win32_operatingsystem<\/span><\/p>\n

      $os.Description = “MyNewDescription”<\/span><\/p>\n

      $os.put()<\/span><\/p>\n

      The situation changes a bit when working with a WMI class that is not a singleton. For example, if I query the Win32_logicalDrive<\/b> WMI class on my laptop, three instances of the class appear. If I limit the results to only fixed local disks (drivetype = 3<\/b>), I have two instances of the WMI class. The commands and associated output are shown in the following figure.<\/span><\/p>\n

      \"Image<\/a><\/span><\/p>\n

      To use the path <\/i>parameter of the Set-WmiInstance<\/b> cmdlet requires the path to a specific instance of the WMI class. The following WMI command returns the name of each logical disk and the path to each fixed logical disk. <\/span><\/p>\n

      PS C:\\> Get-WmiObject -Class win32_logicaldisk -Filter {drivetype=3} | select name, __path<\/span><\/p>\n

       <\/span><\/p>\n

      name<\/span>                                                        __PATH<\/span><\/p>\n

      C:                                                          \\\\MRED\\root\\cimv2:Win32_LogicalDisk.DeviceID=”C:”<\/span><\/p>\n

      Q:                                                          \\\\MRED\\root\\cimv2:Win32_LogicalDisk.DeviceID=”Q:”<\/span><\/p>\n

       <\/span><\/p>\n

      The important port to focus on right now is the result of the query that returns the __path<\/b> property. The WMI path represented here comprises five parts. The parts in the __Path<\/b> are shown in the following table.<\/span><\/p>\n

       <\/span><\/p>\n\n\n\n\n
      \n

      Computer<\/span><\/b><\/span><\/p>\n<\/td>\n

      		\n

      Namespace<\/span><\/b><\/span><\/p>\n<\/td>\n

      		\n

      Class<\/span><\/b><\/span><\/p>\n<\/td>\n

      		\n

      Key Property<\/span><\/b><\/span><\/p>\n<\/td>\n

      		\n

      Value<\/span><\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

      \n

      \\\\MRED<\/span><\/p>\n<\/td>\n

      		\n

      root\\cimv2<\/span><\/p>\n<\/td>\n

      		\n

      Win32_LogicalDisk<\/span><\/p>\n<\/td>\n

      		\n

      DeviceID<\/span><\/p>\n<\/td>\n

      		\n

      C:<\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

       <\/span><\/p>\n

      If I want to change the Volumename<\/b> on the C: drive, I use the Set-WmiInstance<\/b> cmdlet as shown here (this command must run with elevated rights):<\/span><\/p>\n

      Set-WmiInstance -Path ‘\\\\MRED\\root\\cimv2:Win32_LogicalDisk.DeviceID=”C:”‘ -argument @{VolumeName=”newlabel”}<\/span><\/p>\n

      The command and associated output are shown in the following figure.<\/span><\/p>\n

      <\/span> \"Image<\/a><\/p>\n

      Now, if I were to change the volume name using the Get-WmiObject<\/b> cmdlet, I would use the syntax that is shown here:<\/span><\/p>\n

      $disk = Get-WmiObject -Class win32_logicaldisk -Filter “deviceID=’c:'”<\/span><\/p>\n

      $disk.VolumeName = “mycustomlabel”<\/span><\/p>\n

      $disk.Put()<\/span><\/p>\n

      In light of the long required path for the Set-WmiInstance<\/b> command, it might appear the previous Get-WmiObject<\/b> cmdlet exposes the property modification capability easier. It is possible to combine the best of both worlds. I use the Get-WmiObject<\/b> cmdlet to retrieve the __Path<\/b> property to the C: drive, and I store it in the $path<\/b> variable. I then use that path with the Set-WmiInstance<\/b> cmdlet. The resultant command is two lines instead of the three lines required for the other method. <\/span><\/p>\n

      The command to combine the two techniques is shown here:<\/span><\/p>\n

      $path = (Get-WmiObject -Class win32_logicaldisk -Filter “deviceID=’c:'”).__path<\/span><\/p>\n

      Set-WmiInstance -Path $path -argument @{VolumeName=”test”}<\/span><\/p>\n

       <\/span><\/p>\n

      In the following figure, the first line illustrates the technique of obtaining the __path<\/b> directly from the Get-WmiObject<\/b> cmdlet. The second line displays the path. The third line stores the path in the $path<\/b> variable, and the fourth line is the Set-WMiInstance<\/b> command. <\/span><\/p>\n

      \"Image<\/a><\/span><\/p>\n

      <\/span><\/p>\n

      Well, BL, that is all there is to using the Set-WmiInstance<\/b> cmdlet. I hope you found the discussion helpful. To everyone who has tuned in; I invite you to join me tomorrow. <\/span> <\/span><\/p>\n

      I invite you to follow me on <\/span>Twitter<\/span><\/a><\/span> and <\/span>Facebook<\/span><\/a><\/span>. If you have any questions, send email to me at <\/span>scripter@microsoft.com<\/span><\/a><\/span>, or post your questions on the <\/span>Official Scripting Guys Forum<\/span><\/a><\/span>. See you tomorrow. Until then, peace.<\/span><\/span><\/p>\n

      <\/span><\/span><\/p>\n

      Ed Wilson, Microsoft Scripting Guy<\/b><\/span><\/p>\n

      <\/b><\/span> <\/p>\n

      <\/b><\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

      Summary: Learn how to use the Set-WmiInstance Windows PowerShell cmdlet to ease configuration of computers.   Hey, Scripting Guy! I was using the Get-Command cmdlet to look at what things I can do with Windows PowerShell, and I noticed a cmdlet called Set-WmiInstance. I looked at the help, but I don’t get it. What is […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[3,4,45,6],"class_list":["post-12341","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell","tag-wmi"],"acf":[],"blog_post_summary":"

      Summary: Learn how to use the Set-WmiInstance Windows PowerShell cmdlet to ease configuration of computers.   Hey, Scripting Guy! I was using the Get-Command cmdlet to look at what things I can do with Windows PowerShell, and I noticed a cmdlet called Set-WmiInstance. I looked at the help, but I don’t get it. What is […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/12341","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=12341"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/12341\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=12341"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=12341"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=12341"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}