Crea una representación basada en XML de uno o varios objetos y la guarda en un archivo.
Sintaxis
Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Export-Clixml crea una representación basada en XML de uno o varios objetos y la guarda en un archivo. Puede usar el cmdlet Import-CLIXML para volver a crear el objeto guardado de acuerdo con el contenido de dicho archivo.
Este cmdlet es similar a ConvertTo-XML, salvo en que Export-Clixml almacena el XML resultante en un archivo. ConvertTo-XML devuelve el XML de modo que se puede continuar procesándolo en Windows PowerShell.
Parámetros
-Depth <int>
Especifica el número de niveles de objetos contenidos que se incluye en la representación XML. El valor predeterminado es 2.
El valor predeterminado se puede invalidar para el tipo de objeto en los archivos Types.ps1xml. Para obtener más información, vea about_Types.ps1xml.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
2 |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Encoding <string>
Especifica el tipo de codificación del archivo de destino. Los valores válidos son ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default y OEM. El valor predeterminado es UTF8.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
UTF8 |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
Fuerza al cmdlet a borrar el atributo de sólo lectura del archivo de salida, si es necesario. El cmdlet intentará restablecer el atributo de sólo lectura cuando el comando finalice su ejecución.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-InputObject <psobject>
Especifica el objeto que se va a convertir. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos. También puede canalizar los objetos a Export-Clixml.
|
¿Requerido? |
true |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-NoClobber
Comprueba que el cmdlet no sobrescribe el contenido de un archivo existente. De forma predeterminada, si existe un archivo en la ruta de acceso especificada, Export-Clixml lo sobrescribe sin avisar.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Path <string>
Especifica la ruta de acceso al archivo en el que se va a guardar la representación XML del objeto.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
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.Management.Automation.PSObject Puede canalizar cualquier objeto a Export-Clixml. |
|
Salidas |
System.IO.FileInfo Export-Clixml crea un archivo que contiene el XML. |
Ejemplo 1
C:\PS>"This is a test" | export-clixml sample.xml Descripción ----------- Este comando crea un archivo XML que almacena una representación de la cadena "This is a test" (esto es una prueba).
Ejemplo 2
C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml C:\PS> $fileacl = import-clixml fileacl.xml Descripción ----------- En este ejemplo se muestra cómo exportar un objeto a un archivo XML y, a continuación, crear un objeto importando el XML del archivo. El primer comando usa el cmdlet Get-ACL para obtener el descriptor de seguridad del archivo Test.txt. Utiliza un operador de canalización para pasar el descriptor de seguridad a Export-Clixml, que almacena una representación basada en XML del objeto en un archivo denominado FileACL.xml. El segundo comando usa el cmdlet Import-Clixml para crear un objeto a partir del XML en el archivo FileACL.xml. A continuación, guarda el objeto en la variable $FileAcl.
Vea también