Did your command or script fail and\/or report an error? We hope to have a proper script debugger in a future version, but until then, MSH has some handy features to help you figure out what went wrong. In this series of blog entries, I will present some of those features. Thanks to Jim Truher [MSFT], Bruce Payette [MSFT], and Jeff Jones [MSFT] for their help in putting this together.<\/p>\n
See the Windows “Monad” Shell Beta 2 Documentation Pack (http:\/\/www.microsoft.com\/downloads\/details.aspx?FamilyID=8a3c71d1-18e5-49d7-952a-c55d694ecee3&displaylang=en<\/font><\/a>) for general information about Monad.<\/p>\n Part 1: http:\/\/blogs.msdn.com\/monad\/archive\/2005\/11\/04\/489138.aspx<\/font><\/a> (Terminating vs. Non-Terminating Errors, ErrorRecord) Jon Newman [MSFT]<\/p>\n <\/font><\/font> <\/p>\n <\/p>\n How Traps Work<\/font><\/p>\n <\/b><\/p>\n You can use the “trap” language feature to manage terminating errors in your script. “Getting Started.doc” and “MonadScripting-HandsOnLab.doc” from the Documentation Pack contain some details, but here is a little more detail.<\/font><\/p>\n If you don’t use “trap” at all, terminating errors halt the command which is executing, and then the script moves on to the next command. In this example, you can see that the “terminating error” only terminates the command where it occurs, and execution continues with the next command, “ending a”.<\/font><\/p>\n <\/font><\/p>\n MSH C:\\temp> get-content .\\test.msh <\/font><\/p>\n You can add “trap” statements to your script to handle terminating errors. Inside the trap statement, “$_” is the ErrorRecord for the error, and you can use “break;” to break script execution, or “continue;” to continue with the next command after the one which hit the error.<\/p>\n <\/p>\n MSH C:\\temp> get-content .\\test.msh <\/font><\/p>\n Here’s the tricky bit: If the current scope does not contain a trap, but any outer scope does, script execution after a terminating error will break out to the nearest scope where any trap (whether it matches the error or not) is defined. In this example, we move the trap statement out of “function a” and into the outer scope:<\/p>\n <\/p>\n MSH C:\\temp> get-content .\\test.msh <\/font><\/p>\n Note that “ending a” doesn’t appear in the output; execution broke out of function a.<\/p>\n This applies whether or not the error which occurred matches the exception you are trapping:<\/p>\n <\/p>\n MSH C:\\temp> get-content .\\test.msh <\/font><\/p>\n You may ask, why is this? Remember that trap statements operate in the scope in which they are declared. We had implementation and performance problems in exiting the “function a” scope, running the trap block in the outer scope, then returning to the “function a” scope.<\/p>\n <\/font><\/font><\/p>\n [Edit: Monad has now been renamed to Windows PowerShell. This script or discussion may require slight adjustments before it applies directly to newer builds.<\/i>]<\/p>\n","protected":false},"excerpt":{"rendered":" Did your command or script fail and\/or report an error? We hope to have a proper script debugger in a future version, but until then, MSH has some handy features to help you figure out what went wrong. In this series of blog entries, I will present some of those features. Thanks to Jim Truher […]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-10851","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell"],"acf":[],"blog_post_summary":" Did your command or script fail and\/or report an error? We hope to have a proper script debugger in a future version, but until then, MSH has some handy features to help you figure out what went wrong. In this series of blog entries, I will present some of those features. Thanks to Jim Truher […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/10851","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=10851"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/10851\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=10851"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=10851"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=10851"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
Part 2: http:\/\/blogs.msdn.com\/monad\/archive\/2005\/11\/08\/490130.aspx<\/font><\/a> ($error)
Part 3: http:\/\/blogs.msdn.com\/monad\/archive\/2005\/11\/09\/490625.aspx<\/font><\/a> (write-host)
Part 4: http:\/\/blogs.msdn.com\/monad\/archive\/2005\/11\/09\/491035.aspx<\/font><\/a> (set-mshdebug)
Part 5: http:\/\/blogs.msdn.com\/monad\/archive\/2005\/11\/11\/491967.aspx<\/font><\/a> (Preferences and Commandline Options)
Part 6: http:\/\/blogs.msdn.com\/monad\/archive\/2005\/11\/15\/492769.aspx<\/font><\/a> (Trace-Expression, Breakpoint Script)<\/p>\n
function a
{
write-host “starting a”
write-host (1 \/ $null)
write-host “ending a”
}
write-host “starting main”
a
write-host “ending main”
MSH C:\\temp> .\\test.msh
starting main
starting a
Attempted to divide by zero.
At C:\\temp\\test.msh:4 char:4
+ 1 \/ <<<< $null
ending a
ending main
MSH C:\\temp> get-content .\\test.msh<\/p>\n
function a
{
trap [System.DivideByZeroException] { write-host (“trapped ” + $_.Exception.GetType().Name); continue; }
write-host “starting a”
write-host (1 \/ $null)
write-host “ending a”
}
write-host “starting main”
a
write-host “ending main”
MSH C:\\temp> .\\test.msh
starting main
starting a
trapped DivideByZeroException
ending a
ending main
MSH C:\\temp><\/p>\n
trap [System.DivideByZeroException] { write-host (“trapped ” + $_.Exception.GetType().Name); continue; }
function a
{
write-host “starting a”
write-host (1 \/ $null)
write-host “ending a”
}
write-host “starting main”
a
write-host “ending main”
MSH C:\\temp> .\\test.msh
starting main
starting a
trapped DivideByZeroException
ending main
MSH C:\\temp><\/p>\n
trap [System.ArgumentException] { write-host (“trapped ” + $_.Exception.GetType().Name); continue; }
function a
{
write-host “starting a”
write-host (1 \/ $null)
write-host “ending a”
}
write-host “starting main”
a
write-host “ending main”
MSH C:\\temp> .\\test.msh
starting main
starting a
Attempted to divide by zero.
At C:\\temp\\test.msh:6 char:4
+ 1 \/ <<<< $null
ending main
MSH C:\\temp><\/p>\n