Compartir a través de

ConvertFrom-CliXml

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Convierte una cadena con formato CliXml en un PSObject personalizado.

Sintaxis

ConvertFrom-CliXml
                [-InputObject] <String>
                [<CommonParameters>]

Description

El ConvertFrom-CliXml cmdlet convierte cadenas con formato XML de Common Language Infrastructure (CLI) en un PSObject personalizado. Este comando es similar a Import-Clixml, pero no lee de un archivo. En su lugar, toma una cadena como entrada.

Los objetos recién deserializados no son objetos dinámicos. Son una instantánea de los objetos en el momento de la serialización. Los objetos deserializados incluyen propiedades, pero no métodos. La propiedad PSTypeNames contiene el nombre de tipo original con Deserializedel prefijo .

Este cmdlet se introdujo en PowerShell 7.5-preview.4.

Ejemplos

Ejemplo 1: Conversión de un objeto de proceso en CliXml y retroceso

En este ejemplo se muestra el resultado de convertir un objeto de proceso en CliXml y atrás. En primer lugar, el proceso actual se almacena en la variable $process. La propiedad PSTypeNames del objeto process muestra que el objeto es de tipo System.Diagnostics.Process. El comando siguiente muestra el recuento de cada tipo de miembro en el objeto de proceso.

$process = Get-Process -Id $PID
$process.PSTypeNames

System.Diagnostics.Process
System.ComponentModel.Component
System.MarshalByRefObject
System.Object

$process | Get-Member | Group-Object MemberType | Select-Object Name, Count

Name           Count
----           -----
AliasProperty      7
CodeProperty       1
Property          52
NoteProperty       1
ScriptProperty     8
PropertySet        2
Method            19
Event              4

$xml = $process | ConvertTo-CliXml
$fromXML = ConvertFrom-CliXml $xml
$fromXML.PSTypeNames

Deserialized.System.Diagnostics.Process
Deserialized.System.ComponentModel.Component
Deserialized.System.MarshalByRefObject
Deserialized.System.Object

$fromXML | Get-Member | Group-Object MemberType | Select-Object Name, Count

Name         Count
----         -----
Property        46
NoteProperty    17
PropertySet      2
Method           2

A continuación, el objeto de proceso se convierte en CliXml y de vuelta. El tipo del nuevo objeto tiene el Deserializedprefijo . El recuento de miembros del nuevo objeto es diferente del objeto original.

Parámetros

-InputObject

Objeto que contiene una cadena con formato CliXml que se va a convertir.

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

Entradas

String

Salidas

Object