![\"Bookmark](\"http:\/\/s7.addthis.com\/static\/btn\/v2\/lg-share-en.gif\")
<\/a><\/p>\nMicrosoft Scripting Guy Ed Wilson here. The Scripting Wife and I are on the road again. She is driving, and I am playing around with Windows PowerShell enumerations. Teresa made friends with a couple we met in the concierge lounge of our hotel in Lisbon while I was teaching a month’s worth of Windows PowerShell workshops. She has remained friends with them ever since, and this weekend we are meeting in Chattanooga, Tennessee, to see the Glen Miller Orchestra. The good thing about having a power adapter in the car is I can write scripts during the entire journey—from that perspective there is no difference from being at home or on the road. Well, there is one thing that is different: I do not have good Internet access from the car. It is true I can use my Windows Mobile device to search the Internet, and if I tried, I bet I could make it emulate a modem for my laptop, but that is more trouble than it is worth. The cool thing is that Windows PowerShell is largely self-documenting, which means I can use the Get-Member<\/strong> cmdlet to discover methods and properties of objects. <\/p>\n I have been playing around with enumerations in Windows PowerShell since last weekend, and I decided to see how I would use one in a script. Using the myspace.fruit<\/strong> enumeration I created last week, I can use an enumeration value to branch out to different parts of a script. I can also check to see if the enumeration is legitimate or not. The Get-FruitEnumDemo_enumContains.ps1 script illustrates this technique. After the myspace.fruit<\/strong> enumeration has been loaded into memory, the Get-Fruit<\/strong> function accepts an enumeration value. The contains<\/strong> operator is used to see if the enumeration exists; a switch<\/strong> statement performs different actions based upon the enumeration value. If the enumeration does not exist, a message is displayed that states the enumeration is not valid and displays the permissible values. The Get-FruitEnumDemo_enumContains.ps1 script is shown here. <\/p>\n Get-FruitEnumDemo_enumContains.ps1<\/strong><\/p>\n Function Get-Fruit A string is passed to the Get-Fruit<\/strong> function via the $enumvalue<\/strong> parameter. An if<\/strong> statement first retrieves all permissible values for the enumeration, and then uses the contains<\/strong> operator to see if the supplied value exists. This is shown here:<\/p>\n Function Get-Fruit The switch statement evaluates an actual enumeration value, but a string was passed to the function. To correct this, the parse<\/strong> static method from the system.enum<\/strong> .NET Framework class is used. It accepts two arguments: the first is an enum<\/strong> and the second is an enum<\/strong> value. The string myspace.fruit<\/strong> is cast into an enum<\/strong> (or a type) by using the [type]<\/strong> type constraint:<\/p>\n [enum]::parse([type]”myspace.fruit”,$enumValue)<\/span><\/p>\n The parse<\/strong> method translates the string into an actual instance of the enumeration. This is shown here:<\/p>\n PS C:\\Users\\ed.NWTRADERS> [enum]::parse([type]”myspace.fruit”,”pear”) If you supply a value that is not part of the enumeration, the parse<\/strong> method throws an error as shown here:<\/p>\n PS C:\\Users\\ed.NWTRADERS> [enum]::parse([type]”myspace.fruit”,”peach”) That situation (parse throwing an error) should never occur because the contains<\/strong> operator used to determine the supplied value is actually part of the enumeration. After the parse method has converted the string into an instance of the enumeration, the switch statement is smart enough to match it. When a match is found, the appropriate script block is called. In this demo, switch displays a string, but this could be a decision matrix that calls other functions or Windows PowerShell cmdlets:<\/p>\n { If the enumeration value is not found, a message is displayed that lists the permissible enumeration values. This is shown here:<\/p>\n else { When the script runs and an invalid enumeration is submitted, the following output is displayed. <\/p>\n <\/p>\n If you want to know exactly what we will be looking at tomorrow, follow us on Twitter<\/a> or Facebook<\/a>. If you have any questions, send e-mail to us 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 and Craig Liebendorfer, Scripting Guys<\/strong><\/p>\n Microsoft Scripting Guy Ed Wilson here. The Scripting Wife and I are on the road again. She is driving, and I am playing around with Windows PowerShell enumerations. Teresa made friends with a couple we met in the concierge lounge of our hotel in Lisbon while I was teaching a month’s worth of Windows […]<\/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":[148,51,3,61,45],"class_list":["post-18011","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-enum","tag-getting-started","tag-scripting-guy","tag-weekend-scripter","tag-windows-powershell"],"acf":[],"blog_post_summary":" Microsoft Scripting Guy Ed Wilson here. The Scripting Wife and I are on the road again. She is driving, and I am playing around with Windows PowerShell enumerations. Teresa made friends with a couple we met in the concierge lounge of our hotel in Lisbon while I was teaching a month’s worth of Windows […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/18011","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=18011"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/18011\/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=18011"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=18011"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=18011"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
{
Param($enumvalue)
if([enum]::Getvalues([myspace.fruit]) -contains $enumValue)
{
switch ([enum]::parse([type]”myspace.fruit”,$enumValue))
{
([myspace.fruit]::apple) { “Apples are good” }
([myspace.fruit]::pear) { “Pears are yummy” }
([myspace.fruit]::kiwi) { “Kiwis are great” }
} #end switch
} # end if
else {
“Your enumeration is invalid. Please use one of the following values:”
[enum]::getValues([myspace.fruit])
}
} #end function
Get-Fruit “plum”<\/span><\/p>\n
{
Param($enumvalue)
if([enum]::Getvalues([myspace.fruit]) -contains $enumValue)
{<\/span><\/p>\n
pear
PS C:\\Users\\ed.NWTRADERS> [enum]::parse([type]”myspace.fruit”,”pear”).Gettype()
IsPublic IsSerial Name BaseType
——– ——– —- ——–
True True fruit System.Enum<\/span><\/p>\n
Exception calling “Parse” with “2” argument(s): “Requested value ‘peach’ was not found.”
At line:1 char:14
+ [enum]::parse <<<< ([type]”myspace.fruit”,”peach”)
+ CategoryInfo : NotSpecified: (:) [], MethodInvocationException
+ FullyQualifiedErrorId : DotNetMethodException<\/span><\/p>\n
([myspace.fruit]::apple) { “Apples are good” }
([myspace.fruit]::pear) { “Pears are yummy” }
([myspace.fruit]::kiwi) { “Kiwis are great” }
} #end switch<\/span><\/p>\n
“Your enumeration is invalid. Please use one of the following values:”
[enum]::getValues([myspace.fruit])
}<\/span><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/4213.wes061910011_3C947ECE.jpg\" "\\"Image")
<\/a><\/p>\n
<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"