Format-Wide
Formata objetos como uma tabela ampla que exibe apenas uma propriedade de cada objeto.
Syntax
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]
Description
O Format-Wide
cmdlet formata objetos como uma tabela ampla que exibe apenas uma propriedade de cada objeto. Você pode usar o parâmetro Property para determinar qual propriedade é exibida.
Exemplos
Exemplo 1: Formatar nomes de arquivos no diretório atual
Esse comando exibe os nomes dos arquivos no diretório atual em três colunas na tela.
Get-ChildItem | Format-Wide -Column 3
O Get-ChildItem
cmdlet obtém objetos que representam cada arquivo no diretório. O operador de pipeline (|
) passa os objetos de arquivo através do pipeline para Format-Wide
, que os formata para saída. O parâmetro Column especifica o número de colunas.
Exemplo 2: Formatar nomes de chaves do Registro
Esse comando exibe os nomes das chaves do Registro na HKEY_CURRENT_USER\Software\Microsoft
chave.
Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSize
O Get-ChildItem
cmdlet obtém objetos que representam as chaves. O caminho é especificado como HKCU:
, uma das unidades expostas pelo provedor do Registro do PowerShell, seguido pelo caminho da chave. O operador de pipeline (|
) passa os objetos de chave do Registro pelo pipeline para Format-Wide
, que os formata para saída. O parâmetro Property especifica o nome da propriedade e o parâmetro AutoSize ajusta as colunas para facilitar a leitura.
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.
PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError
#ERR
PS /> Get-Date | Format-Wide { $_ / $null } -ShowError
Failed to evaluate expression " $_ / $null ".
+ CategoryInfo : InvalidArgument: (12/21/2018 8:18:01 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError
Parâmetros
-AutoSize
Ajusta o tamanho da coluna e o número de colunas com base na largura dos dados. Por padrão, o número de colunas e seu tamanho são determinados pelo modo de exibição. Não é possível usar os parâmetros AutoSize e Column no mesmo comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Column
Especifica o número de colunas a exibir. Não é possível usar os parâmetros AutoSize e Column no mesmo comando.
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ê estiver formatando expressões em um Format-Wide
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. Esse parâmetro foi projetado para formatar objetos que oferecem 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.Both
: Exibe as propriedades do objeto de coleção e as propriedades de 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
Indica que esse cmdlet substitui restrições que impedem que o comando seja bem-sucedido, apenas para que as alterações não comprometam a segurança. Por exemplo, Force substituirá o atributo somente leitura ou criará diretórios para concluir um caminho de arquivo, mas não tentará alterar as permissões de arquivo.
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. A propriedade calculada pode ser um bloco de script ou uma tabela de hash. Os pares chave-valor válidos são:
Name
(ouLabel
) -<string>
Expression
-<string>
ou<script block>
FormatString
-<string>
Para obter mais informações, consulte about_Calculated_Properties.
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 a propriedade object que aparece na exibição. Caracteres curinga são permitidos.
Se você omitir esse parâmetro, as propriedades a serem exibidas dependerão do objeto sendo exibido. A propriedade do nome do parâmetro é 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. A propriedade calculada pode ser um bloco de script ou uma tabela de hash. Os pares chave-valor válidos são:
Expression
-<string>
ou<script block>
FormatString
-<string>
Para obter mais informações, consulte about_Calculated_Properties.
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ê estiver formatando expressões em um Format-Wide
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 ou modo de exibição de tabela alternativo. 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
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 PowerShell inclui os seguintes aliases para Format-Wide
:
- Todas as plataformas:
fw
O parâmetro GroupBy pressupõe que os objetos são classificados. Use Sort-Object
antes de usar Format-Custom
para agrupar os objetos.
O parâmetro View permite especificar um formato alternativo para a tabela. Você pode usar os modos de exibição definidos nos *.format.PS1XML
arquivos no diretório do PowerShell ou pode criar seus próprios modos de exibição em novos arquivos PS1XML e usar o Update-FormatData
cmdlet para incluí-los no PowerShell.
A exibição alternativa para o parâmetro View deve usar o formato de tabela, caso contrário, o comando falhará. Se o modo de exibição alternativo for uma lista, use Format-List
. Se o modo de exibição alternativo não for nem uma lista nem uma tabela, use Format-Custom
.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de