{"id":73741,"date":"2015-08-26T00:01:00","date_gmt":"2015-08-26T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2015\/08\/26\/new-powershell-5-feature-enumerations\/"},"modified":"2019-02-18T09:35:28","modified_gmt":"2019-02-18T16:35:28","slug":"new-powershell-5-feature-enumerations","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/new-powershell-5-feature-enumerations\/","title":{"rendered":"New PowerShell 5 Feature: Enumerations"},"content":{"rendered":"

Summary<\/b>: Ed Wilson, Microsoft Scripting Guy, talks about creating enumerations in Windows PowerShell 5.0.<\/span><\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. It is nearly a stealth feature in Windows PowerShell 5.0—there is an Enum<\/b> keyword. Yep, that's right, there is an Enum<\/b> keyword. I wonder what it does? Probably has something to do with creating enums.<\/p>\n

Is this a big deal? You betcha…as they may say in some places.<\/p>\n

Why? Because prior to Windows PowerShell 5.0, you had to basically create an enum by using C# kinds of code, and then adding it as a type. Did it work? Sure it did. Was it Windows PowerShell? Well, in that it actually worked and I wrote it in Windows PowerShell—sure it was Windows PowerShell.<\/p>\n

Note<\/b>  For reference, refer to my Hey, Scripting Guy! Blog post The Fruity Bouquet of Windows PowerShell Enumerations<\/a>.<\/p>\n

Before PowerShell 5.0<\/h2>\n

Before Windows PowerShell 5.0, if I wanted to create an enumeration, I basically wrote inline C# code. Here is an example that creates a simple enumeration that assigns numeric values to three different types of fruit:<\/p>\n

# Create-FruitEnum.ps1<\/p>\n

$enum = "<\/p>\n

namespace myspace<\/p>\n

{<\/p>\n

public enum fruit<\/p>\n

{<\/p>\n

apple = 29, pear = 30, kiwi = 31<\/p>\n

}<\/p>\n

}<\/p>\n

"<\/p>\n

Add-Type -TypeDefinition $enum -Language CSharpVersion3<\/p>\n

This is pretty cool code, and the fact that I could create a custom enum in a scripting language was pretty wild. I wrote this code in 2010, and it has worked ever since. In fact, nothing has improved in this regards in the past five years–—until Windows PowerShell 5.0 came out in Windows 10.<\/p>\n

Use the enum keyword<\/h2>\n

So, whereas I used to have to create a giant string, with embedded C# code, and then use the Add-Type command to add in C# code, now I have an enum keyword. This makes the code much cleaner, and very easy to use.<\/p>\n

I use the enum keyword and assign a name for the enum. I then open and close a script block. This appears here:<\/p>\n

Enum Fruit<\/p>\n

{<\/p>\n

}<\/p>\n

Now I simply assign numeric values for each property:<\/p>\n

Enum Fruit<\/p>\n

{<\/p>\n

 Apple = 29<\/p>\n

 Pear = 30<\/p>\n

 Kiwi = 31<\/p>\n

}<\/p>\n

When I run my script, it creates the enum. I can then access each property as a static property. This is shown here:<\/p>\n

PS C:\\Users\\mredw> [fruit]::Apple<\/p>\n

Apple<\/p>\n

The cool thing is that IntelliSense pops up and shows the permissible members:<\/p>\n

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

That is all there is to using enumerations in Windows PowerShell 5.0.  Join me 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: Ed Wilson, Microsoft Scripting Guy, talks about creating enumerations in Windows PowerShell 5.0. Microsoft Scripting Guy, Ed Wilson, is here. It is nearly a stealth feature in Windows PowerShell 5.0—there is an Enum keyword. Yep, that's right, there is an Enum keyword. I wonder what it does? Probably has something to do with creating […]<\/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":[148,609,3,4,608,45],"class_list":["post-73741","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-enum","tag-powershell-5","tag-scripting-guy","tag-scripting-techniques","tag-windows-10","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Ed Wilson, Microsoft Scripting Guy, talks about creating enumerations in Windows PowerShell 5.0. Microsoft Scripting Guy, Ed Wilson, is here. It is nearly a stealth feature in Windows PowerShell 5.0—there is an Enum keyword. Yep, that's right, there is an Enum keyword. I wonder what it does? Probably has something to do with creating […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/73741","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=73741"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/73741\/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=73741"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=73741"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=73741"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}