{"id":51843,"date":"2009-12-08T00:01:00","date_gmt":"2009-12-08T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2009\/12\/08\/hey-scripting-guy-how-can-i-ensure-my-scripts-wont-fail-on-various-windows-operating-systems\/"},"modified":"2009-12-08T00:01:00","modified_gmt":"2009-12-08T00:01:00","slug":"hey-scripting-guy-how-can-i-ensure-my-scripts-wont-fail-on-various-windows-operating-systems","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-ensure-my-scripts-wont-fail-on-various-windows-operating-systems\/","title":{"rendered":"Hey, Scripting Guy! How Can I Ensure My Scripts Won’t Fail on Various Windows Operating Systems?"},"content":{"rendered":"

\"Bookmark<\/a>  
\"Hey,<\/font><\/p>\n

Hey, Scripting Guy! I have a mixture of operating systems at work. We have Windows XP on the desktop, a few Windows Vista machines, Windows 7 on a few computers so far, Windows 2003 in the server room, and Windows 2008 and a couple of Windows 2008 R2 computers that are running Hyper-V on Windows Core edition. I know we are not unique in this regard, but given all this diversity, do you have any tricks that can be done to ensure that my scripts will not bomb out? <\/p>\n

— JH<\/p>\n

\n

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

\"Hey,Hello JH, <\/p>\n

Microsoft Scripting Guy Ed Wilson here. The other night I watched the movie, A Christmas Story<\/font><\/a>, which is about a little boy who wants a BB gun for Christmas. One of the funniest scenes in the movie happens when the boy gets his tongue stuck to the flagpole in the schoolyard. I never got my tongue stuck to a flagpole when I was a little scripting guy (I grew up in Florida<\/font><\/a> in the United States and it was never an option). Luckily, I had seen the movie when I moved to Ohio<\/font><\/a>, and my co-workers tried to get me to stick my tongue on the flagpole at work. The trick to keeping your tongue attached to your mouth lies in knowing about the properties of frozen flagpoles. <\/p>\n

Note: Portions of today’s Hey, Scripting Guy! post are excerpted from the Microsoft Press book, Windows PowerShell 2.0 Best Practices<\/i> by Ed Wilson, which is now available for pre-order<\/a>. <\/p>\n

JH, the trick to ensure that your scripts do not bomb out is to know about the various operating systems. The easiest way to see if a script will work on a particular version of the operating system is to run it and see what happens. I have a Windows Server 2008 R2 Core Edition at home configured to run Hyper-V and a variety of different operating systems. When I determine a script will not work on a particular version of the operating system, I add a check for the operating system and exit the script gracefully. <\/p>\n

Given the differences between the various versions of the Windows operating system, it is a best practice to check the version of the operating system before executing the script if you know that there could be version compatibility issues. There are, of course, several different methods of doing this. You can use the .NET Framework class System.Environment<\/b> to check the operating system version. This is seen here:<\/p>\n

PS C:> ([system.environment]::osversion).version.tostring()
6.1.7600.0<\/p>\n

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

It is true that you can use Windows PowerShell remoting to get information from this class remotely, as seen here:<\/p>\n

PS C:> Invoke-Command -ComputerName hyperv -Script { ([system.environment]::osversion).version.tostring() }
6.1.7600.0
PS C:><\/p>\n

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

But you can also achieve similar results using the WMI class Win32_OperatingSystem<\/b>. The advantage of this approach is that WMI automatically remotes, and the syntax is a bit easier to use. <\/p>\n

The GetVersion.ps1 script accepts a single command-line parameter, $computer<\/b>, which is set by default to the localhost computer. The entry point to the script passes the value of the $computer<\/b> variable and a reference type variable $osv<\/b> to the Get-OSVersion<\/b> function. Inside the Get-OSVersion<\/b> function, the first thing that is done is to use the Get-WMIObject<\/b> cmdlet to query the Win32_OperatingSystem<\/b> WMI class from the computer that is targeted by the $computer<\/b> variable. The resulting management object is stored in the $os<\/b> variable. <\/p>\n

The Switch<\/b> statement is used to evaluate the Version<\/b> property of the Win32_OperatingSystem<\/b> class. If the value of the Version<\/b> property is equal to 5.1.2600, the value<\/b> property of the $osv<\/b> reference type variable is set equal to xp<\/b>. This type of logic is repeated for the value 5.1.3790, which was the build number for Windows Server 2003. <\/p>\n

A problem arises if the version number is 6.0.6001 because both Windows Server 2008  <\/span>and Windows Vista have the same build number. This is the same problem if the version number is 6.1.7600 because both Windows Server 2008 R2 and Windows 7 have the same build number. This is why the script stores the entire Win32_OperatingSystem<\/b> management object in the $os<\/b> variable instead of retrieving only the version attribute. The ProductType<\/b> property can be used to distinguish between a workstation and a server. The possible values for the ProductType<\/b> property are seen in Table 1.<\/p>\n

Table 1  Win32_OperatingSystem ProductType Values and Associated Meanings<\/p>\n

<\/b><\/p>\n\n\n\n\n\n\n
\n

Value <\/p>\n

<\/b><\/p>\n<\/td>\n

\n

Meaning <\/p>\n

<\/b><\/p>\n<\/td>\n<\/tr>\n

\n

1 <\/p>\n<\/td>\n

\n

Work Station <\/p>\n<\/td>\n<\/tr>\n

\n

2 <\/p>\n<\/td>\n

\n

Domain Controller <\/p>\n<\/td>\n<\/tr>\n

\n

3 <\/p>\n<\/td>\n

\n

Server<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

After the version of the operating system has been detected, a single word or number representing the operating system is assigned to the value<\/b> property of the reference variable. In the GetVersion.ps1 script, this value is displayed on the console. The complete GetVersion.ps1 script is seen here. <\/p>\n

GetVersion.ps1<\/strong><\/p>\n

Param($computer = “localhost”)<\/p>\n

Function Get-OSVersion($computer,[ref]$osv)
{
 <\/span>$os = Get-WmiObject -class Win32_OperatingSystem `
       <\/span>-computerName $computer
 <\/span>Switch ($os.Version)
  <\/span>{
    <\/span>“5.1.2600” { $osv.value = “xp” }
    <\/span>“5.1.3790” { $osv.value = “2003” }
    <\/span>“6.0.6001”
               <\/span>{
                 <\/span>If($os.ProductType -eq 1)
                   <\/span>{
                    <\/span>$osv.value = “Vista”
                   <\/span>} #end if
                 <\/span>Else
                   <\/span>{
                    <\/span>$osv.value = “2008”
                   <\/span>} #end else
               <\/span>} #end 6001
  <\/span>  <\/span>“6.1.7600”
                <\/span>{
                 <\/span>If($os.ProductType -eq 1)
                   <\/span>{
                    <\/span>$osv.value = “Win7”
                   <\/span>} #end if
                 <\/span>Else
                   <\/span>{
                    <\/span>$osv.value = “2008R2”
       <\/span>            <\/span>} #end else
               <\/span>} #end 7600
     <\/span>DEFAULT { “Version not listed” }
  <\/span>} #end switch
} #end Get-OSVersion<\/p>\n

# *** entry point to script ***
$osv = $null
Get-OSVersion -computer $computer -osv ([ref]$osv)
$osv<\/p>\n

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

The GetVersion.ps1 script returns a single word to indicate the version of the operating system. You can use this from the command line to quickly check the operating system version, as seen here:<\/p>\n

PS C:bp> .GetVersion.ps1
Vista
PS C:bp> .GetVersion.ps1 -c berlin
2008
PS C:bp> .GetVersion.ps1 -c lisbon
xp<\/p>\n

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

 <\/p>\n

The GetVersion.ps1 script was written as a function to permit easy inclusion in other scripts. This allows you to perform the operating system version check, and then decide if you wish to continue processing the script. An example of this approach is seen in the GetVersionGetVolume.ps1 script that uses the Win32_Volume<\/b> WMI class we examined in yesterday’s Hey, Scripting Guy! post<\/a>.<\/p>\n

GetVersionGetVolume.ps1<\/strong><\/p>\n

Param($drive = “C:”, $computer = “localhost”)<\/p>\n

Function Get-OSVersion($computer,[ref]$osv)
{
  <\/span>$os = Get-WmiObject -class Win32_OperatingSystem `
       <\/span>-computerName $computer
 <\/span>Switch ($os.Version)
  <\/span>{
    <\/span>“5.1.2600” { $osv.value = “xp” }
    <\/span>“5.1.3790” { $osv.value = “2003” }
    <\/span>“6.0.6001”
               <\/span>{
                 <\/span>If($os.ProductType -eq 1)
                   <\/span>{
                    <\/span>$osv.value = “Vista”
                   <\/span>} #end if
                 <\/span>Else
                   <\/span>{
                    <\/span>$osv.value = “2008”
                   <\/span>} #end else
               <\/span>} #end 6001
    <\/span>“6.1.7600”
                <\/span>{
                 <\/span>If($os.ProductType -eq 1)
         <\/span>          <\/span>{
                    <\/span>$osv.value = “Win7”
                   <\/span>} #end if
                 <\/span>Else
                   <\/span>{
                    <\/span>$osv.value = “2008R2”
                   <\/span>} #end else
               <\/span>} #end 7600
     <\/span>DEFAULT { “Version not listed” }
  <\/span>} #end switch
} #end Get-OSVersion<\/p>\n

Function Get-Volume($drive, $computer)
{
 <\/span>$drive += “\\”
 <\/span>Get-WmiObject -Class Win32_Volume -computerName $computer `
 <\/span>-filter “Name = ‘$drive'”
} #end Get-Volume<\/p>\n

# *** entry point to script ***
$osv = $null
Get-OSVersion -computer $computer -osv ([ref]$osv)
if($osv -eq “xp”) { “Script does not run on XP” ; exit }
Get-Volume -Drive $drive -Computer $computer<\/p>\n

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

 <\/p>\n

When the GetVersionGetVolume.ps1 script is run against my remote Windows XP computer (named WinXP), the script displays a message that states the script will not run on a Windows XP computer. This is seen here:<\/p>\n

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

\n

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

JH, that is all there is to using WMI to check the operating system version. WMI Week will continue tomorrow. <\/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<\/font><\/a> or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.
<\/p>\n

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

Ed Wilson and Craig Liebendorfer, Scripting Guys<\/span><\/b><\/p>\n

\n

 <\/p><\/p>\n","protected":false},"excerpt":{"rendered":"

  Hey, Scripting Guy! I have a mixture of operating systems at work. We have Windows XP on the desktop, a few Windows Vista machines, Windows 7 on a few computers so far, Windows 2003 in the server room, and Windows 2008 and a couple of Windows 2008 R2 computers that are running Hyper-V on […]<\/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":[31,3,4,288,45,6],"class_list":["post-51843","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-operating-system","tag-scripting-guy","tag-scripting-techniques","tag-version-information","tag-windows-powershell","tag-wmi"],"acf":[],"blog_post_summary":"

  Hey, Scripting Guy! I have a mixture of operating systems at work. We have Windows XP on the desktop, a few Windows Vista machines, Windows 7 on a few computers so far, Windows 2003 in the server room, and Windows 2008 and a couple of Windows 2008 R2 computers that are running Hyper-V on […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51843","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=51843"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51843\/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=51843"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=51843"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=51843"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}