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




Tabla de contenido