![\"Bookmark](\"http:\/\/s7.addthis.com\/static\/btn\/v2\/lg-share-en.gif\")
<\/p>\n <\/p>\n
<\/p>\n
![\"Hey,](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/q-for-powertip.jpg\" "\\"Hey,")
Hey, Scripting Guy! One thing I miss in Windows PowerShell is the ability to use a Try\/Catch\/Finally<\/b> block that I can use in C#. To me it is an elegant solution to error handling. You attempt something, catch any resulting errors, and clean up the mess you made. Are there any plans in Windows PowerShell 3.0 to introduce this kind of structured error handling? I know there is the Trap<\/b> statement, but that is weak in comparison to Try\/Catch\/Finally<\/b>. <\/p>\n<\/p>\n
— JK<\/p>\n
\n
<\/p>\n<\/p>\n
![\"Hey,](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/a-for-powertip.jpg\" "\\"Hey,")
Hello JK, <\/p>\n
Microsoft Scripting Guy Ed Wilson here. Today I will be interviewed by the people from the Get-Scripting podcast. It will be pretty cool, and we will talk about Windows PowerShell best practices, as well as the 2010 Scripting Games that begin April 26, 2010. I have meetings both before and after the podcast, so this morning is the only time I have to check scripter@microsoft.com<\/font><\/a> e-mail, make a few tweets, and post to Facebook. The rest of the day is pretty much a goner. I am drinking a rather indifferent black tea that I spiced up with a little bit of anise<\/font><\/a>. It is actually pretty good this way, although I do not think it will become part of my regular repertoire. <\/p>\n JK, you do not need to wait for Windows PowerShell 3.0 to come out, because Windows PowerShell 2.0<\/font><\/a>, which is installed on both Windows 7 and Windows Server 2008 R2, includes Try\/Catch\/Finally<\/b> today. <\/p>\n When using a Try\/Catch\/Finally<\/b> block, the command you wish to execute is placed in the Try<\/b> block. If an error occurs when the command executes, the error will be written to the $Error<\/b> variable, and script execution moves to the Catch<\/b> block. The TestTryCatchFinally.ps1 script uses the Try<\/b> command to attempt to create an object. A string states that the script is attempting to create a new object. The object to create is stored in the $ob1<\/b> variable. The New-Object <\/b>cmdlet creates the object. After the object has been created and stored in the $a<\/b> variable, the members of the object are displayed via the Get-Member<\/b> cmdlet. This code illustrates the technique:<\/p>\n Try <\/font><\/span><\/p>\n Use the Catch<\/b> block to capture errors that occurred during the Try<\/b> block. You can specify the type of error to catch, as well as the action you wish to perform when the error occurs. In the TestTryCatchFinally.ps1 script, I monitor for System.Exception<\/font><\/a> errors. The System.Exception<\/b> .NET Framework class is the base class from which all other exceptions derive. This means a System.Exception<\/b> is as generic as you can get; in essence, it will capture all predefined, common, system runtime exceptions. Upon catching the error, you can then specify what code you would like to execute. In this example, I display a single string that states that the script caught a system exception. The Catch<\/b> block is shown here: <\/p>\n Catch <\/font><\/span><\/p>\n The Finally<\/b> block of a Try\/Catch\/Finally<\/b> sequence always runs, regardless if an error is generated or not. This means that any code cleanup you wish to do, such as explicitly releasing COM objects, should be placed in a Finally<\/b> block. In the TestTryCatchFinally.ps1 script, the Finally<\/b> block displays a string that states the script has ended. This is shown here:<\/p>\n Finally <\/font><\/span><\/p>\n The complete TestTryCatchFinally.ps1 script is seen here.<\/p>\n TestTryCatchFinally.ps1<\/p>\n <\/strong><\/p>\n $ob1 = “kenobie” Try <\/font><\/span><\/p>\n When the TestTryCatchFinally.ps1 script runs and the value of $ob1<\/b> is equal to “kenobie,” an error occurs because there is no object named “kenobie” that is creatable via the New-Object<\/b> cmdlet. The following image displays the output from the script.<\/p>\n \n <\/p>\n<\/p>\n As seen in the previous image, the “Begin Test” string displays because it is outside the Try\/Catch\/Finally<\/b> loop. Inside the Try<\/b> block, the string “Attempting to create new object kenobie” is displayed because it comes before the New-Object<\/b> command. This illustrates that the Try<\/b> block is always attempted. The members of the “kenobie” object are not displayed, nor are the string “new object kenobie created.” This indicates that after the error is generated, the script moves to the next block.<\/p>\n In the Catch<\/b> block, the System.Exception<\/b> error is caught and displayed. The string “caught a system exception” is also displayed. Next, the script moves to the Finally<\/b> block, and the “end of script” string is displayed. <\/p>\n If the script is run with the value of $ob1<\/b> equal to “system.object” (which is a valid object), the Try<\/b> block completes successfully. As seen in the following image, the members of the object are displayed, and the string that states the object was successfully created is also displayed. The Catch<\/b> block is not entered, but the “end of script” string from the Finally<\/b> block is displayed. <\/p>\n \n <\/p>\n<\/p>\n You can have multiple Catch<\/b> blocks in a Try\/Catch\/Finally<\/b> block. The thing to keep in mind is that when an exception occurs, Windows PowerShell leaves the Try<\/b> block and searches for the Catch<\/b> block. The first Catch<\/b> block that matches the exception that was generated will be used. Therefore, you want to use the most specific exception first, and then move to the more generic exceptions. This is seen in TestTryMultipleCatchFinally.ps1. <\/p>\n TestTryMultipleCatchFinally.ps1<\/p>\n <\/strong><\/p>\n $ob1 = “foo” <\/font><\/span><\/p>\n The next image displays the output when running the TestTryMultipleCatchFinally.ps1 script. Two changes are made: The $ErrorActionPreference<\/b> command is commented out as is the Get-Content foo<\/b> command. Therefore, the error that will be generated is the one raised when attempting to create a nonexistent object. To find the specific error, I examined the $error<\/b> variable after running the offending command. The error is found in the Exception<\/b> field. The specific error that is raised is an instance of the System.Management.Automation.PSArgumentException<\/b> error. This is seen here:<\/p>\n PS C:> $error | fl * -f<\/p>\n PSMessageDetails <\/span>: <\/font><\/span><\/p>\n \n <\/p>\n<\/p>\n If a script has multiple errors and the error action preference is set to stop, the first error will cause the script to fail. By removing the comments from the $ErrorActionPreference<\/b> line and the Get-Content<\/b> line, the first error to be generated will be caught by the System.Exception<\/b> Catch<\/b> block and will therefore skip the argument exception. This is seen in the following image.<\/p>\n \n <\/p>\n<\/p>\n JK that is all there is to using Try\/Catch\/Finally<\/b>. Join us tomorrow for Quick-Hits Friday. <\/p>\n If you want to know exactly what we will be looking at tomorrow, follow us on Twitter<\/font><\/a> or Facebook<\/font><\/span><\/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<\/font><\/a>. See you tomorrow. Until then, peace.<\/p>\n <\/p>\n <\/p>\n <\/span><\/p>\n Ed Wilson and Craig Liebendorfer, Scripting Guys<\/p>\n <\/span><\/b><\/p>\n <\/span><\/b> <\/p>\n","protected":false},"excerpt":{"rendered":" Hey, Scripting Guy! One thing I miss in Windows PowerShell is the ability to use a Try\/Catch\/Finally block that I can use in C#. To me it is an elegant solution to error handling. You attempt something, catch any resulting errors, and clean up the mess you made. Are there any plans in […]<\/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":[68,51,3,4,45],"class_list":["post-51023","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-error-handling","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":" Hey, Scripting Guy! One thing I miss in Windows PowerShell is the ability to use a Try\/Catch\/Finally block that I can use in C#. To me it is an elegant solution to error handling. You attempt something, catch any resulting errors, and clean up the mess you made. Are there any plans in […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51023","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=51023"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51023\/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=51023"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=51023"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=51023"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
<\/span>{
<\/span>“Attempting to create new object $ob1”
<\/span>$a = new-object $ob1
<\/span>“Members of the $ob1”
<\/span>“New object $ob1 created”
<\/span>$a | Get-Member
<\/span>}<\/p>\n
<\/span>{
<\/span>[system.exception]
<\/span>“caught a system exception”
<\/span>}<\/p>\n
<\/span>{
<\/span>“end of script”
<\/span>}<\/p>\n
“Begin test”<\/p>\n
<\/span>{
<\/span>“Atte\nmpting to create new object $ob1”
<\/span>$a = new-object $ob1
<\/span>“Members of the $ob1”
<\/span>“New object $ob1 created”
<\/span>$a | Get-Member
<\/span>}
Catch [system.exception]
<\/span>{
<\/span>“caught a system exception”
<\/span>}
Finally
<\/span>{
<\/span>“end of script”
<\/span>}<\/p>\n![\"Image](\"http:\/\/img.microsoft.com\/library\/media\/1033\/technet\/images\/scriptcenter\/qanda\/hsg\/2010\/march\/hey0311\/hsg-03-11-10-01.jpg\" "\\"Image")
<\/p>\n![\"Image](\"http:\/\/img.microsoft.com\/library\/media\/1033\/technet\/images\/scriptcenter\/qanda\/hsg\/2010\/march\/hey0311\/hsg-03-11-10-02.jpg\" "\\"Image")
<\/p>\n
“Begin test”
$ErrorActionPreference = “stop”
Try
<\/span>{
<\/span>Get-Content foo
<\/span>“Attempting to create new object $ob1”
<\/span>$a = new-object $ob1
<\/span>“Members of the $ob1”
<\/span>“New object $ob1 created”
<\/span>$a | Get-Member
<\/span>}
Catch [System.Management.Automation.PSArgumentException]
<\/span>{
<\/span>“invalid object”
<\/span>}
Catch [system.exception]
<\/span>{
<\/span>“caught a system exception”
<\/span>}
Finally
<\/span>{
<\/span>“end of script”
<\/span>}<\/p>\n
Exception <\/span>: System.Management.Automation.PSArgumentException: Cannot find type [foo]: make sure the assembly containing this type is loaded. at System.Management.Automation.MshCommandRuntime.ThrowTerminatingError(ErrorRecord errorRecord)
TargetObject <\/span>:
CategoryInfo <\/span>: InvalidType: (:) [New-Object], PSArgumentException
FullyQualifiedErrorId : TypeNotFound,Microsoft.PowerShell.Commands.NewObjectCommand
ErrorDetails <\/span>:
InvocationInfo <\/span>: System.Management.Automation.InvocationInfo
PipelineIterationInfo : {0, 0}<\/p>\n![\"Image](\"http:\/\/img.microsoft.com\/library\/media\/1033\/technet\/images\/scriptcenter\/qanda\/hsg\/2010\/march\/hey0311\/hsg-03-11-10-03.jpg\" "\\"Image")
<\/p>\n![\"Image](\"http:\/\/img.microsoft.com\/library\/media\/1033\/technet\/images\/scriptcenter\/qanda\/hsg\/2010\/march\/hey0311\/hsg-03-11-10-04.jpg\" "\\"Image")
<\/p>\n