Guarda los datos de formato de la sesión actual en un archivo de formato.
Sintaxis
Export-FormatData [-Force] [-IncludeScriptBlock] [-InputObject <ExtendedTypeDefinition[]>] [-NoClobber] [-Path <string>] [<CommonParameters>]
Descripción
El cmdlet Export-FormatData crea archivos de formato de Windows PowerShell (format.ps1xml) a partir de los objetos de formato de la sesión actual. Toma los objetos ExtendedTypeDefinition devueltos por Get-FormatData y los guarda en un archivo con formato XML.
Windows PowerShell utiliza los datos de los archivos de formato (format.ps1xml) para generar la presentación predeterminada de los objetos de Microsoft .NET Framework en la sesión. Puede ver y modificar los archivos de formato, además de utilizar el cmdlet Update-FormatData para agregar los datos de formato a una sesión.
Para obtener más información sobre los archivos de formato de Windows PowerShell, vea about_Format.ps1xml.
Parámetros
-Force
Sobrescribe un archivo de salida existente, incluso si tiene establecido el atributo de solo lectura.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
False |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-IncludeScriptBlock
Determina si se exportan los bloques de script en los datos de formato.
Dado que los bloques de script contienen código y pueden usarse de manera malintencionada, no se exportan de forma predeterminada.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
False |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-InputObject <ExtendedTypeDefinition[]>
Especifica los objetos de datos de formato que se van a exportar. Escriba una variable que contenga los objetos o un comando que los obtenga, como un comando Get-FormatData. También puede canalizar los objetos de Get-FormatData a Export-FormatData.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-NoClobber
Evita que el cmdlet sobrescriba los archivos existentes. De forma predeterminada, Export-FormatData sobrescribe los archivos sin avisar, a menos que tengan establecido el atributo de solo lectura.
Para indicar a Export-FormatData que sobrescriba los archivos de solo lectura, use el parámetro Force.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Path <string>
Especifica una ubicación para el archivo de salida. Escriba una ruta de acceso (opcional) y un nombre de archivo con la extensión format.ps1xml. Si omite la ruta de acceso, Export-FormatData creará el archivo en el directorio actual.
Si utiliza una extensión distinta de .ps1xml, el cmdlet Update-FormatData no reconocerá el archivo.
Si especifica un archivo existente, Export-FormatData lo sobrescribirá sin avisar, a menos que tenga establecido el atributo de solo lectura. Para que se sobrescriban los archivos de solo lectura, utilice el parámetro Force. Para evitar que se sobrescriban los archivos, use el parámetro NoClobber.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
ninguno |
|
¿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.Management.Automation.ExtendedTypeDefinition Puede canalizar los objetos ExtendedTypeDefinition de Get-FormatData a Export-FormatData. |
|
Salidas |
Ninguno Export-FormatData no devuelve ningún objeto. Genera un archivo y lo guarda en la ruta de acceso especificada. |
Notas
Para poder utilizar cualquier archivo de formato, incluido un archivo de formato exportado, la directiva de ejecución de la sesión debe permitir la ejecución de scripts y archivos de configuración. Para obtener más información, vea about_Execution_Policies.
Ejemplo 1
C:\PS>get-formatdata -typename * | export-formatdata -path allformat.ps1xml -IncludeScriptBlock Descripción ----------- Este comando exporta todos los datos de formato de la sesión al archivo AllFormat.ps1xml. El comando utiliza el cmdlet Get-FormatData para obtener los datos de formato de la sesión. El valor * (todos) del parámetro TypeName indica al cmdlet que obtenga todos los datos de la sesión. El comando utiliza un operador de canalización (|) para enviar los datos de formato del comando Get-FormatData al cmdlet Export-FormatData, que los exporta al archivo AllFormat.ps1. El comando Export-FormatData utiliza el parámetro IncludeScriptBlock para incluir bloques de script en los datos de formato del archivo.
Ejemplo 2
C:\PS>$f = get-formatdata -typename helpinfoshort C:\PS> export-formatdata -inputObject $f -path c:\test\help.format.ps1xml -IncludeScriptBlock Descripción ----------- Estos comandos exportan los datos de formato del tipo HelpInfoShort al archivo Help.format.ps1xml. El primer comando utiliza el cmdlet Get-FormatData para obtener los datos de formato del tipo HelpInfoShort y los guarda en la variable $f. El segundo comando usa el parámetro InputObject de Export-FormatData para especificar como entrada los datos de formato guardados en la variable $f. También utiliza el parámetro IncludeScriptBlock para incluir bloques de script en el resultado.
Ejemplo 3
C:\PS>get-formatdata -typename System.Diagnostics.Process | export-FormatData -path process.format.ps1xml
C:\PS> Update-FormatData -prependPath .\process.format.ps1xml
C:\PS> get-process p*
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
323 5600 powershell
336 3900 powershell_ise
138 4076 PresentationFontCache
Descripción
-----------
En este ejemplo, se muestra el efecto de omitir el parámetro IncludeScriptBlock en un comando Export-FormatData.
El primer comando utiliza el cmdlet Get-FormatData para obtener los datos de formato del objeto System.Diagnostics.Process devuelto por el cmdlet Get-Process. El comando utiliza un operador de canalización (|) para enviar los datos de formato al cmdlet Export-FormatData, que los exporta al archivo Process.format.ps1xml en el directorio actual.
En este caso, el comando Export-FormatData no utiliza el parámetro IncludeScriptBlock.
El segundo comando usa el cmdlet Update-FormatData para agregar el archivo Process.format.ps1xml a la sesión actual. El comando utiliza el parámetro PrependPath para asegurarse de que se encuentren los datos de formato de los objetos de proceso en el archivo Process.format.ps1xml antes de que se localicen los datos de formato estándar de los objetos de proceso.
El tercer comando muestra los efectos de este cambio. El comando utiliza el cmdlet Get-Process para obtener los procesos cuyo nombre comience con "P". En el resultado, no se muestran los valores de propiedad calculados mediante bloques de script.
Vea también