Compartilhar via

Format-Custom

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

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

Syntax

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 formato *. Arquivos PS1XML no diretório do PowerShell ou você pode criar suas próprias exibições em novos arquivos PS1XML e usar o cmdlet Update-FormatData para adicioná-los ao PowerShell.

Exemplos

Exemplo 1: formatar 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, uma exibição personalizada criada 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 saída com o modo de exibição padrão

Get-Process Winlogon | Format-Custom

Esse comando formata informações sobre o processo Winlogon em um modo de exibição alternativo personalizado. Como o comando não usa o parâmetro View , Format-Custom o 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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Expand

Formata o objeto da coleção, bem como os objetos presentes na coleção. Este parâmetro é projetado para formatar objetos que dão 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.
  • Ambos: exibe as propriedades do objeto de coleção e as propriedades dos objetos na coleção.
Type:String
Accepted values:CoreOnly, EnumOnly, Both
Position:Named
Default value:EnumOnly
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Para criar uma propriedade calculada, use uma tabela de hash. As chaves válidas são:

  • Cadeia de caracteres Name (ou Label) <>
  • Cadeia de caracteres de> expressão <ou <bloco de script>
  • Cadeia de caracteres FormatString <>
Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 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:

  • Cadeia de caracteres de> expressão <ou <bloco de script>
  • Profundidade <int32>
Type:Object[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-View

Especifica o nome de um formato alternativo ou "exibição". Se você omitir esse parâmetro, Format-Custom usará uma exibição personalizada padrão. Não é possível usar os parâmetros Property e View no mesmo comando.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSObject

Você pode redirecionar qualquer objeto para Format-Custom.

Saídas

Microsoft.PowerShell.Commands.Internal.Format

Format-Custom retorna os objetos de formato que representam a exibição.

Observações

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

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

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.