Format-Wide
Formata objetos como uma tabela ampla que exibe apenas uma propriedade de cada objeto.
Sintaxe
Default (Predefinição)
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]
Description
O cmdlet Format-Wide 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
Este comando exibe os nomes dos arquivos no diretório atual em três colunas na tela.
Get-ChildItem | Format-Wide -Column 3
O cmdlet Get-ChildItem 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 de registo
Este comando exibe os nomes das chaves do Registro na chave HKEY_CURRENT_USER\Software\Microsoft.
Get-ChildItem HKCU:\software\Microsoft | Format-Wide -Property PSChildName -AutoSize
O cmdlet Get-ChildItem obtém objetos que representam as chaves. O caminho é especificado como HKCU:, um dos drives expostos pelo provedor do Registro do PowerShell, seguidos pelo caminho da chave. O operador de pipeline (|) passa os objetos de chave do registo 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 e o número de colunas com base na largura dos dados. Por padrão, o tamanho e o número da coluna são determinados pela visualização. Não é possível usar os parâmetros AutoSize e Column no mesmo comando.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Column
Especifica o número de colunas na exibição. Não é possível usar os parâmetros AutoSize e Column no mesmo comando.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-DisplayError
Exibe 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 comando Format-Wide e as expressões não parecem estar funcionando.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Expand
Formata o objeto de coleção, bem como os objetos na coleção. Este parâmetro foi projetado para formatar objetos que suportam o System.Collections.ICollection interface. O valor predefinido é 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 dos objetos na coleção.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | EnumOnly |
| Valores aceites: | CoreOnly, EnumOnly, Both |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Indica que esse cmdlet substitui as 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 parâmetro GroupBy espera que os objetos sejam classificados. Use o cmdlet Sort-Object antes de usáFormat-Wide para agrupar os objetos.
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 mais informações, veja sobre_Propriedades_Calculadas.
Propriedades dos parâmetros
| Tipo: | Object |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica os objetos a serem formatados. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.
Propriedades dos parâmetros
| Tipo: | PSObject |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Property
Especifica a propriedade do objeto que aparece no ecrã. Curingas são permitidos.
Se você omitir esse parâmetro, as propriedades que aparecem na exibição dependem do objeto que está sendo exibido. O nome do parâmetro Property é opcional. Não é possível usar os parâmetros de propriedade e os parâmetros de 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 chave-valor válidos são:
-
Expression-<string>ou<script block> FormatString-<string>
Para mais informações, veja sobre_Propriedades_Calculadas.
Propriedades dos parâmetros
| Tipo: | Object |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ShowError
Envia erros através do fluxo de processamento. Esse parâmetro raramente é usado, mas pode ser usado como um auxílio de depuração quando você está formatando expressões em um comando Format-Wide e as expressões não parecem estar funcionando.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-View
Especifica o nome de um formato ou modo de exibição de tabela alternativo. Não é possível usar os parâmetros de propriedade e os parâmetros de visualização no mesmo comando.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
PSObject
Você pode canalizar qualquer objeto para este cmdlet.
Saídas
Microsoft.PowerShell.Commands.Internal.Format
Este cmdlet retorna objetos de formato que representam a tabela.
Notas
O PowerShell inclui os seguintes aliases para Format-Wide:
- Todas as plataformas:
fw
O parâmetro View permite especificar um formato alternativo para a tabela. Você pode usar as exibições definidas nos arquivos *.format.ps1xml no diretório do PowerShell ou pode criar suas próprias exibições em novos arquivos PS1XML e usar o cmdlet Update-FormatData para incluí-las no PowerShell.
O modo de exibição alternativo para o parâmetro View deve usar o formato de tabela; se isso não acontecer, 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 uma lista nem uma tabela, use Format-Custom.
