Compartilhar via

Format-List

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Formata a saída como uma lista de propriedades em que cada propriedade aparece em uma nova linha.

Sintaxe

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

Description

O cmdlet Format-List formata a saída de um comando como uma lista de propriedades em que cada propriedade é exibida em uma linha separada. Você pode usar Format-List para formatar e exibir todas as propriedades ou propriedades selecionadas de um objeto como uma lista (format-list *).

Como há mais espaço disponível para cada item em uma lista do que em uma tabela, o PowerShell exibe mais propriedades do objeto na lista e os valores da propriedade são menos propensos a serem truncados.

Exemplos

Exemplo 1: formatar serviços de computador

Get-Service | Format-List

Esse comando formata informações sobre serviços no computador como uma lista. Por padrão, os serviços são formatados como uma tabela. O cmdlet Get-Service obtém objetos que representam os serviços no computador. O operador de pipeline (|) passa os resultados por meio do pipeline para Format-List. Em seguida, o comando Format-List formata as informações de serviço em uma lista e as envia para o cmdlet de saída padrão para exibição.

Exemplo 2: formatar arquivos PS1XML

Esses comandos exibem informações sobre os arquivos PS1XML no diretório do PowerShell como uma lista.

$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A

O primeiro comando obtém os objetos que representam os arquivos e os armazena na variável $A.

O segundo comando usa Format-List para formatar informações sobre objetos armazenados em $A. Esse comando usa o parâmetro InputObject para passar a variável para Format-List, que envia a saída formatada para o cmdlet de saída padrão para exibição.

Exemplo 3: formatar propriedades do processo por nome

Esse comando exibe o nome, a prioridade base e a classe de prioridade de cada processo no computador.

Get-Process | Format-List -Property name, basepriority, priorityclass

Ele usa o cmdlet Get-Process para obter um objeto que representa cada processo. O operador de pipeline (|) passa os objetos de processo por meio do pipeline para Format-List. Format-List formata os processos como uma lista das propriedades especificadas. O nome do parâmetro Property é opcional, portanto, você pode omitê-lo.

Exemplo 4: formatar todas as propriedades de um processo

Esse comando exibe todas as propriedades do processo do Winlogon.

Get-Process winlogon | Format-List -Property *

Ele usa o cmdlet Get-Process para obter um objeto que representa o processo do Winlogon. O operador de pipeline (|) passa o objeto de processo Winlogon pelo pipeline para Format-List. O comando usa o parâmetro Property para especificar as propriedades e o * para indicar todas as propriedades. Como o nome do parâmetro Property é opcional, você pode omitê-lo e digitar o comando como Format-List *. Format-List envia automaticamente os resultados para o cmdlet de saída padrão para exibição.

Exemplo 5: Solução de problemas de erros de formato

Os exemplos a seguir mostram os resultados da adição dos parâmetros DisplayError ou ShowError com uma expressão.

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek    : Friday
 $_ / $null  : #ERR

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek    : Friday
 $_ / $null  :

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parâmetros

-DisplayError

Indica que esse cmdlet exibe erros na linha de comando. Esse parâmetro raramente é usado, mas pode ser usado como um auxílio de depuração quando você está formatando expressões em um comando Format-List e as expressões não parecem estar funcionando.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Expand

Especifica o objeto de coleção formatado, bem como os objetos na coleção. Esse parâmetro foi projetado para formatar objetos que dão suporte à interface ICollection (System.Collections). O valor padrão é EnumOnly. Os valores aceitáveis para este parâmetro são:

  • EnumOnly. Exibe as propriedades dos objetos na coleção.
  • CoreOnly. Exibe as propriedades do objeto da coleção.
  • Ambos. Exibe as propriedades do objeto de coleção e as propriedades dos objetos na coleção.
Tipo:String
Valores aceitos:CoreOnly, EnumOnly, Both
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que esse cmdlet exibe todas as informações de erro. Use com o parâmetro DisplayError ou ShowError. Por padrão, quando um objeto de erro é gravado no erro ou exibe fluxos, apenas algumas das informações de erro são exibidas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GroupBy

Especifica a saída em grupos com base em uma propriedade ou valor compartilhado. Insira uma expressão ou uma propriedade da saída.

O valor do parâmetro GroupBy pode ser uma nova propriedade calculada. Para criar uma propriedade calculada, use uma tabela de hash. As chaves válidas são:

  • Nome (ou Rótulo) <cadeia de caracteres>
  • Expressão <cadeia de caracteres> ou <bloco de script>
  • < > de cadeia de caracteres formatString
Tipo:Object
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica os objetos a serem formatados. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtém os objetos.

Tipo:PSObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Property

Especifica as propriedades do objeto que aparecem na exibição e a ordem em que elas aparecem. Curingas são permitidos.

Se você omitir esse parâmetro, as propriedades que aparecem na exibição dependerão do objeto que está sendo exibido. O nome do parâmetro "Propriedade" é opcional. Você não pode usar os parâmetros Property e View no mesmo comando.

O valor do parâmetro da Propriedade pode ser uma nova propriedade calculada. Para criar uma propriedade calculada, use uma tabela de hash. As chaves válidas são:

  • Nome (ou Rótulo) <cadeia de caracteres>
  • Expressão <cadeia de caracteres> ou <bloco de script>
  • < > de cadeia de caracteres formatString
Tipo:Object[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-ShowError

Indica que o cmdlet envia erros por meio do pipeline. Esse parâmetro raramente é usado, mas pode ser usado como um auxílio de depuração quando você está formatando expressões em um comando Format-List e as expressões não parecem estar funcionando.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-View

Especifica o nome de um formato ou exibição de lista alternativo. Você não pode usar os parâmetros Property e View no mesmo comando.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSObject

Você pode redirecionar qualquer objeto para Format-List.

Saídas

Microsoft.PowerShell.Commands.Internal.Format

Format-List retorna os objetos de formato que representam a lista.

Observações

Você também pode consultar Format-List por seu alias interno, FL. Para obter mais informações, consulte about_Aliases.

Os cmdlets de formato, como Format-List, organizam os dados a serem exibidos, mas não os exibem. Os dados são exibidos pelos recursos de saída do PowerShell e pelos cmdlets que contêm o verbo Out (os cmdlets Out), como Out-Host ou Out-File.

Se você não usar um cmdlet de formato, o PowerShell aplicará esse formato padrão para cada objeto exibido.

O parâmetro GroupBy pressupõe que os objetos sejam classificados. Use Sort-Object antes de usar Format-List para agrupar os objetos.

O parâmetro exibir permite que você especifique um formato alternativo para a tabela. Você pode usar as exibições definidas nos arquivos *.format.PS1XML no diretório do PowerShell ou criar suas próprias exibições em novos arquivos PS1XML e usar o cmdlet Update-FormatData para incluí-las no PowerShell.

O modo de exibição alternativo do parâmetro View deve usar o formato de lista, caso contrário, o comando falhará. Se a exibição alternativa for uma tabela, use Format-Table. Se a exibição alternativa não for uma lista ou uma tabela, use Format-Custom.