Update-FormatData

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Actualiza los datos de formato de la sesión actual.

Syntax

Update-FormatData
      [[-AppendPath] <String[]>]
      [-PrependPath <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El Update-FormatData cmdlet vuelve a cargar los datos de formato de los archivos de formato en la sesión actual. Este cmdlet le permite actualizar los datos de formato sin reiniciar PowerShell.

Sin parámetros, Update-FormatData vuelve a cargar los archivos de formato que cargó anteriormente. Puede usar los parámetros de para agregar nuevos archivos de Update-FormatData formato a la sesión.

Los archivos de formato son archivos de texto en formato XML con la extensión de nombre de format.ps1xml archivo. Los datos de formato en los archivos definen la visualización de los objetos de Microsoft .NET Framework en la sesión.

Cuando se inicia PowerShell, carga los datos de formato desde el código fuente de PowerShell. Sin embargo, puede crear archivos format.ps1xml personalizados para actualizar el formato en la sesión actual. Puede usar Update-FormatData para volver a cargar los datos de formato en la sesión actual sin reiniciar PowerShell. Esto resulta útil cuando se ha agregado o cambiado un archivo de formato, pero no se quiere interrumpir la sesión.

Para obtener más información sobre el formato de archivos en PowerShell, consulte about_Format.ps1xml.

Ejemplos

Ejemplo 1: Recarga de archivos de formato cargados anteriormente

Update-FormatData

Este comando vuelve a cargar los archivos de formato que se cargaron previamente.

Ejemplo 2: Recarga de archivos de formato y archivos de formato de seguimiento y registro

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

Este comando vuelve a cargar los archivos de formato en la sesión, incluidos los dos nuevos archivos, Trace.format.ps1xml y Log.format.ps1xml.

Dado que el comando usa el parámetro AppendPath , los datos de formato de los nuevos archivos se cargan después de los datos de formato de los archivos integrados.

El parámetro AppendPath se usa porque los nuevos archivos contienen datos de formato para los objetos a los que no se hace referencia en los archivos integrados.

Ejemplo 3: Editar un archivo de formato y volver a cargarlo

Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

Update-FormatData

En este ejemplo se muestra cómo cargar un archivo de formato después de haberlo editado.

El primer comando agrega el archivo NewFiles.format.ps1xml a la sesión. Usa el parámetro PrependPath porque el archivo contiene datos de formato para objetos a los que se hace referencia en los archivos integrados.

Después de agregar el archivo NewFiles.format.ps1xml y probarlo en estas sesiones, el autor edita el archivo.

El segundo comando usa el Update-FormatData cmdlet para volver a cargar los archivos de formato. Dado que el archivo NewFiles.format.ps1xml se cargó anteriormente, Update-FormatData vuelve a cargarlo automáticamente sin usar parámetros.

Parámetros

-AppendPath

Especifica los archivos de formato que este cmdlet agrega a la sesión. Los archivos se cargan después de que PowerShell cargue los archivos de formato integrados.

Al aplicar formato a objetos .NET, PowerShell usa la primera definición de formato que encuentra para cada tipo de .NET. Si usa el parámetro AppendPath , PowerShell busca los datos de los archivos integrados antes de encontrar los datos de formato que va a agregar.

Use este parámetro para agregar un archivo que da formato a un objeto .NET al que no se hace referencia en los archivos de formato integrados.

Type:String[]
Aliases:PSPath, Path
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrependPath

Especifica los archivos de formato que este cmdlet agrega a la sesión. Los archivos se cargan antes de que PowerShell cargue los archivos de formato integrados.

Al aplicar formato a objetos .NET, PowerShell usa la primera definición de formato que encuentra para cada tipo de .NET. Si usa el parámetro PrependPath , PowerShell busca los datos de los archivos que va a agregar antes de que encuentre los datos de formato de los archivos integrados.

Use este parámetro para agregar un archivo que da formato a un objeto .NET al que también se hace referencia en los archivos de formato integrados.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Puede canalizar una cadena que contenga la ruta de acceso anexada a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

  • Update-FormatData también actualiza los datos de formato de los comandos de la sesión que se importaron desde módulos. Si cambia el archivo de formato de un módulo, puede ejecutar un Update-FormatData comando para actualizar los datos de formato de los comandos importados. No es necesario volver a importar el módulo.