{"id":73621,"date":"2015-09-01T00:01:00","date_gmt":"2015-09-01T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2015\/09\/01\/powershell-5-create-simple-class\/"},"modified":"2019-02-18T09:35:24","modified_gmt":"2019-02-18T16:35:24","slug":"powershell-5-create-simple-class","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/powershell-5-create-simple-class\/","title":{"rendered":"PowerShell 5: Create Simple Class"},"content":{"rendered":"

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

Microsoft Scripting Guy, Ed Wilson, is here. The good news is that so far the weather person has been wrong—every single day for the last five days in a row. The bad news is that, well, unfortunately, I believed the weather person, and so I have been huddled in at home, looking out the windows for a storm that never arrived.<\/p>\n

We have had a little bit of rain, but not even the normal afternoon thunder storms. Guess I shouldn’t complain, but I was hoping to go take pictures of alligators over the weekend.<\/p>\n

The other good news is that I have had lots of time to play around with Windows PowerShell 5.0 in Windows 10 this weekend.<\/p>\n

   Note <\/b> This is the second post in the series about creating classes in Windows PowerShell 5.0. You should read
   Introduction to PowerShell 5 Classes<\/a> prior to reading today’s post.<\/p>\n

So yesterday, I wrote about classes. In general, and I talked about the process of designing a class. I cannot stress this too much:<\/p>\n

If you are going to create a class in Windows PowerShell, you must design it.<\/p>\n

Nothing is worse than to start writing a module, create a bunch of classes, and then all of a sudden, realize that you need to add (or worse yet, change) one or more properties.<\/p>\n

I say worse yet, because I always have the option of inheriting a class and adding properties to it. It may mess up my schema or my design, but I can inherit a class. What messes up things to the point that it requires major rewriting is deciding that a property I implemented as a single string suddenly needs to be an array…or that something that I implemented as a static property suddenly needs to be dynamically created. It is imperative that I properly design my class at the outset.<\/p>\n

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

         Dr. Scripto says<\/b>: One hour of design work will save 10 hours of rewrite work later.<\/p>\n

Use the Class keyword<\/h2>\n

The first thing I need to do is to use the Class<\/b> keyword. This is what creates the class. The syntax is exactly the same as creating a function:<\/p>\n

Keyword Name<\/p>\n

Opening brace<\/p>\n

Closing brace<\/p>\n

And there is stuff in the middle. I call these sandwich commands because there is bread on the outside, and the middle is where all the exciting stuff happens.<\/p>\n

So, to create the Car<\/b> class, I type:<\/p>\n

Class Car<\/p>\n

{<\/p>\n

}<\/p>\n

Then I add my properties. There are several options here. The default terminator is the end-of-line (carriage return line feed), but I can also use a semicolon. Depending on my mood, I prefer the invisible end-of-line terminator, and I place each property command on its own line.<\/p>\n

   Note <\/b> In other things, the Windows PowerShell automatic type system is great, and it works remarkably well. However,
   when creating classes that you really need—as in, you should (in fact, nearly must) specify the data type for each property.
   If you don’t, everything will simply be a System.Object, and will be pretty much useless. If you have a string, an int<\/b>, or a
   DateTime<\/b> object, you must specify that type so that things will work well.<\/p>\n

The first property I want to specify is the vehicle identification number (VIN). There probably is an exact pattern for this, and I could use a validation routine for that if it really mattered. For my example, it doesn’t matter, and I have no intention on typing more than a few numbers here.<\/p>\n

But when I have numbers separated by dashes, those numbers really become strings—and that is the point. Also, each vehicle has a single VIN, so I do not type an array. It is a single string. Here is my property (it is a System.String):<\/p>\n

[String]$vin<\/p>\n

   Note <\/b> The data type goes in square brackets, so that it will cast or constrain the data to be the specified type.<\/p>\n

There is a new keyword in Windows PowerShell 5.0 I can use when creating classes: Static<\/b>. <\/i>All cars have four wheels (at least for this example), and so, I simply assign that value here. It will be a static property, meaning it is always available. Even if I don’t create an instance of the class Car<\/b>, I will be able to figure out that cars have four wheels.<\/p>\n

Because the numberOfWheels<\/b> property is the number 4, I cast the property to be an integer by using [int]<\/b>. I could have made it an [int16]<\/b> instead of the default [int32]<\/b> that [int]<\/b> creates, but hey, I am not being that specific.<\/p>\n

static [int]$numberOfWheels = 4<\/p>\n

   Note <\/b> What’s the difference between [int16]<\/b> and [int32]<\/b>?The short answer is the size of the number that it will hold.
   The specific answer? Check the MaxValue<\/b> static property, as shown here:<\/p>\n

PS C:\\> [int16]::MaxValue<\/p>\n

32767<\/p>\n

PS C:\\> [int32]::MaxValue<\/p>\n

2147483647<\/p>\n

Now, I need to define the numberOfDoors<\/b> property. It could be 2, 4, 5, or more. So I also cast it as an [int]<\/b>. But because the value could be a lot of different things, I do not make it static. This is shown here:<\/p>\n

[int]$numberOfDoors<\/p>\n

The Year<\/b> property could also be an [int]<\/b>. But I decided to make it a [DateTime]<\/b> object so that I would have access to the properties and methods that a System.DateTime object exposes. I only need to cast the value (constrain) as [datetime]<\/b>, and when I put in my year, Windows PowerShell will convert it to a System.DateTime object. It will fill in other stuff as required. This is shown here:<\/p>\n

[datetime]$year<\/p>\n

Now I need to add in the Model<\/b> of the car. This is a simple string:<\/p>\n

[String]$model<\/p>\n

So that is it. Here is the complete class:<\/p>\n

Class Car<\/p>\n

{<\/p>\n

    [String]$vin<\/p>\n

    static [int]$numberOfWheels = 4<\/p>\n

    [int]$numberOfDoors<\/p>\n

    [datetime]$year<\/p>\n

    [String]$model<\/p>\n

}<\/p>\n

Create an instance of the class<\/h2>\n

I can use the New-Object<\/b> cmdlet to create an instance of the Car<\/b> class:<\/p>\n

$chevy = New-Object car<\/p>\n

I can use the Static<\/b> property operator to view my static property:<\/p>\n

PS C:\\> $chevy::numberOfWheels<\/p>\n

4<\/p>\n

The class and the output from the class are shown here in the Windows PowerShell ISE:<\/p>\n

Now I can simply assign values to the new Car<\/b> object that is stored in my $chevy<\/b> variable:<\/p>\n

PS C:\\> $chevy.vin = 12345<\/p>\n

PS C:\\> $chevy.numberOfDoors = 2<\/p>\n

PS C:\\> $chevy.year = "5\/1\/2015"<\/p>\n

PS C:\\> $chevy.model = "Camero"<\/p>\n

When I view the contents of the $chevy<\/b> variable, I can see my Car<\/b> object:<\/p>\n

PS C:\\> $chevy<\/p>\n

vin   numberOfDoors     year        model<\/p>\n

—   ————-              —-          —–<\/p>\n

12345    2 5\/1\/2015 12:00:00 AM Camero<\/p>\n

That's how you create a simple class in Windows PowerShell 5.0. Windows PowerShell Classes Week will continue tomorrow when I will talk about adding more stuff to the Windows PowerShell class.<\/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><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Ed Wilson, Microsoft Scripting Guy, talks about creating a simple class in Windows PowerShell 5.0 in Windows 10. Microsoft Scripting Guy, Ed Wilson, is here. The good news is that so far the weather person has been wrong—every single day for the last five days in a row. The bad news is that, well, […]<\/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":[615,609,3,4,608,45],"class_list":["post-73621","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-classes","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 a simple class in Windows PowerShell 5.0 in Windows 10. Microsoft Scripting Guy, Ed Wilson, is here. The good news is that so far the weather person has been wrong—every single day for the last five days in a row. The bad news is that, well, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/73621","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=73621"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/73621\/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=73621"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=73621"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=73621"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

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