Format-Wide

Aplica a los objetos el formato de una tabla ancha en la que se muestra únicamente una propiedad de cada objeto.

Sintaxis

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

Descripción

El cmdlet Format-Wide aplica a los objetos el formato de una tabla ancha en la que se muestra solamente una propiedad de cada objeto. Puede usar el parámetro Property para determinar qué propiedad se va a mostrar.

Parámetros

-AutoSize

Ajusta el tamaño de columna y el número de columnas en función del ancho de los datos. De forma predeterminada, el tamaño y el número de columnas vienen determinados por la vista. Los parámetros AutoSize y Column no se pueden usar en el mismo comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Column <int>

Especifica el número de columnas de la presentación. Los parámetros AutoSize y Column no se pueden usar en el mismo comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-DisplayError

Muestra los errores en la línea de comandos.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Expand <string>

Da formato al objeto Collection, así como a los objetos de la colección. Este parámetro se ha diseñado para dar un formato a los objetos que sea compatible con la interfaz ICollection (System.Collections). 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 Collection.

-- Both: muestra las propiedades del objeto Collection y de los objetos de la colección.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Force

Pasa por alto las restricciones que impiden que el comando se ejecute correctamente, de tal modo que los cambios no pongan en peligro la seguridad. Por ejemplo, Force reemplazará el atributo de solo lectura o creará directorios para completar la ruta de acceso a un archivo, pero no intentará cambiar los permisos del archivo.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-GroupBy <Object>

Da formato a la salida de los grupos en función de un valor o una propiedad compartida. Especifique una expresión o una propiedad de la salida.

El valor del parámetro GroupBy puede ser una nueva propiedad calculada. Para crear una propiedad calculada, utilice una tabla hash. Las claves válidas son:

-- Name (o Label) <cadena>

-- Expression <cadena> o <bloque de script>

-- FormatString <cadena>

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-InputObject <psobject>

Especifica los objetos a los que se les va a dar formato. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByValue)
¿Aceptar caracteres comodín?	false

-Property <Object>

Especifica las propiedades del objeto que se van a mostrar y el orden en el que van a aparecer. Se permite el uso de caracteres comodín.

Si se omite este parámetro, las propiedades que aparezcan en la presentación dependerán del objeto que se está mostrando. El nombre del parámetro ("Property") es opcional. Los parámetros Property y View no se pueden usar en el mismo comando.

El valor del parámetro Property puede ser una nueva propiedad calculada. Para crear una propiedad calculada, utilice una tabla hash. Las claves válidas son:

-- Expression <cadena> o <bloque de script>

-- FormatString <cadena>

¿Requerido?	false
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-ShowError

Envía los errores a través de la canalización.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-View <string>

Especifica el nombre de un formato de tabla alternativo o una vista alternativa. Los parámetros Property y View no se pueden usar en el mismo comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas	System.Management.Automation.PSObject Puede canalizar cualquier objeto a Format-Wide.
Salidas	Microsoft.PowerShell.Commands.Internal.Format Format-Wide devuelve los objetos de formato que representan la tabla.

Notas

También puede hacer referencia a Format-Wide mediante su alias integrado, "fw". Para obtener más información, vea about_Aliases.

El parámetro GroupBy presupone que los objetos están ordenados. Antes de usar Format-Custom para agrupar los objetos, use Sort-Object para ordenarlos.

El parámetro -View permite especificar un formato alternativo para la tabla. Puede usar las vistas definidas en los archivos *.format.PS1XML del directorio Windows PowerShell o puede crear sus propias vistas en nuevos archivos PS1XML y usar el cmdlet Update-FormatData para agregarlas a Windows PowerShell.

La vista alternativa del parámetro View debe usar un formato de tabla; de no ser así, se producirá un error al ejecutar 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.

Ejemplo 1

C:\PS>get-childitem | format-wide -column 3

Descripción
-----------
Este comando muestra los nombres de los archivos del directorio actual en tres columnas a lo ancho de toda la pantalla. El cmdlet Get-ChildItem obtiene los objetos que representan los archivos del directorio. El operador de canalización (|) pasa los objetos de archivo a través de la canalización a Format-Wide, que les aplica el formato que tendrán a la salida. El parámetro Column especifica el número de columnas.

Ejemplo 2

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

Descripción
-----------
Este comando muestra los nombres de las claves del Registro en la clave HKEY_CURRENT_USER\Software\Microsoft. El cmdlet Get-ChildItem obtiene los objetos que representan las claves. La ruta de acceso se especifica como "HKCU:", una de las unidades expuestas por el proveedor del Registro de Windows PowerShell, seguida de la ruta de la clave. El operador de canalización (|) pasa los objetos de clave de Registro a través de la canalización a Format-Wide, que les aplica el formato que tendrán a la salida. El parámetro Property especifica el nombre de la propiedad y el parámetro AutoSize ajusta las columnas para facilitar su lectura.