Compartir a través de

Import-Clixml

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Importa un archivo CLIXML y crea los objetos correspondientes en PowerShell.

Sintaxis

Import-Clixml
      [-Path] <String[]>
      [-IncludeTotalCount]
      [-Skip <UInt64>]
      [-First <UInt64>]
      [<CommonParameters>]
Import-Clixml
      -LiteralPath <String[]>
      [-IncludeTotalCount]
      [-Skip <UInt64>]
      [-First <UInt64>]
      [<CommonParameters>]

Description

El cmdlet Import-Clixml importa un archivo XML de Common Language Infrastructure (CLI) con datos que representan objetos de Microsoft .NET Framework y crea los objetos de PowerShell. Para obtener más información sobre la CLI, consulte de independencia del lenguaje .

Un uso valioso de Import-Clixml en equipos Windows es importar credenciales y cadenas seguras que se exportaron como XML seguro mediante Export-Clixml. Para obtener un ejemplo, vea Ejemplo 2.

Import-Clixml usa la marca de orden de bytes (BOM) para detectar el formato de codificación del archivo. Si el archivo no tiene boM, supone que la codificación es UTF8.

Ejemplos

Ejemplo 1: Importar un archivo serializado y volver a crear un objeto

En este ejemplo se usa el cmdlet Export-Clixml para guardar una copia serializada de la información del proceso devuelta por Get-Process. Import-Clixml recupera el contenido del archivo serializado y vuelve a crear un objeto almacenado en la variable $Processes.

Get-Process | Export-Clixml -Path .\pi.xml
$Processes = Import-Clixml -Path .\pi.xml

Ejemplo 2: Importación de un objeto de credencial segura

En este ejemplo, dada una credencial que ha almacenado en la variable $Credential ejecutando el cmdlet Get-Credential, puede ejecutar el cmdlet Export-Clixml para guardar la credencial en el disco.

Importante

Export-Clixml solo exporta credenciales cifradas en Windows. En sistemas operativos que no son Windows, como macOS y Linux, las credenciales se exportan en texto sin formato.

$Credxmlpath = Join-Path (Split-Path $Profile) TestScript.ps1.credential
$Credential | Export-Clixml $Credxmlpath
$Credxmlpath = Join-Path (Split-Path $Profile) TestScript.ps1.credential
$Credential = Import-Clixml $Credxmlpath

El cmdlet Export-Clixml cifra los objetos de credenciales mediante la API de protección de datos de Windows . El cifrado garantiza que solo la cuenta de usuario pueda descifrar el contenido del objeto de credencial. El archivo CLIXML exportado no se puede usar en un equipo diferente o en otro usuario.

En el ejemplo, el archivo en el que se almacena la credencial se representa mediante TestScript.ps1.credential. Reemplace testScript por el nombre del script por el que va a cargar la credencial.

Envíe el objeto de credencial a la canalización a Export-Clixmly guárdelo en la ruta de acceso, $Credxmlpath, que especificó en el primer comando.

Para importar automáticamente la credencial en el script, ejecute los dos comandos finales. Ejecute Import-Clixml para importar el objeto de credencial segura en el script. Esta importación elimina el riesgo de exponer contraseñas de texto sin formato en el script.

Parámetros

-First

Obtiene solo el número especificado de objetos. Escriba el número de objetos que se van a obtener.

Tipo:UInt64
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IncludeTotalCount

Informa del número total de objetos del conjunto de datos seguido de los objetos seleccionados. Si el cmdlet no puede determinar el recuento total, muestra recuento total desconocido. El entero tiene una propiedad Precision que indica la confiabilidad del valor de recuento total. El valor de Precision intervalos de 0.0 a 1.0 donde 0.0 significa que el cmdlet no pudo contar los objetos, 1.0 significa que el recuento es exacto y un valor entre 0.0 y 1.0 indica una estimación cada vez más confiable.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LiteralPath

Especifica la ruta de acceso a los archivos XML. A diferencia de path, el valor del parámetro LiteralPath se usa exactamente como se escribe. No se interpreta ningún carácter como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Tipo:String[]
Alias:PSPath
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso a los archivos XML.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Skip

Omite el número especificado de objetos y, a continuación, obtiene los objetos restantes. Escriba el número de objetos que se van a omitir.

Tipo:UInt64
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalización de una cadena que contenga una ruta de acceso a Import-Clixml.

Salidas

PSObject

Import-Clixml devuelve objetos deserializados a partir de los archivos XML almacenados.

Notas

Al especificar varios valores para un parámetro, use comas para separar los valores. Por ejemplo, <parameter-name> <value1>, <value2>.