Compartilhar via

Format-Custom

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

Usa um modo de exibição personalizado para formatar a saída.

Sintaxe

Format-Custom
      [[-Property] <Object[]>]
      [-Depth <Int32>]
      [-GroupBy <Object>]
      [-View <String>]
      [-ShowError]
      [-DisplayError]
      [-Force]
      [-Expand <String>]
      [-InputObject <PSObject>]
      [<CommonParameters>]

Description

O Format-Custom cmdlet formata a saída de um comando conforme definido em uma exibição alternativa. Format-Custom foi projetado para exibir exibições que não são apenas tabelas ou apenas listas. Você pode usar as exibições definidas no PowerShell ou criar suas próprias exibições em um novo format.ps1xml arquivo e usar o Update-FormatData cmdlet para adicioná-las ao PowerShell.

Exemplos

Exemplo 1: Formatar a saída com uma exibição personalizada

Get-Command Start-Transcript | Format-Custom -View MyView

Esse comando formata informações sobre o Start-Transcript cmdlet no formato definido pelo modo de exibição MyView, um modo de exibição personalizado criado pelo usuário. Para executar esse comando com êxito, primeiro você deve criar um novo arquivo PS1XML, definir o modo de exibição MyView e, em seguida, usar o Update-FormatData comando para adicionar o arquivo PS1XML ao PowerShell.

Exemplo 2: Formatar a saída com a exibição padrão

Get-Process Winlogon | Format-Custom

Esse comando formata informações sobre o processo Winlogon em uma exibição personalizada alternativa. Como o comando não usa o parâmetro View , Format-Custom usa uma exibição personalizada padrão para formatar os dados.

Exemplo 3: 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-Custom DayOfWeek,{ $_ / $null } -DisplayError

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}


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

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

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

Parâmetros

-Depth

Especifica o número de colunas a exibir.

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

-DisplayError

Exibe eventuais 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 Format-Custom comando 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

Formata o objeto da coleção, bem como os objetos presentes na coleção. Esse parâmetro foi projetado para formatar objetos que dão suporte à interface System.Collections.ICollection . 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 de coleção.
  • Ambos: Exibe as propriedades do objeto de coleção e dos objetos na coleção.
Tipo:String
Valores aceitos:CoreOnly, EnumOnly, Both
Cargo:Named
Valor padrão:EnumOnly
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Faz com que o cmdlet exiba todas as informações de erro. Use com os parâmetros DisplayError ou ShowError . Por padrão, quando um objeto de erro é gravado para os fluxos de erro ou de exibição, 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

Formata 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. A propriedade calculada pode ser um bloco de script ou uma tabela de hash. Os pares de chave-valor válidos são:

  • Nome (ou rótulo) <string>
  • Expressão <string> ou <script block>
  • FormatString <string>

Para obter mais informações, consulte about_Calculated_Properties.

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 contém os objetos ou digite um comando ou uma 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 aparecem. Caracteres curinga são permitidos.

Se você omitir esse parâmetro, as propriedades a serem exibidas dependerão do objeto sendo exibido. O nome do parâmetro Property é opcional. Não é possível usar os parâmetros Propriedade e Visualização no mesmo comando.

O valor do parâmetro Property pode ser uma nova propriedade calculada. A propriedade calculada pode ser um bloco de script ou uma tabela de hash. Os pares de chave-valor válidos são:

  • Expressão - <string> ou <script block>
  • Profundidade- <int32>

Para obter mais informações, consulte about_Calculated_Properties.

Tipo:Object[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-ShowError

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 Format-Custom comando 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 alternativo. Se você omitir esse parâmetro, Format-Custom o usará uma exibição personalizada padrão. Não é possível usar os parâmetros Propriedade e Visualização 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 canalizar qualquer objeto para esse cmdlet.

Saídas

Microsoft.PowerShell.Commands.Internal.Format

Esse cmdlet retorna os objetos de formato que representam a exibição.

Observações

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

  • fc

Format-Custom foi projetado para exibir exibições que não são apenas tabelas ou apenas listas. Para exibir uma exibição de tabela alternativa, use Format-Table. Para exibir uma exibição de lista alternativa, use Format-List.

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