Recently I posted the following to the Microsoft.Public.Windows.PowerShell newsgroup (which you should participate in if you are not yet) <\/p>\n
\nBelow is a function that I encourage you to add to your Profile files and
then use when reporting an error or ask a question about a exception you are
seeing. This function provides all the information we have about the error
message making it easier to diagnose what is actually going on.<\/p>\nfunction Resolve-Error ($ErrorRecord=$Error[0])
{
$ErrorRecord | Format-List * -Force
$ErrorRecord.InvocationInfo |Format-List *
$Exception = $ErrorRecord.Exception
for ($i = 0; $Exception; $i++, ($Exception = $Exception.InnerException))
{ “$i” * 80
$Exception |Format-List * -Force
}
}
Set-Alias rver Resolve-Error<\/p>\n<\/blockquote>\nThis brings up a couple of questions I thought I would respond to.<\/p>\n
1. Why did we have to use -FORCE with Format-List?
<\/strong>
Errors generate ErrorRecords:<\/p>\n[596:0]PS> $error[0] |gm -MemberType Property<\/p>\n
TypeName: System.Management.Automation.ErrorRecord<\/p>\n
Name MemberType Definition
—- ———- ———-
CategoryInfo Property System.Management.Automation.ErrorCateg…
ErrorDetails Property System.Management.Automation.ErrorDetai…
Exception Property System.Exception Exception {get;}
FullyQualifiedErrorId Property System.String FullyQualifiedErrorId {get;}
InvocationInfo Property System.Management.Automation.Invocation…
TargetObject Property System.Object TargetObject {get;}<\/p>\nThese ErrorRecords get passed to the Output Stream just as the results of a command do. The formatting commands are hardwired to recognize these objects and treat them specially. They will treat them specially UNLESS you tell them not to with -FORCE. Let me show you:<\/p>\n
[596:0]PS> cd NoSuchDir
Set-Location : Cannot find path ‘C:\\jps\\NoSuchDir’ because it does not exis
t.
At line:1 char:3
+ cd <<<< NoSuchDir
[596:0]PS> $error[0] |Format-List CategoryInfo,TargetObject
Set-Location : Cannot find path ‘C:\\jps\\NoSuchDir’ because it does not exis
t.
At line:1 char:3
+ cd <<<< NoSuchDir
[596:0]PS> $error[0] |Format-List CategoryInfo,TargetObject -Force<\/p>\nCategoryInfo : ObjectNotFound: (C:\\jps\\NoSuchDir:String) [Set-Location], It
emNotFoundException
TargetObject : C:\\jps\\NoSuchDir<\/p>\n<\/p>\n
2. Why use the verb RESOLVE<\/strong><\/p>\n
Verb names are designed to be simultaneously specific and vague. They need to be specific enough that people can learn the meanings and have them stick and be used as the basis for guessing about what to do. They need to be vague enough so that they cover a wide range of things so we don’t end up with zillions of “precise” terms (“oh well you see, ‘kill’ is different than ‘stop'”. “actually we ‘terminate'”, “my product ‘ceases’ operations, ” ‘quit’ is a bit more accurate, – you can almost see the conversations in you head).<\/p>\n
Here is a pointer to the VerbNames and their meanings: http:\/\/msdn2.microsoft.com\/en-us\/library\/ms714428.aspx<\/a><\/p>\n
“Resolve” is a diagnostic verb. It is used to”map a shorthand name to a long name”. What we are doing is mapping a digested “short” version of an error object to a fully articulated “long” version of that object for diagnostic purposes (to find out what is really going on). A reasonable person could have said that “Dump-Error” would be a better name but (AND THIS IS THE POINT) if we start argeeing to reasonable people about naming, we are going to end up with a zillion reasonable names. <\/p>\n
\nLocal Optimization leads to global incoherence.<\/p>\n<\/blockquote>\n
Yes Resolve-Error may not be the most intuitive name right now. That’s because you haven’t being using Resolve-X, Resolve-Y, and Resolve-Z for the last couple of years. We (that’s us<\/strong> and you<\/strong>) need to be really hard-core about naming for the first couple of years or we’ll end up with world filled with “AWK”s. <\/p>\n
\nFor those of you who don’t already know this, AWK is the first letters of the 3 guys that worked on it (A<\/strong>ho, W<\/strong>einberger, and K<\/strong>errigan). I love those guys and the fabulous work that they did. So here is the lesson – if you want to honor or remember someone – build a statue, don’t screw up the command naming. \ud83d\ude42<\/p>\n<\/blockquote>\n
Apologies for all the tangents today.
Enjoy!<\/p>\nJeffrey Snover [MSFT]
Windows PowerShell\/Aspen Architect
Visit the Windows PowerShell Team blog at: http:\/\/blogs.msdn.com\/PowerShell<\/a>
Visit the Windows PowerShell ScriptCenter at: http:\/\/www.microsoft.com\/technet\/scriptcenter\/hubs\/msh.mspx<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"Recently I posted the following to the Microsoft.Public.Windows.PowerShell newsgroup (which you should participate in if you are not yet) Below is a function that I encourage you to add to your Profile files and then use when reporting an error or ask a question about a exception you are seeing. This function provides all the information we […]<\/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-9151","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell"],"acf":[],"blog_post_summary":"
Recently I posted the following to the Microsoft.Public.Windows.PowerShell newsgroup (which you should participate in if you are not yet) Below is a function that I encourage you to add to your Profile files and then use when reporting an error or ask a question about a exception you are seeing. This function provides all the information we […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/9151","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=9151"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/9151\/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=9151"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=9151"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=9151"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}