Format-Wide
Aplica a los objetos un formato de tabla ancha que muestra únicamente una propiedad de cada objeto.
Sintaxis
Format-Wide
[[-Property] <Object>]
[-AutoSize]
[-Column <int>]
[-GroupBy <Object>]
[-View <string>]
[-ShowError]
[-DisplayError]
[-Force]
[-Expand <string>]
[-InputObject <psobject>]
[<CommonParameters>]Description
El Format-Wide cmdlet da formato a los objetos como una tabla ancha que muestra solo una propiedad de cada objeto. Puede usar el parámetro Property para determinar qué propiedad se muestra.
Ejemplos
Ejemplo 1: Formato de nombres de archivos en el directorio actual
Este comando muestra los nombres de archivos del directorio actual en tres columnas distribuidas en la pantalla.
Get-ChildItem | Format-Wide -Column 3El Get-ChildItem cmdlet obtiene objetos que representan cada archivo del directorio. El operador de canalización (|) pasa los objetos de archivo a través de la canalización a Format-Wide, que los da formato para la salida. El parámetro Column especifica el número de columnas.
Ejemplo 2: Formato de nombres de claves del Registro
Este comando muestra los nombres de las claves del Registro en la HKEY_CURRENT_USER\Software\Microsoft clave.
Get-ChildItem HKCU:\software\microsoft | Format-Wide -Property pschildname -AutoSizeEl Get-ChildItem cmdlet obtiene objetos que representan las claves. La ruta de acceso se especifica como HKCU:, una de las unidades expuestas por el proveedor del Registro de PowerShell, seguida de la ruta de acceso de la clave. El operador de canalización (|) pasa los objetos de clave del Registro a través de la canalización a Format-Wide, que los da formato para la salida. El parámetro Property especifica el nombre de la propiedad y el parámetro AutoSize ajusta las columnas para mejorar la legibilidad.
Ejemplo 3: Solución de errores de formato
En los ejemplos siguientes se muestran los resultados de agregar los parámetros DisplayError o ShowError con una expresión.
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 : PSPropertyExpressionErrorParámetros
-AutoSize
Ajusta el tamaño de la columna y el número de columnas según el ancho de los datos. De forma predeterminada, el tamaño y el número de las columnas dependen de la vista. No puede usar los parámetros AutoSize y Column en el mismo comando.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Column
Especifica el número de columnas en pantalla. No puede usar los parámetros AutoSize y Column en el mismo comando.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisplayError
Muestra errores en la línea de comandos. Este parámetro rara vez se usa, pero se puede usar como ayuda de depuración cuando se dan formato a expresiones en un Format-Wide comando y las expresiones no parecen estar funcionando.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Expand
Da formato al objeto de colección y a los objetos dentro de la colección. Este parámetro está diseñado para dar formato a objetos que admiten la interfaz System.Collections.ICollection . El valor predeterminado es EnumOnly.
Los valores válidos son:
EnumOnly: muestra las propiedades de los objetos de la colección.CoreOnly: muestra las propiedades del objeto de colección.Both: muestra las propiedades del objeto de colección y las propiedades de los objetos de la colección.
| Tipo: | String |
| Valores aceptados: | CoreOnly, EnumOnly, Both |
| Posición: | Named |
| Valor predeterminado: | EnumOnly |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Indica que este cmdlet invalida las restricciones que impiden que el comando se realice correctamente, solo para que los cambios no pongan en peligro la seguridad. Por ejemplo, Force invalidará el atributo de solo lectura o creará directorios para completar una ruta de acceso de archivo, pero no intentará cambiar los permisos de archivo.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-GroupBy
Da formato al resultado en grupos basándose en una propiedad o un valor compartidos. Especifique una expresión o una propiedad del resultado.
El valor del parámetro GroupBy puede ser una nueva propiedad calculada. La propiedad calculada puede ser un bloque de script o una tabla hash. Los pares clave-valor válidos son:
Name(oLabel) -<string>Expression-<string>o<script block>FormatString-<string>
Para obtener más información, consulte about_Calculated_Properties.
| Tipo: | Object |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-InputObject
Especifica los objetos a los que se va a dar formato. Especifique una variable que contenga los objetos o escriba un comando o una expresión que obtenga los objetos.
| Tipo: | PSObject |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Property
Especifica la propiedad de objeto que aparece en la pantalla. Se permiten los caracteres comodín.
Si omite este parámetro, las propiedades que aparecen en pantalla dependerán del objeto que se muestre. El nombre del parámetro Property es opcional. No puede usar los parámetros Property y View en el mismo comando.
El valor del parámetro Property puede ser una nueva propiedad calculada. La propiedad calculada puede ser un bloque de script o una tabla hash. Los pares clave-valor válidos son:
Expression-<string>o<script block>FormatString-<string>
Para obtener más información, consulte about_Calculated_Properties.
| Tipo: | Object |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | True |
-ShowError
Envía errores a través de la canalización. Este parámetro rara vez se usa, pero se puede usar como ayuda de depuración cuando se dan formato a expresiones en un Format-Wide comando y las expresiones no parecen estar funcionando.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-View
Especifica el nombre de un formato o vista de tabla alternativo. No puede usar los parámetros Property y View en el mismo comando.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Puede canalizar cualquier objeto a este cmdlet.
Salidas
Microsoft.PowerShell.Commands.Internal.Format
Este cmdlet devuelve objetos de formato que representan la tabla.
Notas
Windows PowerShell incluye los siguientes alias para Format-Wide:
fw
El parámetro GroupBy supone que los objetos están ordenados. Use Sort-Object antes de usar Format-Custom para agrupar los objetos.
El parámetro View permite especificar un formato alternativo para la tabla. Puede usar las vistas definidas en los *.format.PS1XML archivos del directorio de PowerShell o puede crear sus propias vistas en nuevos archivos PS1XML y usar el Update-FormatData cmdlet para incluirlas en PowerShell.
La vista alternativa para el parámetro View debe usar el formato de tabla; si no es así, se produce un error en el comando. Si la vista alternativa es una lista, use Format-List. Si la vista alternativa no es una lista ni una tabla, use Format-Custom.
