{"id":53013,"date":"2009-07-06T03:01:00","date_gmt":"2009-07-06T03:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2009\/07\/06\/hey-scripting-guy-how-can-i-simply-have-windows-powershell-display-information-on-the-screen\/"},"modified":"2009-07-06T03:01:00","modified_gmt":"2009-07-06T03:01:00","slug":"hey-scripting-guy-how-can-i-simply-have-windows-powershell-display-information-on-the-screen","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-simply-have-windows-powershell-display-information-on-the-screen\/","title":{"rendered":"Hey, Scripting Guy! How Can I Simply Have Windows PowerShell Display Information on the Screen?"},"content":{"rendered":"

\"Hey, Hey, Scripting Guy! I am not into all those fancy scripts you seem to write. I am just a basic, everyday network administrator, and I simply need to use scripts to make my job easier. Because of this, I am not interested in displaying progress bars, writing stuff to Excel or Word or even PowerPoint. I am interested simply in having my Windows PowerShell script display information on the screen. What is the best way to do this?<\/span><\/span><\/p>\n

– CO<\/font><\/p>\n

\"Spacer\"\"Hey,<\/font> <\/p>\n

Hi CO,<\/p>\n

At times it seems like only yesterday, but when I started out in the field of IT, I also was a basic, everyday network administrator. The days were never boring because the problems were never the same. I would show up in my office, and there would be a message from a user stating they could not get logged on to the network; while I was resetting their password, I would check my e-mail and find out that someone else was having problems creating a macro in Office Excel. As I checked my project board, I saw that I needed to get a new network drop installed in a remote office. I also had to teach a class in the afternoon on basic Office Outlook for a dozen new users. Yep, being a basic, everyday network administrator was a lot of fun. I never got bored.<\/span> <\/p>\n

The one thing I never had was free time. Back then I used to drink coffee, but I don’t think I ever actually finished a cup of coffee before it was cold. I actually got to where I could drink cold coffee without cringing and shuddering. Because I was so busy running from problem to problem, I seldom wrote scripts. When I did write a script, it would display information on the screen because I always ran the scripts in an interactive fashion. Years later, after I began working at Microsoft, my good friend Jason and I went to Hong Kong<\/font><\/a> where I learned a new appreciation for interactive displays. Here is a good picture of Victoria Harbor<\/font><\/a> I took from a hydrofoil<\/font><\/a> on my way to Macau<\/font><\/a>.<\/span> <\/p>\n

\"Image<\/p>\n

 <\/p>\n

CO, when displaying information on the screen, the most important thing to remember is that it is easy. In many cases, you do not have to do anything more complicated than to run the cmdlet. When you do, you are automatically rewarded with nicely formatted output that is displayed on the screen: <\/p>\n

\"Image<\/p>\n


The reason the output is nicely formatted is the Windows PowerShell team created several format.ps1xml files that are used to control the way different objects are formatted when they are displayed. These XML files are located in the Windows PowerShell installation directory. Luckily, there is an automatic variable, $pshome<\/b>, that can be used to refer to the Windows PowerShell installation directory. To obtain a listing of all the format.ps1xml files that are installed on your computer, use the Get-ChildItem<\/b> cmdlet and specify a path that will retrieve any file with the name format in it. Pipeline the resulting fileinfo<\/b> objects to the Select-Object<\/b> cmdlet and choose the name property. This is seen here: <\/p>\n

PS C:> Get-ChildItem -Path $PSHOME\/*format* | Select-Object -Property name<\/p>\n

Name
—-
certificate.format.ps1xml
dotnettypes.format.ps1xml
filesystem.format.ps1xml
help.format.ps1xml
powershellcore.format.ps1xml
powershelltrace.format.ps1xml
registry.format.ps1xml<\/p>\n

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

These format.ps1xml files are used by the Windows PowerShell Extended Type System to determine how to display objects. This is required because most objects do not know how to display themselves. Because the format files are XML files, it is possible to edit them to change the default display behavior. This should not be undertaken lightly, though, because the files are rather complicated. If you wish to edit the files, make sure you have a good backup copy of the files before you start messing around with them. Direct manipulation of the format.ps1xml files could result in unexpected behavior. It is also possible to write your own format.ps1xml file (in fact Marc Van Orsouw [MOW] created his own format data file to tune the default output format for the Trace-Route function he wrote<\/a> as a guest commentator for the 2009 Summer Scripting Games<\/a>. <\/p>\n

The dotnettypes.format.ps1xml file is used to control the output that is displayed by a number of the cmdlets (Get-Process<\/b>, Get-Service<\/b>, Get-EventLog<\/b>, etc.) that return .NET Framework objects. A portion of the dotnettypes.format.ps1xml file is seen in the next image. This is the section of the file that controls the output from the Get-Process<\/b> cmdlet that is seen in the previous image. Under the <TableHeaders><\/b> section, each column heading is specified by the <TableColumnHeader><\/b> tag. And under the <TableColumnHeader><\/b>, there are three nodes: <Label><\/b>, <Width><\/b>, and <Alignment><\/b>. <Label> <\/b>controls the column heading, <Width><\/b> controls how wide the column is, and <Alignment> <\/b>is used to specify the alignment (left, center, right) of the data within the column. This is seen here: <\/p>\n

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

\"Image<\/p>\n


To display information in the Command Prompt window, you do not need to worry about format XML files or anything like that. You can rely upon the defaults and allow Windows PowerShell to make the decision for you. To display a string, you place the string in quotation marks and it is displayed in the Command Prompt window. This is seen here:<\/p>\n

PS C:> “this string is displayed to the console”
this string is displayed to the console
PS C:><\/p>\n

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

The important thing to keep in mind is that when the string is shown in the Command Prompt window, it retains its type; that is, it is still a string. This is seen here: <\/p>\n

PS C:> “this string is displayed to the console” | Get-Member<\/p>\n


   <\/span>TypeName: System.String<\/p>\n

Name             <\/span>MemberType            <\/span>Definition
—-             <\/span>———-            <\/span>———-
Clone            <\/span>Method                <\/span>System.Object Clone()
CompareTo        <\/span>Method                <\/span>int CompareTo(System.Object value), i…
Contains         <\/span>Method                <\/span>bool Contains(string value)
CopyTo           <\/span>Method                <\/span>System.Void CopyTo(int sourceIndex, c…
EndsWith         <\/span>Method                <\/span>bool EndsWith(string value), bool End…
Equals           <\/span>Method                <\/span>bool Equals(System.Object obj), bool …
GetEnumerator    <\/span>Method                <\/span>System.CharEnumerator GetEnumerator()
GetHashCode      <\/span>Method                <\/span>int GetHashCode()
GetType          <\/span>Method                <\/span>type GetType()
GetTypeCode      <\/span>Method                <\/span>System.TypeCode GetTypeCode()
IndexOf          <\/span>Method                <\/span>int IndexOf(char value), int IndexOf(…
IndexOfAny       <\/span>Method                <\/span>int IndexOfAny(char[] anyOf), int Ind…
Insert           <\/span>Method                <\/span>string Insert(int startIndex, string …
IsNormalized     <\/span>Method                <\/span>bool IsNormalized(), bool IsNormalize…
LastIndexOf      <\/span>Method                <\/span>int LastIndexOf(char value), int Last…
LastIndexOfAny   <\/span>Method                <\/span>int LastIndexOfAny(char[] anyOf), int…
Normalize        <\/span>Method                <\/span>string Normalize(), string Normalize(…
PadLeft          <\/span>Method                <\/span>string PadLeft(int totalWidth), strin…
PadRight         <\/span>Method                <\/span>string PadRight(int totalWidth), stri…
Remove           <\/span>Method               <\/span> <\/span>string Remove(int startIndex, int cou…
Replace          <\/span>Method                <\/span>string Replace(char oldChar, char new…
Split            <\/span>Method                <\/span>string[] Split(Params char[] separato…
StartsWith       <\/span>Method                <\/span>bool StartsWith(string value), bool S…
Substring        <\/span>Method                <\/span>string Substring(int startIndex), str…
ToCharArray      <\/span>Method                <\/span>char[] ToCharArray(), char[] ToCharAr…
ToLower          <\/span>Method                <\/span>string ToLower(), string ToLower(Syst…
ToLowerInvariant Method                <\/span>string ToLowerInvariant()
ToString         <\/span>Method                <\/span>string ToString(), string ToString(Sy…
ToUpper          <\/span>Method                <\/span>string ToUpper(), string ToUpper(Syst…
ToUpperInvariant Method                <\/span>string ToUpperInvariant()
Trim             <\/span>Method                <\/span>string Trim(Params char[] trimChars),…
TrimEnd          <\/span>Method                <\/span>string TrimEnd(Params char[] trimChars)
TrimStart        <\/span>Method                <\/span>string TrimStart(Params char[] trimCh…
Chars            <\/span>ParameterizedProperty char Chars(int index) {get;}
Length           <\/span>Property              <\/span>System.Int32 Length {get;}<\/p>\n

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

If you use one of the Out-*<\/b> cmdlets such as Out-Host<\/b> or Out-Default<\/b>, you destroy the object-oriented nature of the string. That is, it is no longer an instance of a system.string<\/b> .NET Framework class. This is seen here: <\/p>\n

PS C:> “this string is displayed to the console” | Out-Host | Get-Member
this string is displayed to the console
Get-Member : No object has been specified to the get-member cmdlet.
At line:1 char:66
+ “this string is displayed to the console” | Out-Host | Get-Member <<<<
    <\/span>+ CategoryInfo          <\/span>: CloseError: (:) [Get-Member], InvalidOperationEx
   <\/span>ception
    <\/span>+ FullyQualifiedErrorId : NoObjectInGetMember,Microsoft.PowerShell.Command
   <\/span>s.GetMemberCommand<\/p>\n

PS C:><\/p>\n

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

As a best practice you should avoid using the Out-Host<\/b> cmdlet or the Out-Default<\/b> cmdlet unless there is a reason for using it. This is because you lose your object after you send the output to these two cmdlets. The only reason for using Out-Host<\/b> is to use the –paging<\/b> parameter. This is seen here:
<\/p>\n

PS C:> Get-WmiObject -Class win32_process | Out-Host -Paging<\/p>\n

__GENUS                    <\/span>: 2
__CLASS                    <\/span>: Win32_Process
__SUPERCLASS               <\/span>: CIM_Process
__DYNASTY                  <\/span>: CIM_ManagedSystemElement
__RELPATH                  <\/span>: Win32_Process.Handle=”0″
__PROPERTY_COUNT           <\/span>: 45
__DERIVATION               <\/span>: {CIM_Process, CIM_LogicalElement, CIM_ManagedSyste
                             <\/span>mElement}
__SERVER                   <\/span>: VISTA
__NAMESPACE                <\/span>: rootcimv2
__PATH                     <\/span>: \\VISTArootcimv2:Win32_Process.Handle=”0″
Caption                    <\/span>: System Idle Process
CommandLine                <\/span>:
CreationClassName          <\/span>: Win32_Process
CreationDate               <\/span>:
CSCreationClassName        <\/span>: Win32_ComputerSystem
CSName                     <\/span>: VISTA
Description                <\/span>: System Idle Process
ExecutablePath          <\/span>   <\/span>:
ExecutionState             <\/span>:
Handle                     <\/span>: 0
HandleCount                <\/span>: 0
InstallDate                <\/span>:
KernelModeTime             <\/span>: 151488730096
MaximumWorkingSetSize      <\/span>:
MinimumWorkingSetSize      <\/span>:
Name                       <\/span>: System Idle Process
OSCreationClassName        <\/span>: Win32_OperatingSystem
OSName                     <\/span>: Microsoftr Windows VistaT Business |C:Windows|De
                             <\/span>viceHarddisk0Partition1
OtherOperationCount        <\/span>: 0
OtherTransferCount   <\/span>      <\/span>: 0
PageFaults                 <\/span>: 0
PageFileUsage              <\/span>: 0
ParentProcessId            <\/span>: 0
PeakPageFileUsage          <\/span>: 0
PeakVirtualSize            <\/span>: 0
PeakWorkingSetSize         <\/span>: 0
Priority                   <\/span>: 0
PrivatePageCount           <\/span>: 0
<SPACE> next page; <CR> next line; Q quit<\/p>\n

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

If you are not using the paging parameter, there is no advantage to using the Out-Host<\/b> cmdlet. From a display perspective, the following commands are identical:<\/p>\n

Get-Process<\/p>\n

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

Get-Process | Out-Host<\/p>\n

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

Get-Process | Out-Default<\/p>\n

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

In fact, on most systems Out-Default<\/b> and Out-Host<\/b> do the same thing. This is because by default Out-Host<\/b> is the default outputter. The only reason to use Out-Default<\/b> would be if you anticipated changing the default outputter, and you did not want to rewrite the script. By using Out-Default<\/b> the output from the script will always go to the default outputter, which may or may not be the host. <\/p>\n

CO, that is about all there is to say for now about writing to the host. Join us tomorrow as we will continue talking about handling output from scripts. If you want to keep up to date with the Scripting Guys, you can follow us on Twitter<\/a>. You can also look us up on Facebook<\/a>. Until tomorrow peace!<\/p>\n

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

Hey, Scripting Guy! I am not into all those fancy scripts you seem to write. I am just a basic, everyday network administrator, and I simply need to use scripts to make my job easier. Because of this, I am not interested in displaying progress bars, writing stuff to Excel or Word or even PowerPoint. […]<\/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":[25,3,4,45],"class_list":["post-53013","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-displaying-output","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Hey, Scripting Guy! I am not into all those fancy scripts you seem to write. I am just a basic, everyday network administrator, and I simply need to use scripts to make my job easier. Because of this, I am not interested in displaying progress bars, writing stuff to Excel or Word or even PowerPoint. […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/53013","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=53013"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/53013\/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=53013"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=53013"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=53013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}