Format-Table

Format-Table
    [[-Property] <Object[]>]
    [-AutoSize]
    [-HideTableHeaders]
    [-Wrap]
    [-GroupBy <Object>]
    [-View <string>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <string>]
    [-InputObject <psobject>]
    [<CommonParameters>]

El cmdlet Format-Table da formato a la salida de un comando como una tabla con las propiedades seleccionadas del objeto en cada columna. El tipo de objeto determina el diseño predeterminado y las propiedades que se muestran en cada columna, pero puede usar el parámetro Property para seleccionar las propiedades que desea ver.

También puede usar una tabla hash para agregar propiedades calculadas a un objeto antes de mostrarla y especificar los encabezados de columna en la tabla. Para agregar una propiedad calculada, use el parámetro Property o Group By.

Este comando muestra información sobre el programa host para PowerShell en una tabla. De forma predeterminada, tienen formato en una lista.

Get-Host | Format-Table -AutoSize

El cmdlet Get-Host obtiene objetos que representan el host. El operador de canalización (|) pasa el objeto al cmdlet Format-Table. El cmdlet Format-Table da formato a los objetos de una tabla. El parámetro AutoSize ajusta los anchos de columna para minimizar el truncamiento.

Este comando muestra los procesos del equipo en grupos con la misma prioridad base.

Get-Process | Sort-Object -Property basepriority | Format-Table -GroupBy basepriority -Wrap

El cmdlet Get-Process obtiene objetos que representan cada proceso del equipo. El operador de canalización (|) pasa el objeto al cmdlet Sort-Object, que ordena los objetos en orden de su prioridad base.

Otro operador de canalización pasa los resultados al cmdlet Format-Table. El parámetro GroupBy organiza los datos sobre los procesos en grupos en función del valor de su propiedad BasePriority. El parámetro Wrap garantiza que los datos no se truncan.

Get-Process | Sort-Object starttime | Format-Table -View starttime

Este comando muestra información sobre los procesos del equipo en grupo en función de la fecha de inicio del proceso. Usa el cmdlet Get-Process para obtener objetos que representan los procesos del equipo. El operador de canalización (|) envía la salida de Get-Process al cmdlet Sort-Object, que lo ordena en función de la propiedad StartTime. Otro operador de canalización envía los resultados ordenados a Format-Table.

El parámetro View se usa para seleccionar la vista startTime de definida en el archivo de para objetos System.Diagnostics.Process, como los devueltos por . Esta vista convierte el StartTime del proceso en una fecha corta y, a continuación, agrupa los procesos por fecha de inicio.

El archivo DotNetTypes.format.ps1xml también contiene una vista de prioridad para los procesos. Puede crear sus propios archivos format.ps1xml con vistas personalizadas.

Get-Service | Format-Table -Property Name, DependentServices

Este comando muestra todos los servicios del equipo de una tabla con dos columnas, Nombre y DependentServices. El cmdlet Get-Service obtiene todos los servicios del equipo. El operador de canalización (|) envía los resultados al cmdlet Format-Table, que da formato a la salida en una tabla. El parámetro Property especifica las propiedades que aparecen en la tabla como columnas. El nombre del parámetro Property es opcional, por lo que puede omitirlo, por ejemplo, Format-Table Name, DependentServices.

Name y DependentServices son solo dos de las propiedades de los objetos de servicio. Para ver todas las propiedades, escriba Get-Service | Get-Member -MemberType Properties.

Este comando muestra cómo usar una propiedad calculada en una tabla.

Get-Process Notepad | Format-Table ProcessName,
   @{Label="TotalRunningTime"; Expression={(Get-Date) - $_.StartTime}}

El comando muestra una tabla con el nombre del proceso y el tiempo de ejecución total de todos los procesos del Bloc de notas en el equipo local. El tiempo de ejecución total se calcula restando la hora de inicio de cada proceso de la hora actual.

El comando usa el cmdlet Get-Process para obtener todos los procesos denominados Bloc de notas en el equipo local. El operador de canalización (|) envía los resultados a Format-Table, que muestra una tabla con dos columnas: ProcessName, una propiedad estándar de procesos y TotalRunningTime, una propiedad calculada.

La propiedad TotalRunningTime se especifica mediante una tabla hash con dos claves, Etiqueta y Expresión. El nombre de la propiedad se asigna a la clave Etiqueta. El cálculo se asigna a la clave Expresión. La expresión obtiene la propiedad StartTime de cada objeto de proceso y la resta del resultado de un comando Get-Date, que obtiene la fecha y hora actuales.

Estos comandos son similares al comando anterior, salvo que estos comandos usan el cmdlet Get-WmiObject.

$Processes = Get-WmiObject -ComputerName "Server01" -Class win32_process -Filter "name='notepad.exe'"
$Processes | Format-Table ProcessName, @{ Label = "Total Running Time"; Expression={(Get-Date) - $_.ConvertToDateTime($_.CreationDate)}}

El primer comando usa el cmdlet Get-WmiObject para obtener instancias de la clase Win32_Process WMI que describe todos los procesos del equipo Server01 denominados Notepad.exe. El comando almacena la información del proceso en la variable $Processes.

El segundo comando usa un operador de canalización (|) para enviar la información del proceso en la variable $Processes al cmdlet Format-Table, que muestra el ProcessName y una nueva propiedad calculada.

El comando asigna el nombre de la nueva propiedad calculada, "Tiempo total de ejecución", a la etiqueta clave. El bloque de script que se asigna a la expresión clave calcula cuánto tiempo se ha ejecutado el proceso restando la fecha de creación del proceso a partir de la fecha actual. El cmdlet Get-Date obtiene la fecha actual. El método ConvertToDateTime de convierte la propiedad CreationDate del objeto Win32_Process de un objeto WMI CIM_DATETIME a un objeto DateTime de .NET que se puede comparar con la salida de . A continuación, la fecha de creación convertida se resta de la fecha actual. El resultado es el valor de tiempo de ejecución total.

En los ejemplos siguientes se muestran los resultados de agregar los parámetros DisplayError o ShowError con una expresión.

PC /> Get-Date | Format-Table DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek  $_ / $null
--------- ------------
Wednesday #ERR

PC /> Get-Date | Format-Table DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek  $_ / $null
--------- ------------
Wednesday

Failed to evaluate expression " $_ / $null ".
    + CategoryInfo          : InvalidArgument: (10/30/2013 2:28:07 PM:PSObject) \[\], RuntimeException
    + FullyQualifiedErrorId : mshExpressionError

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar cualquier objeto a Format-Table.

Format-Table devuelve objetos de formato que representan la tabla.

El parámetro GroupBy supone que los objetos están ordenados. Use el cmdlet Sort-Object antes de usar Format-Table para agrupar los objetos.

El parámetro View permite especificar un formato alternativo para la tabla. Puede usar las vistas definidas en los archivos de *.format.PS1XML en el directorio de PowerShell o puede crear sus propias vistas en los nuevos archivos PS1XML y, a continuación, usar el cmdlet Update-FormatData para incluirlos en PowerShell. Las vistas alternativas para el parámetro View deben usar el formato de tabla; de lo contrario, se produce un error en el comando. Si la vista alternativa es una lista, use el cmdlet Format-List. Si la vista alternativa no es una lista o una tabla, use el cmdlet Format-Custom.