Compartir a través de

Update-FormatData

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

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

Sintaxis

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 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 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 de los archivos definen la presentación de 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 ha agregado o cambiado un archivo de formato, pero no desea 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 cargó anteriormente.

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 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 volver a cargar un archivo de formato después de editarlo.

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 los 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 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.

Tipo:String[]
Alias:PSPath, Path
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

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

Salidas

None

Este cmdlet no devuelve ninguna salida.

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 comando Update-FormatData para actualizar los datos de formato de los comandos importados. No es necesario volver a importar el módulo.