Compartir a través de

ConvertTo-CliXml

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Convierte un objeto en una cadena con formato CliXml.

Sintaxis

ConvertTo-CliXml
              [-InputObject] <PSObject>
              [-Depth <Int32>]
              [<CommonParameters>]

Description

El ConvertTo-CliXml cmdlet convierte objetos en cadenas con formato XML de Common Language Infrastructure (CLI). Este comando es similar a Export-Clixml, pero no escribe en un archivo. En su lugar, genera una cadena.

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

-Depth

Especifica el número de niveles de los objetos contenidos que se incluye en la representación XML. Los valores predeterminados son 2.

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

-InputObject

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

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

Entradas

PSObject

Salidas

String