Import-Clixml
Importa un archivo CLIXML y crea los objetos correspondientes en PowerShell.
Sintaxis
ByPath (valor predeterminado)
Import-Clixml
[-Path] <String[]>
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>]
ByLiteralPath
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.
Propiedades de parámetro
| Tipo: | UInt64 |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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. Ninguno de los caracteres se interpreta 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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PSPath |
Conjuntos de parámetros
ByLiteralPath
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Path
Especifica la ruta de acceso a los archivos XML.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByPath
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | UInt64 |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
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>.