Compartir a través de

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 cmdlet Update-FormatData vuelve a cargar los datos de formato de los archivos de formato en la sesión actual. Este cmdlet permite actualizar los datos de formato sin tener que reiniciar Windows PowerShell.

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

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

Cuando Windows PowerShell se inicia, carga los datos de formato de los archivos de formato en el directorio de instalación de Windows PowerShell ($pshome) en la sesión. Puede usar Update-FormatData para volver a cargar los datos de formato en la sesión actual sin reiniciar Windows 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 acerca de los archivos de formato en Windows PowerShell, consulte about_Format.ps1xml.

Ejemplos

Ejemplo 1: Volver a cargar archivos de formato cargados anteriormente

PS C:\> Update-FormatData

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

Ejemplo 2: Volver a cargar archivos de formato y archivos de formato de seguimiento y registro

PS C:\> 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 objetos a los que no se hace referencia en los archivos integrados.

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

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

# Edit the NewFiles.format.ps1 file.

PS C:\> 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 cmdlet Update-FormatData para volver a cargar los archivos de formato. Dado que el archivo NewFiles.format.ps1xml se cargó anteriormente, Update-FormatData lo vuelve a cargar 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 Windows PowerShell haya cargado los archivos de formato integrados.

Al dar formato a objetos .NET, Windows PowerShell usa la primera definición de formato que encuentre para cada tipo .NET. Si usa el parámetro AppendPath, Windows 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 Windows PowerShell haya cargado los archivos de formato integrados.

Al dar formato a objetos .NET, Windows PowerShell usa la primera definición de formato que encuentre para cada tipo .NET. Si usa el parámetro PrependPath, Windows PowerShell busca los datos de los archivos que va a agregar antes de encontrar 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 Update-FormatData.

Salidas

None

Este cmdlet no devuelve resultados.

Notas

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