Compartilhar via

ConvertTo-CliXml

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Converte um objeto em uma cadeia de caracteres formatada em CliXml.

Sintaxe

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

Description

O ConvertTo-CliXml cmdlet converte objetos em cadeias de caracteres formatadas como XML da CLI (Common Language Infrastructure). Esse comando é semelhante ao Export-Clixml, mas não grava em um arquivo. Em vez disso, ele gera uma cadeia de caracteres.

Esse cmdlet foi introduzido no PowerShell 7.5-preview.4.

Exemplos

Exemplo 1 – Converter um objeto de processo em CliXml e vice-versa

Este exemplo mostra o resultado da conversão de um objeto de processo em CliXml e vice-versa. Primeiro, o processo atual é armazenado na variável $process. A propriedade PSTypeNames do objeto de processo mostra que o objeto é do tipo System.Diagnostics.Process. O próximo comando exibe a contagem de cada tipo de membro no objeto de processo.

$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

Em seguida, o objeto de processo é convertido em CliXml e vice-versa. O tipo do novo objeto é prefixado com Deserialized. A contagem de membros no novo objeto é diferente do objeto original.

Parâmetros

-Depth

Especifica quantos níveis de objetos contidos estão incluídos na representação XML. Os valores padrão são 2.

Tipo:Int32
Cargo:Named
Valor padrão:2
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

O objeto a ser convertido em uma cadeia de caracteres formatada em CliXml.

Tipo:PSObject
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

PSObject

Saídas

String