PowerShell Logo Small

Format-Custom



This is the built-in help made by Microsoft for the command 'Format-Custom', in PowerShell version 2 - as retrieved from Windows version 'Microsoft® Windows Vista™ Ultimate ' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Uses a customized view to format the output.

SYNTAX


Format-Custom [[-Property] <Object[]>] [-Depth <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [
-ShowError] [-View <string>] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Format-Custom cmdlet formats the output of a command as defined in an alternate view. Format-Custom is designed to display views that are not
just tables or just lists. You can use the views defined in the *format.PS1XML files in the Windows PowerShell directory, or you can create your
own views in new PS1XML files and use the Update-FormatData cmdlet to add them to Windows PowerShell.



<

RELATED LINKS


Online version: http://go.microsoft.com/fwlink/?LinkID=113301

REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

C:\PS>get-command start-transcript | format-custom -view MyView



Description
-----------
This command formats information about the Start-Transcript cmdlet in the format defined by the MyView view, a custom view created by the user. T
o run this command successfully, you must first create a new PS1XML file, define the MyView view, and then use the Update-FormatData command to a
dd the PS1XML file to Windows PowerShell.








-------------------------- EXAMPLE 2 --------------------------

C:\PS>get-process Winlogon | format-custom



Description
-----------
This command formats information about the Winlogon process in an alternate customized view. Because the command does not use the View parameter,
Format-Custom uses a default custom view to format the data.