{"id":12261,"date":"2011-10-28T00:01:00","date_gmt":"2011-10-28T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/10\/28\/query-wmi-classes-by-using-powershell-and-wildcard-patterns\/"},"modified":"2011-10-28T00:01:00","modified_gmt":"2011-10-28T00:01:00","slug":"query-wmi-classes-by-using-powershell-and-wildcard-patterns","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/query-wmi-classes-by-using-powershell-and-wildcard-patterns\/","title":{"rendered":"Query WMI Classes by Using PowerShell and Wildcard Patterns"},"content":{"rendered":"

Summary:<\/strong> Learn how to query WMI classes using Windows PowerShell and wildcard character patterns by using a free Scripting Guy module.<\/span><\/span><\/p>\n

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

Microsoft Scripting Guy Ed Wilson here. Well, the Scripting Wife and I are finally settling down to a normal routine here in Charlotte, North Carolina, in the United States. Of course, that settling down will not last too long because next week we head out to California. I am speaking at a Microsoft internal conference for the premier field engineers (PFE) at a conference called Geek Week (Geek Ready). I am making two presentations to each of the three sessions, as well as sitting on a panel discussion. In addition, for session 1 I am having a special side meeting with the PFE Windows PowerShell special interest group. It will be lots of fun. Following that week, we head up to Orange County, California, where I will be conducting a special five day Windows PowerShell workshop for Microsoft Premier customers. So we will spend two weeks in sunny Southern California. Ah, the life of someone who knows Windows PowerShell.<\/span><\/p>\n

Anyway, I do need to mention something that happened to me on Monday. I changed the BIOS settings on my new laptop, and when I saved the changes, <\/span>BitLocker Recovery Password Viewer<\/span><\/a> for Active Directory Users and Computers. A quick call to the help desk, and I was back up and running. It was cool!<\/span><\/span><\/p>\n

I am continuing to work on my HSGWMIModule<\/b> and today I am up to version 5. <\/span><\/p>\n

Note<\/b>   This is part five of a multipart article on developing a WMI helper module. <\/span>On Monday<\/span><\/a>, I created the base WMI module, and included a couple of really great functions that query the WMI schema and return WMI class methods and properties. On Tuesday<\/span><\/a>, I added a function that returns the key property of a WMI class. This is useful when working with WMI instance methods. On Wednesday<\/span><\/a>, I created a function that will return the values of those key properties. Yesterday<\/span><\/a>, I added a HasWMIValue<\/b> filter to the module. Today, I add two functions. The first is a function that will query WMI classes using a wildcard character pattern. The second function is an Out-TempFile<\/b> function that accepts piped input and displays results in a temporary text file in Notepad. <\/span><\/span> <\/span><\/p>\n

Anoter Note<\/span><\/b>   The module for today’s blog post is on the <\/span>Copy-Modules function from my Windows PowerShell ISE module<\/span><\/a>. Using this technique, all you need to do is go to the Scripting Guys Script Repository, copy the module to the Clipboard, save it in your scratch directory, and use the Copy-Modules<\/b> function to copy it to your modules folder. If your scratch directory is c:\\fso, it is completely automatic. If it is not, I recommend you edit the Copy-Modules<\/b> function to use your scratch directory, which makes it really easy to use. The command and associated output are shown in the following figure.<\/span><\/span><\/p>\n

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

When the HSGWMIModuleV5<\/b> is installed, all of the functions and filters contained within the module become available when I import the module. I can do this in either the Windows PowerShell console or the Windows PowerShell ISE. I am going to use the Windows PowerShell console for now. I do not need to type the entire module name because the Import-Module<\/b> cmdlet accepts wildcard characters. After I import the module for the first time, I like to see which commands the module supports, so I use the Get-Command<\/b> cmdlet to display the commands. The two commands are shown here:<\/span><\/p>\n

Import-Module hsg*5<\/span><\/p>\n

Get-Command -Module hsg*5<\/span><\/p>\n

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

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

The Get-WmiClassesAndQuery<\/b> function accepts wildcard characters for the WMI class name. It then searches for WMI classes that match the pattern. Upon finding the classes, it determines which WMI classes are not abstract and it queries them. The portion of the function that returns a list of WMI classes that match a wildcard character pattern is shown here (supply the wildcard character pattern to the $class<\/b> variable):<\/span><\/p>\n

Get-WmiObject -List $class -Namespace $namespace -ComputerName $computer<\/span><\/p>\n

I use the same logic to determine dynamic classes I used in other functions in the HSGWMIModule*<\/b>. I examine the class qualifiers to find the abstract<\/b> qualifier. If the abstract<\/b> <\/i>qualifier appears, I skip the class. Here is that portion of the logic:<\/span><\/p>\n

ForEach-Object { <\/span><\/p>\n

   $abstract = $false<\/span><\/p>\n

   [wmiclass]$class = “\\\\{0}\\{1}:{2}” -f $computer,$namespace,$_.name<\/span><\/p>\n

  Foreach($q in $_.Qualifiers)<\/span><\/p>\n

   { if ($q.name -eq ‘Abstract’) {$abstract = $true} }<\/span><\/p>\n

  If(!$abstract)<\/span><\/p>\n

After all that work, it is a straightforward WMI query using the Get-WMIObject<\/b> cmdlet. I used parameter decorations to make the class <\/i>parameter mandatory in the first position, and accept pipeline input. Here is that parameter attribute:<\/span><\/p>\n

[Parameter(Mandatory=$true,Position=0,valueFromPipeline=$true)]<\/span><\/p>\n

I can use the function by directly passing a wildcard character to it, or I can use the parameters. These techniques are shown here:<\/span><\/p>\n

Get-WmiClassesAndQuery *disk*<\/span><\/p>\n

Get-WmiClassesAndQuery -class *disk* -namespace root\\wmi<\/span><\/p>\n

To run a query remotely you must have administrator rights. If you run the command with alternate credentials, you will need to supply the path to the module when you import it because the Copy-Modules<\/b> function installs into the current user profile location. Of course, if you run the Windows PowerShell ISE with alternate credentials when you use the Copy-Modules<\/b> function to perform the installation, you will already have the module in your alternate profile. The workaround is to manually install the module in the all users\/all hosts profile location. <\/span><\/p>\n

The Get-WmiClassesAndQuery<\/b> function really shines when combined with the HasWmiValue<\/b> filter and the Out-TempFile<\/b> function. The command is shown here:<\/span><\/p>\n

Get-WmiClassesAndQuery *adapter* | HasWmiValue | Out-TempFile<\/span><\/p>\n

The previous command queries every dynamic WMI class that contains the pattern adapter<\/b> <\/i>in the name. This includes Win32_NetworkAdapter<\/b> and Win32_NetworkAdapterConfiguration<\/b> as well as an associative class. The HasWmiValue<\/b> greatly reduces the amount of information that is displayed by removing empty properties, and the Out-TempFile<\/b> function makes it easy to peruse the returned data. The temp file is shown in the following figure.<\/span><\/p>\n

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

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

That is all there is to using the HSGWmiModuleV5<\/b>. WMI Week will continue tomorrow when I will add some aliases and other things to the HSGWmiModule<\/b>. Until tomorrow! <\/span><\/p>\n

I invite you to follow me on <\/span>Facebook<\/span><\/a>. If you have any questions, send email to me at <\/span>Official Scripting Guys Forum<\/span><\/a>. See you tomorrow. Until then, peace.<\/span><\/span><\/p>\n<\/p>\n

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

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

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

Summary: Learn how to query WMI classes using Windows PowerShell and wildcard character patterns by using a free Scripting Guy module.   Microsoft Scripting Guy Ed Wilson here. Well, the Scripting Wife and I are finally settling down to a normal routine here in Charlotte, North Carolina, in the United States. Of course, that settling […]<\/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-12261","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 query WMI classes using Windows PowerShell and wildcard character patterns by using a free Scripting Guy module.   Microsoft Scripting Guy Ed Wilson here. Well, the Scripting Wife and I are finally settling down to a normal routine here in Charlotte, North Carolina, in the United States. Of course, that settling […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/12261","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=12261"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/12261\/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=12261"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=12261"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=12261"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}