Format-Wide

Formata objetos como uma ampla tabela, a qual exibe somente uma propriedade de cada objeto.

Sintaxe

Format-Wide [[-Property] <Object>] [-AutoSize] [-Column <int>] [-DisplayError] [-Expand <string>] [-Force] [-GroupBy <Object>] [-InputObject <psobject>] [-ShowError] [-View <string>] [<CommonParameters>]

Descrição

O cmdlet Format-Wide formata objetos como uma ampla tabela, a qual exibe somente uma propriedade de cada objeto. Você pode usar o parâmetro Property para determinar qual propriedade será exibida.

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. Você não pode usar os parâmetros AutoSize e Column no mesmo comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Column <int>

Especifica o número de colunas na exibição. Você não pode usar os parâmetros AutoSize e Column no mesmo comando.

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

Cancela as restrições que impedem a execução do comando, simplesmente para que as alterações não comprometam a segurança. Por exemplo, Force substituirá o atributo somente leitura ou criará diretórios para completar o caminho do arquivo, mas não tentará mudar as permissões do arquivo.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-GroupBy <Object>

Formata a saída em grupos com base em uma propriedade ou valor compartilhado. Digite 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:

-- 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

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

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

-- FormatString <cadeia de caracteres>

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

<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-Wide.
Saídas	Microsoft.PowerShell.Commands.Internal.Format Format-Wide retorna objetos de formato que representam a tabela.

Observações

Você também pode se referir a Format-Wide usando seu alias interno, "fw". 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-childitem | format-wide -column 3

Descrição
-----------
Este comando exibe os nomes dos arquivos no diretório atual em três colunas na tela. O cmdlet Get-ChildItem obtém objetos que representam cada arquivo no diretório. O operador de pipeline (|) passa os objetos do arquivo pelo pipeline para Format-Wide, que os formata para a saída. O parâmetro Column especifica o número de colunas na exibição.

Exemplo 2

C:\PS>get-childitem HKCU:\software\microsoft | format-wide -property pschildname -autosize

Descrição
-----------
Este comando exibe os nomes das chaves do Registro na chave HKEY_CURRENT_USER\Software\Microsoft. O cmdlet Get-ChildItem obtém objetos que representam as chaves. O caminho é especificado como "HKCU:", uma das unidades expostas pelo provedor Registry do Windows PowerShell, seguida pelo caminho da chave. O operador de pipeline (|) passa os objetos da chave do registro pelo pipeline para Format-Wide, que os formata para a saída. O parâmetro Property especifica o nome da propriedade; o parâmetro AutoSize ajusta as colunas para que sejam legíveis.