{"id":13521,"date":"2011-06-25T00:01:00","date_gmt":"2011-06-25T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/06\/25\/dont-write-powershell-scripts\/"},"modified":"2011-06-25T00:01:00","modified_gmt":"2011-06-25T00:01:00","slug":"dont-write-powershell-scripts","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/dont-write-powershell-scripts\/","title":{"rendered":"Don’t Write PowerShell Scripts"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy Ed Wilson talks about when to not write a Windows PowerShell script.<\/p>\n

Weekend Scripter<\/strong><\/h2>\n

Microsoft Scripting Guy, Ed Wilson, is here. Network administrators do not script! ITPros do not like to script! I have heard statements like this for years. Yet, when I first wrote my VBScript workshop for Microsoft Premier Workshops, it quickly became the most popular of all workshop offerings. So what gives? Is there a disconnect? Do ITPros really like to write scripts? Is there a secret developer hiding inside net admins that is struggling to make itself known? I do not think so. Rather, I believe that the desire to “learn” scripting is the desire to ease network administration duties. I believe the impetus to acquire scripting skills is the wish to automate repetitive tasks. In the past, these twin needs and goals did require learning rudimentary (and at times more advanced) programming skills, but this is no longer the case. <\/p>\n

Microsoft Windows PowerShell MVP, Don Jones, caused a minor tempest in the Windows PowerShell community when he declared that Windows PowerShell was not a “scripting language.” To an extent he was kidding,<\/i><\/b> <\/i>but he also had a point because Windows PowerShell is an automation tool. <\/p>\n

I believe, within reason, that the days of writing scripts are rapidly drawing to a close. To the extent that customization is required, it can be handled in the pipeline. To the extent that new functionality is required, it is best handled as an advanced function. <\/p>\n

I think a couple of examples are in order to illustrate what I am talking about. Consider the simple case of checking the version of the BIOS on the computer. In the old-fashioned VBScript days, a script such as the following was the order of the day. <\/p>\n

\n

GetBiosInformation.vbs<\/span><\/span><\/span><\/p>\n

On Error Resume Next<\/span><\/span><\/span><\/p>\n

strComputer = “.”<\/span><\/span><\/span><\/p>\n

Set objWMIService = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\cimv2”)<\/span><\/span><\/span><\/p>\n

Set colItems = objWMIService.ExecQuery(“Select * from Win32_BIOS”,,48)<\/span><\/span><\/span><\/p>\n

For Each objItem in colItems<\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “BiosCharacteristics: ” & objItem.BiosCharacteristics<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “BIOSVersion: ” & objItem.BIOSVersion<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “BuildNumber: ” & objItem.BuildNumber<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “Caption: ” & objItem.Caption<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “CodeSet: ” & objItem.CodeSet<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “CurrentLanguage: ” & objItem.CurrentLanguage<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “Description: ” & objItem.Description<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “IdentificationCode: ” & objItem.IdentificationCode<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “InstallableLanguages: ” & objItem.InstallableLanguages<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “InstallDate: ” & objItem.InstallDate<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “LanguageEdition: ” & objItem.LanguageEdition<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “ListOfLanguages: ” & objItem.ListOfLanguages<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “Manufacturer: ” & objItem.Manufacturer<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “Name: ” & objItem.Name<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “OtherTargetOS: ” & objItem.OtherTargetOS<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “PrimaryBIOS: ” & objItem.PrimaryBIOS<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “ReleaseDate: ” & objItem.ReleaseDate<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “SerialNumber: ” & objItem.SerialNumber<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “SMBIOSBIOSVersion: ” & objItem.SMBIOSBIOSVersion<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “SMBIOSMajorVersion: ” & objItem.SMBIOSMajorVersion<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “SMBIOSMinorVersion: ” & objItem.SMBIOSMinorVersion<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “SMBIOSPresent: ” & objItem.SMBIOSPresent<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “SoftwareElementID: ” & objItem.SoftwareElementID<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “SoftwareElementState: ” & objItem.SoftwareElementState<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “Status: ” & objItem.Status<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “TargetOperatingSystem: ” & objItem.TargetOperatingSystem<\/span><\/span><\/span><\/span><\/p>\n

    <\/span><\/span>Wscript.Echo “Version: ” & objItem.Version<\/span><\/span><\/span><\/span><\/p>\n

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

With Windows PowerShell, it is possible to replace that exact script with the following command. <\/p>\n

\n

Get-WmiObject Win32_bios | Format-List *<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

The output from the VBScript script and the PowerShell command are nearly identical. <\/p>\n

Now, suppose I decide that I need to run the command to get BIOS information from a large number of computers. The choice of where the computer names reside is a different discussion, but for now suppose the computer names are stored in a text file, one computer name per line. To solve this scenario, I can use the command that is shown here. <\/p>\n

\n

Get-WmiObject win32_bios -cn (Get-Content C:\\fso\\Servers.txt)<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

If I need to use different credentials (an account other than the one that I am currently using) to run the command, I use the Credential<\/i> parameter as shown here. <\/p>\n

\n

Get-WmiObject win32_bios -cn (Get-Content C:\\fso\\Servers.txt) –credential nwtraders\\administrator<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

When the command runs, a dialog box appears that prompts me to enter my password. This password is encrypted as it is transmitted because it is retrieved and handled as a secure string. The dialog box for the password is shown in the following image. <\/p>\n

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

Well, this is all fine and dandy, but to be honest, it is a bit silly to read a text file that contains dozens (or even hundreds) of computer names, and then display the results to the console. It makes more sense to output the information somewhere. I like writing the data to a database and using the SQLPSX modules. It is really trivial to write information to a database. The easiest way to store the returned information is to use redirection arrows and write the returned data to a text file. This technique is shown here. <\/p>\n

\n

Get-WmiObject win32_bios -cn (Get-Content C:\\fso\\Servers.txt) >> c:\\fso\\biosInfo.txt<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Because I am working interactively in the Windows PowerShell console, I might want to shorten the syntax a bit by using commonly available aliases for the commands. To do this, the previous command becomes:<\/p>\n

\n

gwmi win32_bios -cn (cat C:\\fso\\Servers.txt) >> c:\\fso\\biosInfo.txt<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

This command works because gwmi<\/b> is an alias for the Get-WmiObject<\/b> cmdlet. I need to let the Get-WmiObject <\/b>cmdlet know what I intend to do with the results of my Get-Content<\/b> cmdlet. I can use cn<\/b> as an alias for the longer ComputerName <\/i>parameter (in fact, I have cheated all along on this detail today). There are three default aliases for the Get-Content<\/b> cmdlet. I found them by using the Get-Aliases<\/b> cmdlet as shown here.<\/p>\n

\n

PS C:\\> Get-Alias -Definition get-content<\/span><\/span><\/span><\/p>\n

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

CommandType     <\/span>Name                                      <\/span>Definition<\/span><\/span><\/span><\/p>\n

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

Alias           <\/span>cat   <\/span>                                    <\/span>Get-Content<\/span><\/span><\/span><\/p>\n

Alias           <\/span>gc                                        <\/span>Get-Content<\/span><\/span><\/span><\/p>\n

Alias           <\/span>type                                      <\/span>Get-Content<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

If you do not like any of the default aliases, you can create your own alias. For example, if you like dogs better than cats, you can create a new alias as shown here. One thing to keep in mind, is that nothing is returned when you create a new alias in this manner. <\/p>\n

\n

PS C:\\> New-Alias -Name dog -Value get-content<\/span><\/span><\/span><\/p>\n

PS C:\\><\/span><\/span><\/span><\/p>\n<\/blockquote>\n

You can always check to ensure that the new alias “took” by using the Get-Alias<\/b> cmdlet as shown here.<\/p>\n

\n

PS C:\\> Get-Alias dog<\/span><\/span><\/span><\/p>\n

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

CommandType     <\/span>Name                                      <\/span>Definition<\/span><\/span><\/span><\/p>\n

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

Alias           <\/span>dog                                       <\/span>get-content<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Or better yet, you can simply try the new command and see what happens. This is what I do here. <\/p>\n

\n

gwmi win32_bios -cn (dog C:\\fso\\Servers.txt)<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

None of this required any scripting. Now suppose in my testing, I detect that there is a bad BIOS version. I mean, it is the sort of thing that causes my servers to emit a BSOD (blue screen of death). In the past, I would need to write a script to check for that. But by using Windows PowerShell, I simply “tack” an additional cmdlet to the end of my pipeline. The revised command is shown here. <\/p>\n

\n

Get-WmiObject win32_bios -cn (Get-Content C:\\fso\\Servers.txt) | <\/span><\/span><\/span><\/p>\n

Where-Object { $_.version -match ‘2170’}<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Note: The previous command is a single logical command. I broke it at the pipeline character (|) so it would fit better in the blog format. <\/p>\n

I can shorten this command by using aliases. In the short version, gwmi<\/b> is an alias for the Get-WmiObject<\/b> cmdlet. I use gc<\/b> for Get-Content<\/b>, and the question mark (?<\/b>) as an alias for the Where-Object<\/b> cmdlet. The short version of this command is shown here. <\/p>\n

\n

gwmi win32_bios -cn (gc C:\\fso\\Servers.txt) | ? { $_.version -match ‘2170’}<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

If I only need a list of the servers that will need the BIOS update, I add an additional cmdlet to the end of the command. This time, I use the Select-Object<\/b> cmdlet to retrieve the __Server<\/b> property (that is a double underscore character at the beginning of the __Server<\/b> property). In WMI, there is always a system property named __Server<\/b> that stores the name of the computer. This property exists in nearly every WMI class. The revised command is shown here. <\/p>\n

\n

Get-WmiObject win32_bios -cn (Get-Content C:\\fso\\Servers.txt) | <\/span><\/span><\/span><\/p>\n

Where-Object { $_.version -match ‘2170’} | Select-Object __Server <\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Once again, this is a single logical command. I broke the command at the pipeline character (|) to better format the command for the blog. <\/p>\n

I can shorten this command by using aliases. There is a default alias of Select<\/b> <\/i>for the Select-Object<\/b> cmdlet. A short version of the command is shown here.<\/p>\n

\n

gwmi win32_bios -cn (gc C:\\fso\\Servers.txt) | ? { $_.version -match ‘2170’} | select __Server<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

Even by using aliases, the command is becoming a bit long. But the cool thing is that the command is built incrementally, and I can use the command buffer to retrieve and to edit my commands. <\/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 talks about when to not write a Windows PowerShell script. Weekend Scripter Microsoft Scripting Guy, Ed Wilson, is here. Network administrators do not script! ITPros do not like to script! I have heard statements like this for years. Yet, when I first wrote my VBScript workshop for Microsoft Premier […]<\/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":[3,4,45,77],"class_list":["post-13521","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell","tag-writing"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy Ed Wilson talks about when to not write a Windows PowerShell script. Weekend Scripter Microsoft Scripting Guy, Ed Wilson, is here. Network administrators do not script! ITPros do not like to script! I have heard statements like this for years. Yet, when I first wrote my VBScript workshop for Microsoft Premier […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13521","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=13521"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13521\/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=13521"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=13521"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=13521"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}