名前
    Format-List
    
概要
    Formats the output as a list of properties in which each property appears on a new line.
    
構文
    Format-List [[-Property] [<Object[]>]] [-DisplayError] [-Expand {CoreOnly | EnumOnly | Both}] [-Force] [-GroupBy [
    <Object>]] [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}] [-InformationVar
    iable [<System.String>]] [-InputObject [<PSObject>]] [-ShowError] [-View [<String>]] [<CommonParameters>]
    
    
説明
    The Format-List cmdlet formats the output of a command as a list of properties in which each property is displayed
     on a separate line. You can use Format-List to format and display all or selected properties of an object as a li
    st (format-list *).
    
    Because more space is available for each item in a list than in a table, Windows PowerShell displays more properti
    es of the object in the list, and the property values are less likely to be truncated.
    

パラメーター
    -DisplayError [<SwitchParameter>]
        Displays errors at the command line. This parameter is rarely used, but can be used as a debugging aid when yo
        u are formatting expressions in a Format-List command, and the expressions do not appear to be working. The fo
        llowing shows an example of the results of adding the DisplayError parameter with an expression.
        
        PS > Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError
        DayOfWeek $_ / $null
        --------- ------------
        Wednesday #ERR
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Expand [<String>]
        Formats the collection object, as well as the objects in the collection. This parameter is designed to format 
        objects that support the ICollection (System.Collections) interface. The default value is EnumOnly.
        
        Valid values are:
        
        -- EnumOnly: Displays the properties of the objects in the collection.
        
        -- CoreOnly: Displays the properties of the collection object.
        
        -- Both: Displays the properties of the collection object and the properties of objects in the collection.
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Force [<SwitchParameter>]
        Directs the cmdlet to display all of the error information. Use with the DisplayError or ShowError parameters.
         By default, when an error object is written to the error or display streams, only some of the error informati
        on is displayed.
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -GroupBy [<Object>]
        Formats the output in groups based on a shared property or value. Enter an expression or a property of the out
        put.
        
        The value of the GroupBy parameter can be a new calculated property. To create a calculated property, use a ha
        sh table. Valid keys are:
        
        -- Name (or Label) <string>
        
        -- Expression <string> or <script block>
        
        -- FormatString <string>
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -InformationAction [<System.Management.Automation.ActionPreference>]
        
        PS > Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError
        DayOfWeek $_ / $null
        --------- ------------
        Wednesday #ERR
        
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -InformationVariable [<System.String>]
        
        PS > Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError
        DayOfWeek $_ / $null
        --------- ------------
        Wednesday #ERR
        
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -InputObject [<PSObject>]
        Specifies the objects to be formatted. Enter a variable that contains the objects or type a command or express
        ion that gets the objects.
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   true (ByValue)
        ワイルドカード文字を許可する false
        
    -Property [<Object[]>]
        Specifies the object properties that appear in the display and the order in which they appear. Wildcards are p
        ermitted.
        
        If you omit this parameter, the properties that appear in the display depend on the object being displayed. Th
        e parameter name ("Property") is optional. You cannot use the Property and View parameters in the same command
        .
        
        The value of the Property parameter can be a new calculated property. To create a calculated property, use a h
        ash table. Valid keys are:
        
        -- Name (or Label) <string>
        
        -- Expression <string> or <script block>
        
        -- FormatString <string>
        
        必須                         false
        位置                         1
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -ShowError [<SwitchParameter>]
        Sends errors through the pipeline. This parameter is rarely used, but can be used as a debugging aid when you 
        are formatting expressions in a Format-List command, and the expressions do not appear to be working. The foll
        owing shows an example of the results of adding the ShowError parameter with an expression.
        
        PS > Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError
        DayOfWeek  $_ / $null
        --------- ------------
        Wednesday
        
        Failed to evaluate expression " $_ / $null ".
            + CategoryInfo          : InvalidArgument: (10/30/2013 2:28:07 PM:PSObject) [], RuntimeException
            + FullyQualifiedErrorId : mshExpressionError
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -View [<String>]
        Specifies the name of an alternate list format or "view." You cannot use the Property and View parameters in t
        he same command.
        
        必須                         false
        位置                         named
        既定値                       none
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    <CommonParameters>
        このコマンドレットは、次の共通パラメーターをサポートします: Verbose、
        Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、
        OutBuffer, PipelineVariable、および OutVariable。詳細については、
        about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216) 
        を参照してください。 
    
入力
    System.Management.Automation.PSObject
        
        
    
        You can pipe any object to Format-List.
    
    
出力
    Microsoft.PowerShell.Commands.Internal.Format
        
        
    
        Format-List returns the format objects that represent the list.
    
    
メモ
    
    
        You can also refer to Format-List by its built-in alias, "FL". For more information, see about_Aliases.
        
        The format cmdlets, such as Format-List, arrange the data to be displayed but do not display it. The data is d
        isplayed by the output features of Windows PowerShell and by the cmdlets that contain the Out verb (the Out cm
        dlets), such as Out-Host, Out-File, and Out-Printer.
        
        If you do not use a format cmdlet, Windows PowerShell applies that default format for each object that it disp
        lays.
        
        The GroupBy parameter assumes that the objects are sorted. Before using Format-Custom to group the objects, us
        e Sort-Object to sort them.
        
        The View parameter lets you specify an alternate format for the table. 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 include them in Windows PowerShell.
        
        The alternate view for the View parameter must use the list format; if not, the command fails. If the alternat
        e view is a table, use Format-Table. If the alternate view is neither a list nor a table, use Format-Custom.
        
    
    -------------------------- EXAMPLE 1 --------------------------
    
    PS C:\>get-service | format-list
    
    
    This command formats information about services on the computer as a list. By default, the services are formatted 
    as a table. The Get-Service cmdlet gets objects representing the services on the computer. The pipeline operator (
    |) passes the results through the pipeline to Format-List. Then, the Format-List command formats the service infor
    mation in a list and sends it to the default output cmdlet for display.
    
    
    
    
    
    
    
    -------------------------- EXAMPLE 2 --------------------------
    
    PS C:\>$a = get-childitem $pshome\*.ps1xml
    PS C:\>format-list -InputObject $a
    
    
    These commands display information about the PS1XML files in the Windows PowerShell directory as a list.
    
    The first command gets the objects representing the files and stores them in the $a variable.
    
    The second command uses Format-List to format information about objects stored in $a. This command uses the InputO
    bject parameter to pass the variable to Format-List, which then sends the formatted output to the default output c
    mdlet for display.
    
    
    
    
    
    
    
    -------------------------- EXAMPLE 3 --------------------------
    
    PS C:\>get-process | format-list -property name, basepriority, priorityclass
    
    
    This command displays the name, base priority, and priority class of each process on the computer. It uses the Get
    -Process cmdlet to get an object representing each process. The pipeline operator (|) passes the process objects t
    hrough the pipeline to Format-List. Format-List formats the processes as a list of the specified properties. The "
    Property" parameter name is optional, so you can omit it.
    
    
    
    
    
    
    
    -------------------------- EXAMPLE 4 --------------------------
    
    PS C:\>get-process winlogon | format-list -property *
    
    
    This command displays all of the properties of the Winlogon process. It uses the Get-Process cmdlet to get an obje
    ct representing the Winlogon process. The pipeline operator (|) passes the Winlogon process object through the pip
    eline to Format-List. The command uses the Property parameter to specify the properties and the * to indicate all 
    properties. Because the name of the Property parameter is optional, you can omit it and type the command as: "form
    at-list *". Format-List automatically sends the results to the default output cmdlet for display.
    
    
    
    
    
    
    
    
関連するリンク
    Online Version: http://go.microsoft.com/fwlink/p/?linkid=293961