{"id":6651,"date":"2015-04-15T00:01:00","date_gmt":"2015-04-15T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2015\/04\/15\/create-custom-type-data-in-powershell-to-format-wmi-display\/"},"modified":"2019-02-18T10:29:53","modified_gmt":"2019-02-18T17:29:53","slug":"create-custom-type-data-in-powershell-to-format-wmi-display","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/create-custom-type-data-in-powershell-to-format-wmi-display\/","title":{"rendered":"Create Custom Type Data in PowerShell to Format WMI Display"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy, Ed Wilson, talks about creating custom type data to control the way a WMI class displays.<\/span><\/p>\n

\"Hey, Hey, Scripting Guy! Yesterday, you said you could create custom type data to control the way the Win32_Volume<\/b> WMI class reports back. How would one go about doing that? I looked on the Internet, and to be honest, it looks like it is basically impossible.<\/p>\n

—AT<\/p>\n

\"Hey, Hello AT,<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. I love this time of the year. All the windows are open, the azaleas are in bloom, and I am upstairs with my Surface Pro 3, a cup of orange-cream green tea, and a slice of artisan cheese. I also scored some organic grapes, and they are so sweet that I needed to add nothing to my tea this morning.<\/p>\n

AT, you are right. Yesterday in Comparing CIM and WMI in PowerShell<\/a>, I began talking about comparing the results of Get-Volume<\/b> with the Win32_Volume<\/b> WMI class.<\/p>\n

Obviously, if all of my systems are running Windows 8.1, there is no reason to mess around with using the WMI class. But if that is not the case, it makes sense to make things a bit easier to use.<\/p>\n

Create custom type data<\/h2>\n

I want to be able to update the type data for the Win32_Volume<\/b> WMI class. There is no custom type data, so I need to create something. Luckily, beginning with Windows PowerShell 3.0, this is super easy. I simply use the Update-TypeData<\/b> cmdlet. The hard parts are figuring out the type name that I am going to use and figuring out how to accomplish the task.<\/p>\n

From yesterday’s article, we know that the Win32_Volume<\/b> WMI class does not have any custom type data. However, the Win32_Bios<\/b> WMI class does. So I need to see how the Win32_Bios<\/b> WMI class type data is named:<\/p>\n

PS C:\\> gcim Win32_BIOS | Get-TypeName<\/p>\n

CimInstance#root\/cimv2\/Win32_BIOS<\/p>\n

PS C:\\> gwmi win32_bios | Get-TypeName<\/p>\n

ManagementObject#root\\cimv2\\Win32_BIOS<\/p>\n

But I want the full name, so I use a wildcard character to retrieve it. This is shown here:<\/p>\n

PS C:\\> "*win32_bios*" | Get-TypeData | select typename<\/p>\n

TypeName<\/p>\n

——–<\/p>\n

System.Management.ManagementObject#root\\cimv2\\Win32_BIOS<\/p>\n

Microsoft.Management.Infrastructure.CimInstance#root\/cimv2\/Win32_BIOS<\/p>\n

It appears that all I need to do is change the name of the WMI class on the end of the string. I decide my new type data name will be the following:<\/p>\n

Microsoft.Management.Infrastructure.CimInstance#root\/cimv2\/Win32_Volume<\/p>\n

This type data will control the way data returns from the Get-CimInstance<\/b> cmdlet. I am not going to bother to create type data for the Get-WmiObject<\/b> cmdlet, because this methodology requires Windows PowerShell 3.0 or later; therefore, the Get-CimInstance<\/b> cmdlet would be available anyway.<\/p>\n

As a test, I decide to create default properties. I use the Update-TypeData<\/b> cmdlet, and I specify the type name and the default properties. I store the type name in a variable named $dataType<\/b>. The second command is one long command. The command is shown here:<\/p>\n

$dataType = "Microsoft.Management.Infrastructure.CimInstance#root\/cimv2\/Win32_Volume"<\/p>\n

Update-TypeData -TypeName $DataType `<\/p>\n

 -DefaultDisplayPropertySet DriveLetter, DriveType, Label, FileSystem, FreeSpace, ` Capacity<\/p>\n

As shown here, when I use Get-CimInstance<\/b> to query Win32_Volume<\/b>, only the selected properties return:<\/p>\n

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

DriveLetter : C:<\/p>\n

DriveType   : 3<\/p>\n

Label       : SSD<\/p>\n

FileSystem  : NTFS<\/p>\n

FreeSpace   : 53269737472<\/p>\n

Capacity    : 159486308352<\/p>\n

DriveLetter : E:<\/p>\n

DriveType   : 3<\/p>\n

Label       : HybridTerrabyte<\/p>\n

FileSystem  : NTFS<\/p>\n

FreeSpace   : 392849973248<\/p>\n

Capacity    : 1000068870144<\/p>\n

DriveLetter :<\/p>\n

DriveType   : 3<\/p>\n

Label       : Recovery<\/p>\n

FileSystem  : NTFS<\/p>\n

FreeSpace   : 24080384<\/p>\n

Capacity    : 314568704<\/p>\n

If I attempt to update the type data, an error occurs. Here is the error message I receive:<\/p>\n

PS C:\\> E:\\Data\\ScriptingGuys\\2015\\HSG_4_13_15\\CreateTypeDataForVolumeClass.ps1<\/p>\n

Update-TypeData : Error in TypeData<\/p>\n

"Microsoft.Management.Infrastructure.CimInstance#root\/cimv2\/Win32_Volume": The member DefaultDisplayPropertySet is already present.<\/span><\/p>\n

At E:\\Data\\ScriptingGuys\\2015\\HSG_4_13_15\\CreateTypeDataForVolumeClass.ps1:11 char:1<\/p>\n

+ Update-TypeData -TypeName $DataType `<\/p>\n

+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~<\/p>\n

    + CategoryInfo          : InvalidOperation: (:) [Update-TypeData], RuntimeException<\/p>\n

    + FullyQualifiedErrorId : TypesDynamicUpdateException,Microsoft.PowerShell.Commands.UpdateTypeDataCommand<\/span><\/p>\n

I first need to remove the type data, and then I can update it. This command is shown here:<\/p>\n

"Microsoft.Management.Infrastructure.CimInstance#root\/cimv2\/Win32_Volume" |<\/p>\n

Get-TypeData | Remove-TypeData<\/p>\n

Add a script property<\/h2>\n

I see that the output from the drive type is coded. So, I look up the WMI class on MSDN, and add a script property to decode the numeric output. To do this, I use a simple Switch<\/b> statement:<\/p>\n

Switch ($this.psbase.CimInstanceProperties["DriveType"].value)<\/p>\n

  {<\/p>\n

   0 {"Unknown"}<\/p>\n

   1 {"No Root"}<\/p>\n

   2 {"Removable"}<\/p>\n

   3 {"Local Disk"}<\/p>\n

   4 {"Network Disk"}<\/p>\n

   5 {"Compact Disk"}<\/p>\n

   6 {"RAM Disk"}<\/p>\n

  }<\/p>\n

I keep my default property set, and I add a ScriptProperty <\/b>named DriveType<\/b>. The script block for the Switch<\/b> statement and to translate the value goes in the –Value<\/b> parameter. I use $this<\/b> to gain access to the value from the WMI class property. The revised command is shown here:<\/p>\n

$dataType = "Microsoft.Management.Infrastructure.CimInstance#root\/cimv2\/Win32_Volume"<\/p>\n

Update-TypeData -TypeName $DataType `<\/p>\n

 -DefaultDisplayPropertySet DriveLetter, DriveType, Label, FileSystem, FreeSpace, Capacity `<\/p>\n

 -MemberType ScriptProperty -MemberName DriveType -Value {<\/p>\n

  Switch ($this.psbase.CimInstanceProperties["DriveType"].value)<\/p>\n

  {<\/p>\n

   0 {"Unknown"}<\/p>\n

   1 {"No Root"}<\/p>\n

   2 {"Removable"}<\/p>\n

   3 {"Local Disk"}<\/p>\n

   4 {"Network Disk"}<\/p>\n

   5 {"Compact Disk"}<\/p>\n

   6 {"RAM Disk"}<\/p>\n

  }<\/p>\n

 }<\/p>\n

Now when I use Get-CimInstance<\/b> to query the Win32_Volume<\/b> WMI class, it comes back with nicely formatted output. This is shown in the following image:<\/p>\n

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

But it gets better! Because the custom type system works on all instances of the data type, it even works on remote systems. So I update the type data on my local computer, and when I query a remote computer (that has not been updated), the data is properly formatted. It is way cool. This technique is shown here:<\/span><\/p>\n

PS C:\\> $dataType = "Microsoft.Management.Infrastructure.CimInstance#root\/cimv2\/Win32_Volume"<\/span><\/p>\n

PS C:\\> Update-TypeData -TypeName $DataType `<\/p>\n

>>  -DefaultDisplayPropertySet DriveLetter, DriveType, Label, FileSystem, FreeSpace, Capacity `<\/span><\/p>\n

>>  -MemberType ScriptProperty -MemberName DriveType -Value {<\/p>\n

>>   Switch ($this.psbase.CimInstanceProperties["DriveType"].value)<\/p>\n

>>   {<\/p>\n

>>    0 {"Unknown"}<\/p>\n

>>    1 {"No Root"}<\/p>\n

>>    2 {"Removable"}<\/p>\n

>>    3 {"Local Disk"}<\/p>\n

>>    4 {"Network Disk"}<\/p>\n

>>    5 {"Compact Disk"}<\/p>\n

>>    6 {"RAM Disk"}<\/p>\n

>>   }<\/p>\n

>>  }<\/p>\n

>> <\/p>\n

PS C:\\> gcim Win32_Volume<\/p>\n

DriveLetter :<\/p>\n

DriveType   : Local Disk<\/p>\n

Label       : System Reserved<\/p>\n

FileSystem  : NTFS<\/p>\n

FreeSpace   : 331784192<\/p>\n

Capacity    : 366997504<\/p>\n

DriveLetter : C:<\/p>\n

DriveType   : Local Disk<\/p>\n

Label       :<\/p>\n

FileSystem  : NTFS<\/p>\n

FreeSpace   : 124714565632<\/p>\n

Capacity    : 135996108800<\/p>\n

DriveLetter : D:<\/p>\n

DriveType   : Compact Disk<\/p>\n

Label       :<\/p>\n

FileSystem  :<\/p>\n

FreeSpace   :<\/p>\n

Capacity    :<\/p>\n

PS C:\\> gcim Win32_Volume -CimSession dc1<\/p>\n

DriveLetter    : C:<\/p>\n

DriveType      : Local Disk<\/p>\n

Label          :<\/p>\n

FileSystem     : NTFS<\/p>\n

FreeSpace      : 125529444352<\/p>\n

Capacity       : 135810510848<\/p>\n

PSComputerName : dc1<\/p>\n

DriveLetter    :<\/p>\n

DriveType      : Local Disk<\/p>\n

Label          : Recovery<\/p>\n

FileSystem     : NTFS<\/p>\n

FreeSpace      : 62734336<\/p>\n

Capacity       : 314568704<\/p>\n

PSComputerName : dc1<\/p>\n

DriveLetter    : D:<\/p>\n

DriveType      : Compact Disk<\/p>\n

Label          :<\/p>\n

FileSystem     :<\/p>\n

FreeSpace      :<\/p>\n

Capacity       :<\/p>\n

PSComputerName : dc1<\/p>\n

AT, that is all there is to using Windows PowerShell to create custom type data to control the display of a WMI class. CIM Week will continue tomorrow when I will talk about more cool stuff.<\/p>\n

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

Ed Wilson, Microsoft Scripting Guy<\/b> <\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about creating custom type data to control the way a WMI class displays.  Hey, Scripting Guy! Yesterday, you said you could create custom type data to control the way the Win32_Volume WMI class reports back. How would one go about doing that? I looked on the Internet, and […]<\/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":[385,51,3,4,45],"class_list":["post-6651","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-cim","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about creating custom type data to control the way a WMI class displays.  Hey, Scripting Guy! Yesterday, you said you could create custom type data to control the way the Win32_Volume WMI class reports back. How would one go about doing that? I looked on the Internet, and […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6651","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=6651"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6651\/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=6651"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=6651"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=6651"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}