Format-Table

Sintaxe

Format-Table
      [[-Property] <Object[]>]
      [-AutoSize]
      [-RepeatHeader]
      [-HideTableHeaders]
      [-Wrap]
      [-GroupBy <Object>]
      [-View <string>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <string>]
      [-InputObject <psobject>]
      [<CommonParameters>]

Description

O Format-Table cmdlet formata a saída de um comando como uma tabela com as propriedades selecionadas do objeto em cada coluna. O tipo de objeto determina o layout e as propriedades padrão que são exibidas em cada coluna. Você pode usar o parâmetro Property para selecionar as propriedades que deseja exibir.

O PowerShell usa formatadores padrão para definir como os tipos de objeto são exibidos. Você pode usar .ps1xml arquivos para criar exibições personalizadas que exibem uma tabela de saída com propriedades especificadas. Depois que uma exibição personalizada for criada, use o parâmetro View para exibir a tabela com sua exibição personalizada. Para obter mais informações sobre modos de exibição, consulte about_Format.ps1xml.

Você pode usar uma tabela de hash para adicionar propriedades calculadas a um objeto antes de exibi-lo e para especificar os títulos de coluna na tabela. Para adicionar uma propriedade calculada, use o parâmetro Property ou GroupBy . Para obter informações sobre tabelas de hash, confira about_Hash_Tables.

Exemplos

Exemplo 1: Formatar o host do PowerShell

Este exemplo exibe informações sobre o programa host do PowerShell em uma tabela.

Get-Host | Format-Table -AutoSize

O Get-Host cmdlet obtém objetos System.Management.Automation.Internal.Host.InternalHost que representam o host. Os objetos são enviados pelo pipeline e Format-Table exibidos em uma tabela. O parâmetro AutoSize ajusta as larguras das colunas para minimizar o truncamento.

Exemplo 2: Formatar processos por BasePriority

Neste exemplo, os processos são exibidos em grupos que têm a mesma propriedade BasePriority .

Get-Process | Sort-Object -Property BasePriority | Format-Table -GroupBy BasePriority -Wrap

O Get-Process cmdlet obtém objetos que representam cada processo no computador e os envia pelo pipeline para Sort-Objecto . Os objetos são classificados na ordem de sua propriedade BasePriority .

Os objetos classificados são enviados pelo pipeline para Format-Table. O parâmetro GroupBy organiza os dados do processo em grupos com base no valor da propriedade BasePriority . O parâmetro Wrap garante que os dados não sejam truncados.

Exemplo 3: Formatar processos por data de início

Este exemplo exibe informações sobre os processos em execução no computador. Os objetos são classificados e Format-Table usam uma exibição para agrupar os objetos por sua data de início.

Get-Process | Sort-Object StartTime | Format-Table -View StartTime

Get-Process obtém os objetos System.Diagnostics.Process que representam os processos em execução no computador. Os objetos são enviados pelo pipeline para Sort-Object, e são classificados com base na propriedade StartTime .

Os objetos classificados são enviados pelo pipeline para Format-Table. O parâmetro View especifica a exibição StartTime definida no arquivo do PowerShell DotNetTypes.format.ps1xml para objetos System.Diagnostics.Process . A exibição StartTime converte a hora de início de cada processo em uma data curta e agrupa os processos pela data de início.

O DotNetTypes.format.ps1xml arquivo contém uma visualização de prioridade para processos. Você pode criar seus próprios format.ps1xml arquivos com visualizações personalizadas.

Exemplo 4: Usar uma exibição personalizada para saída de tabela

Neste exemplo, uma exibição personalizada exibe o conteúdo de um diretório. O modo de exibição personalizado adiciona a coluna CreationTime à saída da tabela para objetos System.IO.DirectoryInfo e System.IO.FileInfo criados pelo Get-ChildItem.

A exibição personalizada neste exemplo foi criada a partir da exibição definida no código-fonte do PowerShell. Para obter mais informações sobre exibições e o código usado para criar a exibição deste exemplo, consulte about_Format.ps1xml.

Get-ChildItem  -Path C:\Test | Format-Table -View mygciview

Directory: C:\Test

Mode                LastWriteTime              CreationTime         Length Name
----                -------------              ------------         ------ ----
d-----        11/4/2019     15:54       9/24/2019     15:54                Archives
d-----        8/27/2019     14:22       8/27/2019     14:22                Drawings
d-----       10/23/2019     09:38       2/25/2019     09:38                Files
-a----        11/7/2019     11:07       11/7/2019     11:07          11345 Alias.txt
-a----        2/27/2019     15:15       2/27/2019     15:15            258 alias_out.txt
-a----        2/27/2019     15:16       2/27/2019     15:16            258 alias_out2.txt

Get-ChildItem obtém o conteúdo do diretório atual, C:\Test. Os objetos System.IO.DirectoryInfo e System.IO.FileInfo são enviados pelo pipeline. Format-Table usa o parâmetro View para especificar o modo de exibição personalizado mygciview que inclui a coluna CreationTime .

A saída padrão Format-Table para Get-ChildItem não inclui a coluna CreationTime .

Exemplo 5: Usar propriedades para saída de tabela

Este exemplo usa o parâmetro Property para exibir todos os serviços do computador em uma tabela de duas colunas que mostra as propriedades Name e DependentServices.

Get-Service | Format-Table -Property Name, DependentServices

Get-Service obtém todos os serviços no computador e envia os objetos System.ServiceProcess.ServiceController pelo pipeline. Format-Table usa o parâmetro Property para especificar que as propriedades Name e DependentServices são exibidas na tabela.

Name e DependentServices são duas das propriedades do tipo de objeto. Para exibir todas as propriedades: Get-Service | Get-Member -MemberType Properties.

Exemplo 6: Formatar um processo e calcular seu tempo de execução

Este exemplo exibe uma tabela com o nome do processo e o tempo total de execução dos processos do bloco de notas do computador local. O tempo de execução total é calculado subtraindo-se a hora de início de cada processo da hora atual.

Get-Process notepad |
  Format-Table ProcessName, @{Label="TotalRunningTime"; Expression={(Get-Date) - $_.StartTime}}

ProcessName TotalRunningTime
----------- ----------------
notepad     03:20:00.2751767
notepad     00:00:16.7710520

Get-Processobtém todos os processos do bloco de notas do computador local e envia os objetos pelo pipeline. Format-Table exibe uma tabela com duas colunas: ProcessName, uma Get-Process propriedade, e TotalRunningTime, uma propriedade calculada.

A propriedade TotalRunningTime é especificada por uma tabela de hash com duas chaves, Label e Expression. A chave Label especifica o nome da propriedade. A chave Expression especifica o cálculo. A expressão obtém a propriedade StartTime de cada objeto de processo e a subtrai do resultado de um Get-Date comando, que obtém a data e a hora atuais.

Exemplo 7: Formatar processos do Bloco de Notas

Este exemplo usa Get-CimInstance para obter o tempo de execução de todos os processos do bloco de notas no computador local. Você pode usar Get-CimInstance com o parâmetro ComputerName para obter informações de computadores remotos.

$Processes = Get-CimInstance -Class win32_process -Filter "name='notepad.exe'"
$Processes | Format-Table ProcessName, @{
    Label = "Total Running Time"
    Expression={(Get-Date) - $_.CreationDate}
}

ProcessName Total Running Time
----------- ------------------
notepad.exe 03:39:39.6260693
notepad.exe 00:19:56.1376922

Get-CimInstanceobtém instâncias da classe Win32_Process WMI que descreve todos os processos do computador local chamados notepad.exe. Os objetos de processo são armazenados na $Processes variável.

Os objetos de processo na $Processes variável são enviados pelo pipeline para Format-Table, que exibe a propriedade ProcessName e uma nova propriedade calculada, Total Running Time.

O comando atribui o nome da nova propriedade calculada, Tempo Total de Execução, à chave Rótulo. O bloco de script da chave Expression calcula há quanto tempo o processo está em execução subtraindo a data de criação dos processos da data atual. O Get-Date cmdlet obtém a data atual. A data de criação é subtraída da data atual. O resultado é o valor de Tempo Total de Execução.

Exemplo 8: 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.

Get-Date | Format-Table DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek  $_ / $null
--------- ------------
Wednesday #ERR

Get-Date | Format-Table DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek  $_ / $null
--------- ------------
Wednesday
Failed to evaluate expression " $_ / $null ".
    + CategoryInfo          : InvalidArgument: (11/27/2019 12:53:41:PSObject) [], RuntimeException
    + FullyQualifiedErrorId : mshExpressionError

Parâmetros

-AutoSize

-DisplayError

-Expand

-Force

-GroupBy

-HideTableHeaders

-InputObject

-Property

-RepeatHeader

-ShowError

-View

-Wrap

Entradas

PSObject

Você pode canalizar qualquer objeto para esse cmdlet.

Saídas

Microsoft.PowerShell.Commands.Internal.Format

Esse cmdlet retorna objetos de formato que representam a tabela.

Observações

O Windows PowerShell inclui os seguintes aliases para Format-Table:

• ft

Se você quiser usar Format-Table com o parâmetro Property , será necessário incluir o parâmetro Force em qualquer uma das seguintes condições:

• Os objetos de entrada são normalmente formatados fora de banda usando o ToString() método. Isso se aplica a [string] tipos primitivos do .NET, que são um superconjunto dos tipos numéricos internos, como [int], [long]e outros.

• Os objetos de entrada não têm propriedades públicas.

• Os objetos de entrada são instâncias dos tipos de wrapper que o PowerShell usa para fluxos de saída diferentes do fluxo de saída Êxito. Isso se aplica somente quando esses tipos de wrapper são enviados para o fluxo de saída Success que requer capturá-los por meio de parâmetros comuns, como ErrorVariable primeiro, ou usar um redirecionamento como *>&1.

  • Os tipos de wrapper incluem:

    • System.Management.Automation.ErrorRecord
    • System.Management.Automation.WarningRecord
    • System.Management.Automation.VerboseRecord
    • System.Management.Automation.DebugRecord
    • System.Management.Automation.InformationRecord

Links Relacionados

• about_Calculated_Properties
• about_Format.ps1xml
• about_Hash_Tables
• Export-FormatData
• Format-Custom
• Format-Hex
• Format-List
• Format-Wide
• Get-FormatData
• Get-Member
• Get-CimInstance
• Update-FormatData