Format-List - Powershell 1.0 CmdLet

Microsoft Windows PowerShell is a command-line shell and scripting tool based on the Microsoft .NET Framework. It is designed for system administrators, engineers and developers to control and automate the administration of Windows and applications.

More than hundred command-line tools (so called "cmdlets") can be used to perform system administration tasks and Windows Management Instrumentation (WMI). These cmdlets are easy to use, with standard naming conventions and common parameters, and standard tools for piping, sorting, filtering, and formatting data and objects.

Format-List

Description
Format output as a list of properties, each on a new line

Usage


Options
-property Object[]
       The object properties to display (in order)
       Wildcards are permitted.
       You cannot use -Property and -View in the same command.
        
   -view string
       The name of an alternate format or "view." 
        
   -groupBy Object
       Format the output in groups based on a shared property or value.
        
   -force 
       Override restrictions that prevent the command from succeeding, 
       without compromising security. Force will override read-only
       attributes but will not change file permissions.

   -inputObject psobject
       The objects to format. (a variable, command or expression that gets the objects)
    
   -expand string
       Where string is either EnumOnly (the default), CoreOnly or Both
       'CoreOnly' will format and display properties of the collection object itself, 
       while 'emumOnly' will enumerate and display the object properties. 
       (designed around the ICollection (System.Collections) interface.)

   -displayError 
       Display errors at the command line.
        
   -showError 
       Send errors through the pipeline.CommonParameters
       The common parameters: -Verbose, -Debug,-ErrorAction, -ErrorVariable, -OutVariable.

Example(s)
Print a list of running processes, incuding the process name and path:

PS C:\>get-process | format-list -property name, path

Print a list of running processes, incuding all the properties:

PS C:\>get-process | format-list -property *

Print the objects stored in $My_Variable in list format:

PS C:\>format-list -InputObject $My_Variable