Formata a saída como uma tabela.

Sintaxe

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

Descrição

O cmdlet Format-Table 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 exibidos em cada coluna, mas você pode usar o parâmetro Property para selecionar as propriedades que deseja visualizar.

Também é possível usar uma tabela de hash para adicionar propriedades calculadas a um objeto antes de exibi-lo e especificar os títulos de coluna na tabela. Para adicionar uma propriedade calculada, use o parâmetro Property ou GroupBy.

Parâmetros

-AutoSize

Ajusta o tamanho e o número de colunas com base na largura dos dados. Por padrão, o tamanho e o número de colunas são determinados pela exibição.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-DisplayError

Exibe erros na linha de comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Expand <string>

Formata o objeto da coleção, bem como os objetos na coleção. Este parâmetro foi desenvolvido para formatar objetos que ofereçam suporte à interface ICollection (System.Collections). O valor padrão é EnumOnly.

Os valores válidos são:

-- EnumOnly: exibe as propriedades dos objetos na coleção.

-- CoreOnly: exibe as propriedades do objeto da coleção.

-- Both: exibe as propriedades do objeto da coleção, bem como dos objetos na coleção.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Force

Direciona o cmdlet para exibir todas as informações de erro. Use com os parâmetros DisplayError ou ShowError. Por padrão, quando um objeto de erro é gravado nos fluxos de erro ou exibição, somente algumas das informações de erro são exibidas.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-GroupBy <Object>

Organiza a saída classificada em tabelas separadas com base em um valor de propriedade. Por exemplo, é possível usar GroupBy para listar serviços em tabelas separadas com base em seu status.

Digite uma expressão ou uma propriedade da saída. A saída deve ser classificada antes de ser enviada ao Format-Table.

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:

-- Name (ou Label) <cadeia de caracteres>

-- Expression <cadeia de caracteres> ou <bloco de script>

-- FormatString <cadeia de caracteres>

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-HideTableHeaders

Omite os cabeçalhos da coluna da tabela.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-InputObject <psobject>

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

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

-Property <Object[]>

Especifica as propriedades do objeto que aparecem na exibição e a ordem na qual são exibidas. Digite um ou mais nomes de propriedade (separados por vírgulas) ou use uma tabela de hash para exibir uma propriedade calculada. Os caracteres curinga são permitidos.

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

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

-- Name (ou Label) <cadeia de caracteres>

-- Expression <cadeia de caracteres> ou <bloco de script>

-- FormatString <cadeia de caracteres>

-- Width <int32>

-- Alignment (o valor pode ser "Left", "Center" ou "Right")

Necessário?

false

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-ShowError

Envia erros pelo pipeline.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-View <string>

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

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Wrap

Exibe o texto que excede a largura da coluna na próxima linha. Por padrão, o texto que excede a largura da coluna é truncado.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSObject

Você pode canalizar qualquer objeto para Format-Table.

Saídas

Microsoft.PowerShell.Commands.Internal.Format

Format-Table retorna objetos de formato que representam a tabela.

Observações

Você também pode se referir a Format-Table usando seu alias interno, "FT". Para obter mais informações, consulte about_Aliases.

O parâmetro GroupBy supõe que os objetos estão classificados. Antes de usar Format-Custom para agrupar os objetos, use Sort-Object para classificá-los.

O parâmetro View 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 Windows PowerShell ou criar suas próprias exibições em novos arquivos PS1XML e usar o cmdlet Update-FormatData para incluí-las no Windows PowerShell.

A exibição alternativa do parâmetro View deverá usar formato de tabela; caso contrário, o comando falhará. Se a exibição alternativa for uma lista, use Format-List. Se a exibição alternativa não for uma lista nem uma tabela, use Format-Custom.

Exemplo 1

C:\PS>get-pssnapin | format-table -auto

Descrição
-----------
Este comando formata informações sobre snap-ins do Windows PowerShell em uma tabela. Por padrão, elas são formatadas como uma lista. Os cmdlets Get-PSSnapin obtêm objetos que representam os snap-ins. O operador de pipeline (|) passa o objeto para o comando Format-Table. Format-Table formata os objetos em uma tabela. O parâmetro Autosize ajusta as larguras da coluna para minimizar o truncamento.






Exemplo 2

C:\PS>get-process | sort-object -property basepriority | format-table -groupby basepriority -wrap

Descrição
-----------
Esse comando exibe os processos no computador em grupos com a mesma prioridade básica. 

O cmdlet Get-Process obtém objetos que representam cada processo no computador. O operador de pipeline (|) transmite o objeto para o cmdlet Sort-Object, que classifica os objetos na ordem de sua prioridade básica.


Outro operador de pipeline passa os resultados para o comando Format-Table. O parâmetro GroupBy distribui os dados sobre os processos em grupos com base no valor de sua propriedade BasePriority. O parâmetro Wrap garante que os dados não sejam truncados.






Exemplo 3

C:\PS>get-process | sort-object starttime | format-table -view starttime

Descrição
-----------
Este comando exibe as informações sobre os processos no computador no grupo com base na data de início do processo. Ele usa o cmdlet Get-Process para obter objetos que representam os processos no computador. O operador de pipeline (|) envia a saída do cmdlet Get-Process para o Sort-Object, que a classifica com base na propriedade StartTime. Outro operador de pipeline envia os resultados classificados para Format-Table. 

O parâmetro View é usado para selecionar a exibição StartTime definida no arquivo de formatação DotNetTypes.format.ps1xml dos objetos System.Diagnostics.Process, como aqueles retornados pelo Get-Process. Essa exibição converte a Hora de início do processo para uma data abreviada e, em seguida, agrupa os processos pela data de início.

O arquivo de formatação DotNetTypes.format.ps1xml também contém uma exibição Priority para processos, e você pode criar seus próprios arquivos format.ps1xml com exibições personalizadas.






Exemplo 4

C:\PS>get-service | format-table -property Name, DependentServices

Descrição
-----------
Esse comando exibe todos os serviços no computador em uma tabela com duas colunas, Name e DependentServices. O comando usa o cmdlet Get-Service para obter todos os serviços no computador. O operador de pipeline (|) envia os resultados para o cmdlet Format-Table, o qual formata a saída em uma tabela. O parâmetro Property especifica as propriedades que aparecem na tabela como colunas. O nome do parâmetro Property é opcional; portanto, você pode omiti-lo ("format-table name, dependentservices").

Property e DependentServices são apenas duas das propriedades dos objetos de serviço. Para exibir todas as propriedades, digite "get-service | get-member".






Exemplo 5

C:\PS>get-process notepad | format-table ProcessName, `
@{Label="TotalRunningTime"; Expression={(get-date) - $_.StartTime}}

Descrição
-----------
Este comando mostra como usar uma propriedade calculada em uma tabela. Este comando exibe uma tabela com o nome do processo e o tempo total de execução de todos os processos do Bloco de notas no computador local. O tempo total de execução é calculado pela subtração da hora de início de cada processo da hora atual.

O comando usa o cmdlet Get-Process para obter todos os processos denominados "Notepad" no computador local. O operador de pipeline (|) envia os resultados para Format-Table, que exibe uma tabela com duas colunas: ProcessName, uma propriedade padrão de processos, e TotalRunningTime, uma propriedade calculada.

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






Exemplo 6

C:\PS>$processes = get-wmiobject -ComputerName Server01 win32_process -filter "name='notepad.exe'"  

C:\PS> $processes | format-table ProcessName, @{ Label = "Total  Running Time"; `
Expression={(get-date) - $_.ConvertToDateTime($_.CreationDate)}}

Descrição
-----------
Esses comandos são semelhantes ao comando anterior, exceto pelo fato de usarem o cmdlet Get-WmiObject e a classe Win32_Process para exibir informações sobre os processos do Bloco de notas em um computador remoto.

O primeiro comando usa o cmdlet Get-WmiObject para obter instâncias da classe Win32_Process do Windows Management Instrumentation (WMI) que descreve todos os processos no computador Server01 denominados Notepad.exe. O comando armazena as informações do processo na variável $processes. 


O segundo comando usa um operador de pipeline (|) para enviar as informações do processo na variável $processes para o cmdlet Format-Table, o qual exibe o ProcessName de cada processo junto com uma nova propriedade calculada. 

O comando atribui o nome da nova propriedade calculada, Total Running Time, à chave Label. O bloco de script designado para a chave Expression calcula por quanto tempo o processo está sendo executado ao subtrair a data de criação do processo da data atual. O cmdlet Get-Date obtém a data atual. O método ConvertToDateTime converte a propriedade CreationDate do objeto Win32_Process de um objeto WMI CIM_DATETIME em um objeto Microsoft .NET Framework DateTime, o qual pode ser comparado com a saída do Get-Date. Em seguida, a data de criação convertida é subtraída da data atual. O resultado é o valor de Total Running Time.

Os caracteres de crase (`) são caracteres de continuação de linha.






See Also




Sumário