<Edited 7\/2\/2006 with tags and categories>
PSMDTAG:FAQ: Why doesn’t output expand when I expand the width of the console?
PSMDTAG:FAQ: Why doesn’t output expand when I use -noElements on GROUP?<\/p>\n
Consider the example:<\/p>\n
PS> gps |group company<\/font><\/p>\n Count Name Group Notice that the Company Name is truncated in the output. This blog will address 2 questions:<\/p>\n Let’s review the basic model. In the Console host (PowerShell.exe), cmdlets emit objects which go to the out-default. Out-Default looks at the type of the object and looks for registered views for this type and calls the appropriate formatter. If you ever want to find the view defintion for the object you find the object’s PSTypeNames then look for those entries in the *FORMAT.PS1XML files in $PSHOME. Note that the out-default will walk down the array of PSTypeNames until it finds a match so if you don’t find a view for the first value in this array, search for the next.<\/p>\n PS> (gps |group company)[0].pstypenames<\/strong> PS> cd $pshome<\/strong><\/p>\n PS> Select-String Microsoft.PowerShell.Commands.GroupInfo *format.ps1xml<\/strong><\/font><\/p>\n PowerShellCore.format.ps1xml:93: <Name>Microsoft.PowerShell.Comm PS> Notepad PowerShellCore.Format.ps1xml<\/strong><\/font><\/p>\n Here is that you’ll find in PowerShellCore.Format.ps1xml:<\/p>\n <View> <TableControl> What this is showing you is that you have a view which is selected by the groupinfo type, that this object should be rendered as a table, it defines the headers and the data for that table. Examine the TableHeaders section and you’ll see that the first 2 TableColumnHeaders provide a LABEL and a WIDTH but the last one does not. When no LABEL is specified, the name of the property is used <\/p>\n PSMDTAG:PHILOSOPHY: – IT IS STRONGLY RECOMMENDED THAT YOU NEVER PROVIDE A LABEL.<\/strong> The way formatting works is that it calculates the widths of the fields based upon the data in this view and the width of the console host. You can see this by doing a dir of some long names and then change your CONSOLE properties to vary the WIDTH of the console (this is under the LAYOUT TAB). Make it large and small and do the same diff every time and you’ll see what I mean. <\/p>\n The formatter looks at the console width and then allocates the space explicitly reserved by the view (in this case Count reserves 5 spaces and Name reserves 25) and then allocates the remaining space evenly between all the other fields. This explains a couple of things:<\/p>\n You might think that specifying -NoElement on the group command will fix this. The GROUP command creates GroupInfo objects which give you a NAME (which is the VALUE of the property you are groupping by), the COUNT, and then the GROUP. The GROUP is an array of all the original elements (objects) that where grouped into this GroupInfo. There are lots of cases where that is really useful but it can be expensive so we provided the -NOELEMENT Switch which does not create this array. That said, we still emit a GROUPINFO object and thus it still binds the the same view and thus it still allocates 25 characters for the Name.<\/p>\n There are a couple of ways around this:<\/p>\n Enjoy! PSMDTAG:CMDLET:FORMAT: truncating data, use of formatting metadata <Edited 7\/2\/2006 with tags and categories>PSMDTAG:FAQ: Why doesn’t output expand when I expand the width of the console?PSMDTAG:FAQ: Why doesn’t output expand when I use -noElements on GROUP? Consider the example: PS> gps |group company Count Name Group—– —- —– 34 Microsoft Corporation {alg, CcmExec, ctfmon, dsamain…} 1 Adobe Systems Incorpor… {apdproxy} 2 Alps Electric Co., Ltd. […]<\/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":[18,10,19,11],"class_list":["post-10211","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-cmdletformat","tag-faq","tag-internal","tag-philosophy"],"acf":[],"blog_post_summary":" <Edited 7\/2\/2006 with tags and categories>PSMDTAG:FAQ: Why doesn’t output expand when I expand the width of the console?PSMDTAG:FAQ: Why doesn’t output expand when I use -noElements on GROUP? Consider the example: PS> gps |group company Count Name Group—– —- —– 34 Microsoft Corporation {alg, CcmExec, ctfmon, dsamain…} 1 Adobe Systems Incorpor… {apdproxy} 2 Alps Electric Co., Ltd. […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/10211","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=10211"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/10211\/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=10211"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=10211"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=10211"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
—– —- —–
34 Microsoft Corporation {alg, CcmExec, ctfmon, dsamain…}
1 Adobe Systems Incorpor…<\/font> {apdproxy}
2 Alps Electric Co., Ltd. {ApntEx, Apoint}
4 {csrss, Idle, System, winlogon}
1 Alcor Micro, Corp. {DrvMon}
2 Microsoft (R) Corporation {FwcAgent, FwcMgmt}
3 Computer Associates In…<\/font> {InoRpc, InoRT, InoTask}
1 Intel Corporation {ZCfgSvc}<\/font><\/p>\n\n
Microsoft.PowerShell.Commands.GroupInfo
System.Object<\/p>\n
ands.GroupInfo<\/Name>
PowerShellCore.format.ps1xml:95: <TypeName>Microsoft.PowerSh
ell.Commands.GroupInfo<\/TypeName>
PowerShellCore.format.ps1xml:128: <Name>Microsoft.PowerShell.Com
mands.GroupInfoNoElement<\/Name>
PowerShellCore.format.ps1xml:130: <TypeName>Microsoft.PowerS
hell.Commands.GroupInfoNoElement<\/TypeName>
PowerShellCore.format.ps1xml:917: <Name>Microsoft.PowerShell.Com
mands.GroupInfo<\/Name>
PowerShellCore.format.ps1xml:919: <TypeName>Microsoft.PowerS
hell.Commands.GroupInfo<\/TypeName>
PowerShellCore.format.ps1xml:946: <Name>Microsoft.PowerShell.Com
mands.GroupInfoNoElement<\/Name>
PowerShellCore.format.ps1xml:948: <TypeName>Microsoft.PowerS
hell.Commands.GroupInfoNoElement<\/TypeName><\/p>\n
<Name>Microsoft.PowerShell.Commands.GroupInfo<\/Name>
<ViewSelectedBy>
<TypeName>Microsoft.PowerShell.Commands.GroupInfo<\/TypeName>
<\/ViewSelectedBy><\/font><\/p>\n
<TableHeaders>
<TableColumnHeader>
<Label>Count<\/Label>
<Alignment>Right<\/Alignment>
<Width>5<\/Width>
<\/strong> <\/TableColumnHeader>
<TableColumnHeader>
<Width>25<\/Width>
<\/strong> <\/TableColumnHeader>
<TableColumnHeader\/>
<\/font> <\/TableHeaders>
<TableRowEntries>
<TableRowEntry>
<TableColumnItems>
<TableColumnItem>
<PropertyName>Count<\/PropertyName>
<\/TableColumnItem>
<TableColumnItem>
<PropertyName>Name<\/PropertyName>
<\/TableColumnItem>
<TableColumnItem>
<PropertyName>Group<\/PropertyName>
<\/TableColumnItem>
<\/TableColumnItems>
<\/TableRowEntry>
<\/TableRowEntries>
<\/TableControl>
<\/View><\/font><\/p>\n
One of the great things about Windows PowerShell is its transparency and discoverability The views are critical to that. The output is what tells the user what properties they can expect to get from an object. If your label is different than the object, then you misset their expectations. We realized this after the fact otherwise there is a strong chance we would not have allowed you to use a LABEL. Now one of the reasons why you might be tempted to use a label is because in the data definitions, you might want to use a SCRIPT to calculate a value – THIS IS A BAD IDEA TOO<\/strong> [I know because I’ve stepped on that rake]. If you ever find yourself wanting to do this, the best thing to do is to extend the type itself with a scriptproperty and then specify that script property in formating.<\/p>\n\n
\n
PS> gps |group company |ft count,name -auto\n
PS> gps |group company |ft -View MyView<\/li>\n<\/ol>\n
Jeffrey Snover
Windows PowerShell Architect<\/p>\n
PSMDTAG:INTERNAL: How formating uses metadata
PSMDTAG:CMDLET:FORMAT: How formating uses metadata<\/p>\n","protected":false},"excerpt":{"rendered":"