{"id":13811,"date":"2011-05-27T00:01:00","date_gmt":"2011-05-27T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/05\/27\/use-a-simple-powershell-technique-to-create-random-numbers\/"},"modified":"2011-05-27T00:01:00","modified_gmt":"2011-05-27T00:01:00","slug":"use-a-simple-powershell-technique-to-create-random-numbers","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-a-simple-powershell-technique-to-create-random-numbers\/","title":{"rendered":"Use a Simple PowerShell Technique to Create Random Numbers"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy, Ed Wilson, teaches you how to use a simple Windows PowerShell cmdlet to create random numbers.<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. One of the questions I received when I was speaking at the SQL Rally in Orlando, Florida was whether I prefer working in the Windows PowerShell console, or do I prefer to use the Windows PowerShell ISE and write a script. <\/p>\n

The answer, for me, is both. On any given day, I will start Windows PowerShell more than a dozen times. How do I know this? Well, I use Windows PowerShell to tell me. The following command queries the Windows PowerShell log for instances of event 400 that have been generated since April 1, 2011. Event 400 is generated each time Windows PowerShell starts up. <\/p>\n

To get the Windows PowerShell event log, I use the Get-EventLog<\/b> Windows PowerShell cmdlet. Because I do not like typing, I use wild cards to specify the PowerShell log. The results of the query return every event in the event log. I pipe that to the Where-Object<\/b> cmdlet to filter everything except the event ID 400 and dates after April 1, 2011. The Measure-Object<\/b> cmdlet counts the number of events that make it through the filter. <\/p>\n

\n

Get-EventLog -LogName *power* | <\/span><\/span><\/span><\/p>\n

Where-Object { $_.instanceID -eq 400 -AND $_.timewritten -gt “4\/1\/2011”} | <\/span><\/span><\/span><\/p>\n

measure-object <\/span><\/span><\/span><\/p>\n<\/blockquote>\n

The Windows PowerShell event 400 is generated when the Windows PowerShell engine transitions to running. An example of this event is shown here.<\/p>\n

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

Anyway, during the 2011 Scripting Games, I needed to generate 10 random numbers that began with the number 2 and were a maximum of 20. This can be accomplished by using the following command line: <\/p>\n

\n

1..10 | % {Get-Random -Minimum 2 -Maximum 20 }<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

In the command, I create a range of numbers, 1 through 10. I pipe them to the Foreach-Object<\/b> cmdlet (%<\/b> is an alias). Inside the Foreach-Object<\/b> cmdlet, I process the Get-Random<\/b> cmdlet and use the minimum<\/b> of 2<\/b> and the maximum<\/b> of 20<\/b>. The command and its associated output are shown here: <\/p>\n

\n

PS C:\\> 1..10 | % {Get-Random -Minimum 2 -Maximum 20 }<\/span><\/span><\/span><\/p>\n

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

8<\/span><\/span><\/span><\/p><\/blockquote>\n

The problem with this output is that there are duplicate numbers in the output. One thing that can be done is to pipe the output to the Get-Unique<\/b> cmdlet. The problem with this is that the output must be sorted. To sort the output, I can use the Sort-Object<\/b> cmdlet. The cool thing is that the Sort-Object<\/b> cmdlet has a Unique<\/i> parameter, which makes using Get-Unique<\/b> redundant. The revised command is shown here:<\/p>\n

\n

PS C:\\> 1..10 | % {Get-Random -Minimum 2 -Maximum 20 } | Sort -Unique<\/span><\/span><\/span><\/p>\n

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

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

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

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

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

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

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

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

19<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Now I have another problem. I do not have 10 random numbers. I only have 9 because a duplicate number was removed from the output. <\/p>\n

I might be able to squirrel around and figure something out, but at this point, I generally give up and write a script. I will copy the commands from my command history into the Windows PowerShell ISE so I at least have something with which to begin working. <\/p>\n

The first thing I did was create an empty hash table. I gave it the rather unimaginative name of $hash<\/b>. Next I used a Do …<\/b> While<\/b> loop to allow me to loop through the random numbers. I used my code snippet tool to insert the Do … While<\/b> loop because I do not write Do … While<\/b> loops all that often when writing Windows PowerShell code. The empty hash table, Do<\/b> statement and opening curly bracket are shown here.<\/p>\n

\n

$Hash = @{}<\/span><\/span><\/span><\/p>\n

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

  <\/span><\/span>{<\/span><\/span><\/span><\/span><\/p>\n<\/blockquote>\n

I used the same Get-Random<\/b> command, but this time I assign it to the $a<\/b> variable. Because I want a collection of random numbers that are unique, I needed a way to get a specific number of unique numbers. To do this, I add the number to both the key and the value of the hash table. This generates an error if the key previously has been used (the non-unique random number case); and therefore, I use Try \/ Catch<\/b>. I am not interested in really doing anything when I catch the error, so I supply empty curly brackets. This portion of the script is shown here:<\/p>\n

\n

$a = Get-Random -Minimum 2 -Maximum 20 <\/span><\/span><\/span><\/p>\n

Try { $hash.add($a,$a) } Catch {}<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Now I get rid of the number that is stored in the $a<\/b> variable, and I add my while<\/b> condition. I will keep looping around while the count contained in the hash table is less than or equal to 9. This is because the condition will always be one less than my desired number. The last thing I do is display the collection of keys from the hash table, as shown here:<\/p>\n

\n

   <\/span><\/span>$a = $null<\/span><\/span><\/span><\/span><\/p>\n

  <\/span><\/span>} While ( $hash.count -le 9 )<\/span><\/span><\/span><\/span><\/p>\n

  <\/span><\/span>$hash.Keys<\/span><\/span><\/span><\/span><\/p>\n

The complete Get-UniqueRandomNumbers.ps1 script appears here. <\/span><\/span><\/span><\/p>\n

Get-UniqueRandomNumbers.ps1<\/span><\/span><\/span><\/p>\n

$Hash = @{}<\/span><\/span><\/span><\/p>\n

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

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

   <\/span><\/span>$a = Get-Random -Minimum 2 -Maximum 20 <\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Try { $hash.add($a,$a) } Catch {}<\/span><\/span><\/span><\/span><\/p>\n

   <\/span><\/span>$a = $null<\/span><\/span><\/span><\/span><\/p>\n

  <\/span><\/span>} While ( $hash.count -le 9 )<\/span><\/span><\/span><\/span><\/p>\n

  <\/span><\/span>$hash.Keys<\/span><\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Interestingly enough, there is a count<\/b> property that I can use to specify a specific number of objects to return from a collection. By using this command set, I can simplify my previous script down to a single command. This one line command is shown here: <\/p>\n

\n

PS C:\\> Get-Random -Count 10 -InputObject (2..20)<\/span><\/span><\/span><\/p>\n

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

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

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

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

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

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

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

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

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

3<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Well, that is about it. As you can see, when I am working in the Windows PowerShell console, I often migrate to the Windows PowerShell ISE, and then vice versa. There are two things I really like about the Windows PowerShell console—it loads really fast, much faster than the Windows PowerShell ISE. And it allows me to page through my output. I can pipe a command to the more <\/strong>command, and the information is displayed one page at a time. This is useful because the pager in the Windows PowerShell ISE command output window does not work. <\/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: Microsoft Scripting Guy, Ed Wilson, teaches you how to use a simple Windows PowerShell cmdlet to create random numbers. Microsoft Scripting Guy, Ed Wilson, is here. One of the questions I received when I was speaking at the SQL Rally in Orlando, Florida was whether I prefer working in the Windows PowerShell console, or […]<\/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":[51,3,4,45,77],"class_list":["post-13811","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell","tag-writing"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, teaches you how to use a simple Windows PowerShell cmdlet to create random numbers. Microsoft Scripting Guy, Ed Wilson, is here. One of the questions I received when I was speaking at the SQL Rally in Orlando, Florida was whether I prefer working in the Windows PowerShell console, or […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13811","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=13811"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13811\/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=13811"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=13811"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=13811"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}