{"id":52793,"date":"2009-08-05T03:01:00","date_gmt":"2009-08-05T03:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2009\/08\/05\/hey-scripting-guy-can-windows-powershell-call-wmi-methods\/"},"modified":"2009-08-05T03:01:00","modified_gmt":"2009-08-05T03:01:00","slug":"hey-scripting-guy-can-windows-powershell-call-wmi-methods","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-can-windows-powershell-call-wmi-methods\/","title":{"rendered":"Hey, Scripting Guy! Can Windows PowerShell Call WMI Methods?"},"content":{"rendered":"

  <\/p>\n

\"Hey,<\/p>\n

\n

<\/span>Hey, Scripting Guy! I have seen a number of methods listed for WMI classes on MSDN, but when I try to use them in Windows PowerShell, they do not work. I am wondering what the secret is to making these things actually do something. I assume they are not really broken because I have VBScripts that I downloaded from the Script Center Script Repository that work just fine. So it must be a Windows PowerShell issue. Can Windows PowerShell call WMI methods?<\/p>\n

— DS<\/p>\n

\"Hey,H<\/span>ello DS, <\/p>\n

Microsoft Scripting Guy Ed Wilson here. I am feeling much better now that I have had a sufficient amount of sleep. The jet lag from my trip to Seattle, Washington, in the United States for the Microsoft TechReady conference is over. As one late twentieth century American philosopher<\/font><\/a> once stated, “I feel good.” I have my little blue tea pot with some nice Earl Grey tea and an ANZAC biscuit<\/font><\/a>. My friend Brett in Sydney, Australia, sent a couple of packages of ANZAC biscuits and Tim Tams<\/font><\/a> to me while I was in Seattle by way of another friend (Hemant) who was also attending the TechReady conference, which was good because I had run out of both. Because I now have a stash of ANZAC biscuits, I am sipping tea, munching an ANZAC biscuit, and listening to James Brown on my Zune. Yes, it is good to be home. <\/p>\n

DS, short answer: Yes, Windows PowerShell can call WMI methods. As an example, on Windows Server 2003 and later there is a really cool WMI class named Win32_Volume<\/b>. The reason I love this WMI class is because of the methods. The properties are easy to obtain by using the Get-WmiObject<\/b> cmdlet. (One thing that is cool is the system property __Property_Count<\/b>. This tells us there are 44 properties on the Win32_Volume<\/b> WMI class.) This is seen here: <\/p>\n

PS C:> Get-WmiObject -Class win32_volume<\/p>\n


__GENUS                      <\/span>: 2
__CLASS                      <\/span>: Win32_Volume
__SUPERCLASS                 <\/span>: CIM_StorageVolume
__DYNASTY                    <\/span>: CIM_ManagedSystemElement
__RELPATH                    <\/span>: Win32_Volume.DeviceID=”\\\\?\\Volume{a281f0f1-45
                               <\/span>07-11dc-be35-806e6f6e6963}\\”
__PROPERTY_COUNT   <\/span>          <\/span>: 44
__DERIVATION                 <\/span>: {CIM_StorageVolume, CIM_StorageExtent, CIM_Logic
                               <\/span>alDevice, CIM_LogicalElement…}
__SERVER                     <\/span>: VISTA
__NAMESPACE                  <\/span>: rootcimv2
__PATH            <\/span>           <\/span>: \\VISTArootcimv2:Win32_Volume.DeviceID=”\\\\?
                               <\/span>Volume{a281f0f1-4507-11dc-be35-806e6f6e6963}\\”
Access                       <\/span>:
Automount                    <\/span>: True
Availability                 <\/span>:
BlockSize       <\/span>             <\/span>: 4096
BootVolume                   <\/span>: True
Capacity                     <\/span>: 68716326912
Caption                      <\/span>: C:
Compressed                   <\/span>: False
ConfigManagerErrorCode       <\/span>:
ConfigManagerUserConfig      <\/span>:
CreationClassName      <\/span>      <\/span>:
Description                  <\/span>:
DeviceID                     <\/span>: \\?Volume{a281f0f1-4507-11dc-be35-806e6f6e6963}
                               <\/span>
DirtyBitSet                  <\/span>: False
DriveLetter                  <\/span>: C:
DriveType                    <\/span>: 3
ErrorCleared                 <\/span>:
ErrorDescription             <\/span>:
ErrorMethodology             <\/span>:
FileSystem                   <\/span>: NTFS
FreeSpace                    <\/span>: 51106398208
IndexingEnabled              <\/span>: False
InstallDate                  <\/span>:
Label           <\/span>             <\/span>:
LastErrorCode                <\/span>:
MaximumFileNameLength        <\/span>: 255
Name                         <\/span>: C:
NumberOfBlocks               <\/span>:
PageFilePresent              <\/span>: True
PNPDeviceID                  <\/span>:
PowerManagementCapabilities  <\/span>:
PowerManagementSupported     <\/span>:
Purpose                      <\/span>:
QuotasEnabled                <\/span>: False
QuotasIncomplete             <\/span>: False
QuotasRebuilding             <\/span>: False
SerialNumber                 <\/span>: 4241210807
Status                       <\/span>:
StatusInfo           <\/span>        <\/span>:
SupportsDiskQuotas           <\/span>: True
SupportsFileBasedCompression : True
SystemCreationClassName      <\/span>:
SystemName                   <\/span>: VISTA
SystemVolume                 <\/span>: True<\/p>\n

__GENUS                      <\/span>: 2
__CLASS                      <\/span>: Win32_Volume
__SUPERCLASS                 <\/span>: CIM_StorageVolume
__DYNASTY                    <\/span>: CIM_ManagedSystemElement
__RELPATH                    <\/span>: Win32_Volume.DeviceID=”\\\\?\\Volume{a281f0f4-45
                               <\/span>07-11dc-be35-806e6f6e6963}\\”
__PROPERTY_COUNT             <\/span>: 44
__DERIVATION                 <\/span>: {CIM_StorageVolume, CIM_StorageExtent, CIM_Logic
                               <\/span>alDevice, CIM_LogicalElement…}
__SERVER                     <\/span>: VISTA
__NAMESPACE                  <\/span>: rootcimv2
__PATH                       <\/span>: \\VISTArootcimv2:Win32_Volume.DeviceID=”\\\\?
                               <\/span>Volume{a281f0f4-4507-11dc-be35-806e6f6e6963}\\”
Access                       <\/span>:
Automount                    <\/span>: True
Availability                 <\/span>:
BlockSize                    <\/span>:
BootVolume                   <\/span>:
Capacity                     <\/span>:
Caption                      <\/span>: D:
Compressed                   <\/span>:
ConfigManagerErrorCode       <\/span>:
ConfigManagerUserConfig      <\/span>:
CreationClassName            <\/span>:
Description                  <\/span>:
DeviceID                     <\/span>: \\?Volume{a281f0f4-4507-11dc-be35-806e6f6e6963}
                               <\/span>
DirtyBitSet                  <\/span>:
DriveLetter                  <\/span>: D:
DriveType                    <\/span>: 5
ErrorCleared     <\/span>            <\/span>:
ErrorDescription             <\/span>:
ErrorMethodology             <\/span>:
FileSystem                   <\/span>:
FreeSpace                    <\/span>:
IndexingEnabled              <\/span>:
InstallDate                  <\/span>:
Label                        <\/span>:
LastErrorCode            <\/span>    <\/span>:
MaximumFileNameLength        <\/span>:
Name                         <\/span>: D:
NumberOfBlocks               <\/span>:
PageFilePresent              <\/span>:
PNPDeviceID                  <\/span>:
PowerManagementCapabilities  <\/span>:
PowerManagementSupported     <\/span>:
Purpose                      <\/span>:
QuotasEnabled                <\/span>:
QuotasIncomplete             <\/span>:
QuotasRebuilding             <\/span>:
SerialNumber                 <\/span>:
Status                       <\/span>:
StatusInfo                   <\/span>:
SupportsDiskQuotas           <\/span>:
SupportsFileBasedCompression :
SystemCreationClassName      <\/span>:
SystemName                   <\/span>: VISTA
SystemVolume                 <\/span>:<\/p>\n

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

One thing you will notice is that not all properties return data. One day, DS, I will show you a really cool way to take care of the missing property value problem (the technique is something I came up with while I was writing the 200 scripts for the Windows 7 Resource Kit<\/font><\/a>), but that is a subject for a future Hey, Scripting Guy! article. The thing that is important to notice here is that there are two instances of Win32_Volumes<\/b> returned in response to our query. If I were to run this script on my other desktop, I would have six instances of the Win32_Volume<\/b> class returned. Because there are multiple instances of the Win32_Volume<\/b> WMI class returned by the Get-WmiObject<\/b> cmdlet, it means that you cannot directly access the methods. This is in spite of the fact that the Get-Member<\/b> cmdlet clearly displays them as seen here:
 <\/span><\/p>\n

PS C:> Get-WmiObject -Class win32_volume | Get-Member -MemberType method<\/p>\n


   <\/span>TypeName: System.Management.ManagementObject#rootcimv2Win32_Volume<\/p>\n

Name           <\/span>MemberType Definition
—-           <\/span>———- ———-
AddMountPoint  <\/span>Method     <\/span>System.Management.ManagementBaseObject AddMountPoi…
Chkdsk         <\/span>Method     <\/span>System.Management.ManagementBaseObject Chkdsk(Syst…
Defrag         <\/span>Method     <\/span>System.Management.ManagementBaseObject Defrag(Syst…
DefragAnalysis Method     <\/span>System.Management.ManagementBaseObject DefragAnaly…
Dismount       <\/span>Method     <\/span>System.Management.ManagementBaseObject Dismount(Sy…
Format         <\/span>Method     <\/span>System.Management.ManagementBaseObject Format(Syst…
Mount          <\/span>Method     <\/span>System.Management.ManagementBaseObject Mount()
Reset          <\/span>Method     <\/span>System.Management.ManagementBaseObject Reset()
SetPowerState  <\/span>Method     <\/span>System.Management.ManagementBaseObject SetPowerSta…<\/p>\n

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

If you attempt to directly access any of the methods, an error will be generated. This is because WMI does not know which volume you wish to work with. This is seen here:
 <\/span><\/p>\n

PS C:> (Get-WmiObject -Class win32_volume).defragAnalysis()
Method invocation failed because [System.Object[]] doesn’t contain a method nam
ed ‘defragAnalysis’.
At line:1 char:51
+ (Get-WmiObject -Class win32_volume).defragAnalysis <<<< ()
    <\/span>+ CategoryInfo          <\/span>: InvalidOperation: (defragAnalysis:String) [], Ru
   <\/span>ntimeException
    <\/span>+ FullyQualifiedErrorId : MethodNotFound<\/p>\n

PS C:> $wmi = Get-WmiObject -Class win32_volume
PS C:> $wmi.DefragAnalysis()
Method invocation failed because [System.Object[]] doesn’t contain a method nam
ed ‘DefragAnalysis’.
At line:1 char:20
+ $wmi.DefragAnalysis <<<< ()
    <\/span>+ CategoryInfo          <\/span>: InvalidOperation: (DefragAnalysis:String) [], Ru
   <\/span>ntimeException
    <\/span>+ FullyQualifiedErrorId : MethodNotFound<\/span><\/p>\n

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

To work with the method, you will need to obtain a single instance of the class. There are a couple of ways to do this. You do not have to only have a single instance of the class, but you must be working with a single instance at a time. The easiest way to call the method is to use the Foreach-Object<\/b> cmdlet to work through the collection of Win32_Volumes<\/b>. To do this, you use the Get-WmiObject<\/b> cmdlet to query for all instances of the Win32_Volume<\/b>, and you use the pipeline to pass the objects to the Foreach-Object<\/b> cmdlet. Inside the script block for the Foreach-Object<\/b> cmdlet, you use the $_<\/b> automatic variable to refer to the current object on the pipeline. This allows you to call the DefragAnalysis<\/b> method. This technique is seen here:
 <\/span><\/p>\n

PS C:> Get-WmiObject -Class win32_volume | Foreach-Object { $_.DefragAnalysis()
 <\/span>}<\/p>\n


__GENUS           <\/span>: 2
__CLASS           <\/span>: __PARAMETERS
__SUPERCLASS      <\/span>:
__DYNASTY         <\/span>: __PARAMETERS
__RELPATH         <\/span>:
__PROPERTY_COUNT  <\/span>: 3
__DERIVATION      <\/span>: {}
__SERVER          <\/span>:
__NAMESPACE       <\/span>:
__PATH            <\/span>:
DefragAnalysis    <\/span>: System.Management.ManagementBaseObject
DefragRecommended : False
ReturnValue       <\/span>: 0<\/p>\n

__GENUS           <\/span>: 2
__CLASS           <\/span>: __PARAMETERS
__SUPERCLASS      <\/span>:
__DYNASTY         <\/span>: __PARAMETERS
__RELPATH         <\/span>:
__PROPERTY_COUNT  <\/span>: 3
__DERIVATION      <\/span>: {}
__SERVER    <\/span><\/span><\/font><\/p>\n","protected":false},"excerpt":{"rendered":"

  Hey, Scripting Guy! I have seen a number of methods listed for WMI classes on MSDN, but when I try to use them in Windows PowerShell, they do not work. I am wondering what the secret is to making these things actually do something. I assume they are not really broken because I have […]<\/p>\n","protected":false},"author":595,"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-52793","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":"

  Hey, Scripting Guy! I have seen a number of methods listed for WMI classes on MSDN, but when I try to use them in Windows PowerShell, they do not work. I am wondering what the secret is to making these things actually do something. I assume they are not really broken because I have […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/52793","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\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=52793"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/52793\/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=52793"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=52793"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=52793"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}