Partilhar 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 CLI (Common Language Infrastructure). Este comando é semelhante ao Export-Clixml, mas não grava em um arquivo. Em vez disso, ele gera uma cadeia de caracteres.

Este 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 process mostra que o objeto é do tipo System.Diagnostics.Process. O próximo comando exibe a contagem para 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 são incluídos na representação XML. Os valores padrão são 2.

Tipo:Int32
Position:Named
Default value:2
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

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

Tipo:PSObject
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

PSObject

Saídas

String