Format-Custom

Sintaxis

Default (valor predeterminado)

Format-Custom
    [[-Property] <Object[]>]
    [-Depth <Int32>]
    [-GroupBy <Object>]
    [-View <String>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <String>]
    [-InputObject <PSObject>]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Dar formato a la salida con una vista personalizada

Get-Command Start-Transcript | Format-Custom -View MyView

Ejemplo 2: Dar formato a la salida con la vista predeterminada

Get-Process Winlogon | Format-Custom

Ejemplo 3: Solución de errores de formato

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

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  = #ERR
}


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

class DateTime
{
  DayOfWeek = Friday
   $_ / $null  =
}

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 8:01:04 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parámetros

-Depth

Especifica el número de columnas de la pantalla.

Propiedades de parámetro

Conjuntos de parámetros

-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 comando Format-Custom y las expresiones no parecen funcionar.

Propiedades de parámetro

Conjuntos de parámetros

-Expand

Da formato al objeto de colección, así como a los objetos de la colección. Este parámetro está diseñado para dar formato a los objetos que admiten 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 de colección.
• Ambos: muestra las propiedades del objeto de colección y las propiedades de los objetos de la colección.

Propiedades de parámetro

Conjuntos de parámetros

-Force

Dirige el cmdlet para mostrar toda la información de error. Use con los parámetros DisplayError o ShowError. De forma predeterminada, cuando se escribe un objeto de error en las secuencias de error o de visualización, solo se muestra parte de la información de error.

Propiedades de parámetro

Conjuntos de parámetros

-GroupBy

Da formato a la salida en grupos en función de una propiedad o valor compartidos. Escriba 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, use una tabla hash. Las claves válidas son:

• Nombre (o etiqueta) <cadena>
• Expresión <cadena> o <bloque de script>
• < de cadena formatString >

Propiedades de parámetro

Conjuntos de parámetros

-InputObject

Especifica los objetos a los que se va a dar formato. Escriba una variable que contenga los objetos o escriba un comando o expresión que obtenga los objetos.

Propiedades de parámetro

Conjuntos de parámetros

-Property

Especifica las propiedades del objeto que aparecen en la pantalla y el orden en que aparecen. Se permiten los caracteres comodín.

Si omite este parámetro, las propiedades que aparecen en la pantalla dependen del objeto que se muestra. El nombre del parámetro ("Property") es opcional. No se pueden usar los parámetros Property y View en un solo comando.

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

• Expresión <cadena> o <bloque de script>
• Profundidad <> int32

Propiedades de parámetro

Conjuntos de parámetros

-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 comando Format-Custom y las expresiones no parecen funcionar.

Propiedades de parámetro

Conjuntos de parámetros

-View

Especifica el nombre de un formato alternativo o "vista". Si omite este parámetro, Format-Custom usa una vista personalizada predeterminada. No se pueden usar los parámetros Property y View en un solo comando.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

PSObject

Salidas

Microsoft.PowerShell.Commands.Internal.Format

Notas

Vínculos relacionados

• Format-Hex
• Format-List
• Format-Table
• Format-Wide
• Get-Process