Compartir vía

Update-FormatData

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

Default (Es el valor predeterminado). 

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

Description

El cmdlet Update-FormatData vuelve a cargar los datos de formato desde archivos de formato a 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: Volver a cargar archivos de formato y rastrear y registrar archivos de formato

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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PSPath, Ruta

Conjuntos de parámetros

(All)
Posición:0
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

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.

Entradas

String

Se puede canalizar una cadena que contiene la ruta de acceso de anexión 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.