Actualiza los datos de formato de la sesión actual.
Sintaxis
Update-FormatData [[-AppendPath] <string[]>] [-PrependPath <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Update-FormatData vuelve a cargar en la sesión actual los datos de formato de los archivos de formato. Este cmdlet permite actualizar los datos de formato sin reiniciar Windows PowerShell.
Sin parámetros, Update-FormatData vuelve a cargar los archivos de formato que cargó anteriormente. Puede utilizar 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 format.ps1xml. Los datos de formato incluidos en los archivos definen cómo se muestran los objetos de Microsoft .NET Framework en la sesión.
Cuando se inicia Windows PowerShell, se cargan en la sesión los datos de formato de los archivos de formato ubicados en el directorio de instalación de Windows PowerShell ($pshome). Puede utilizar Update-FormatData para volver a cargar los datos de formato en la sesión actual sin tener que reiniciar Windows PowerShell. Este cmdlet resulta útil si ha agregado o cambiado un archivo de formato pero no desea interrumpir la sesión.
Para obtener más información sobre los archivos de formato de Windows PowerShell, vea about_Format.ps1xml.
Parámetros
-AppendPath <string[]>
Agrega los archivos de formato especificados 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 los objetos de .NET, Windows PowerShell utiliza la primera definición de formato que encuentre para cada tipo de .NET. Si utiliza el parámetro AppendPath, Windows PowerShell buscará en los datos de los archivos integrados antes de detectar los datos de formato que se agregan.
Utilice este parámetro para agregar un archivo que da formato a un objeto de .NET al que no se hace referencia en los archivos de formato integrados.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PrependPath <string[]>
Agrega los archivos de formato especificados a la sesión. Los archivos se cargan antes de que Windows PowerShell cargue los archivos de formato integrados.
Al dar formato a los objetos de .NET, Windows PowerShell utiliza la primera definición de formato que encuentre para cada tipo de .NET. Si utiliza el parámetro PrependPath, Windows PowerShell buscará en los datos de los archivos que se agregan antes de detectar los datos de formato de los archivos integrados.
Utilice este parámetro para agregar un archivo que da formato a un objeto de .NET al que también se hace referencia en los archivos de formato integrados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.String Puede canalizar a Update-FormatData una cadena que contiene la ruta de acceso que se va a anexar. |
|
Salidas |
Ninguno El cmdlet no devuelve resultados. |
Notas
Update-FormatData también actualiza los datos de formato de los comandos de la sesión que se importaron desde los 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.
Ejemplo 1
C:\PS>update-formatdata Descripción ----------- Este comando vuelve a cargar los archivos de formato que cargó anteriormente.
Ejemplo 2
C:\PS>update-formatdata -appendpath trace.format.ps1xml, log.format.ps1xml Descripción ----------- Este comando vuelve a cargar en la sesión los archivos de formato, incluidos dos archivos nuevos, Trace.format.ps1xml y Log.format.ps1xml. Dado que el comando utiliza el parámetro AppendPath, los datos de formato incluidos en los nuevos archivos se cargan después de que se hayan cargado los datos de formato de los archivos integrados. Se utiliza el parámetro AppendPath porque los nuevos archivos contienen datos de formato para los objetos a los que no se hace referencia en los archivos integrados.
Ejemplo 3
C:\PS>update-formatdata -prependPath c:\test\NewFiles.format.ps1xml # Edit the NewFiles.format.ps1 file. C:\PS> update-formatdata Descripción ----------- En este ejemplo, se muestra cómo volver a cargar un archivo de formato después de haberlo modificado. El primer comando agrega el archivo NewFiles.format.ps1xml a la sesión. Utiliza 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 la sesión, 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 ya se cargó anteriormente, Update-FormatData vuelve a cargarlo automáticamente sin usar ningún parámetro.