ConvertFrom-CliXml

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

O cmdlet ConvertFrom-CliXml converte cadeias de caracteres formatadas como XML da CLI (Common Language Infrastructure) em um PSObjectpersonalizado. Esse comando é semelhante a Import-Clixml, mas não lê de um arquivo. Em vez disso, ele usa uma cadeia de caracteres como entrada.

Os objetos desserializados recentemente não são objetos dinâmicos. Eles são um instantâneo dos objetos no momento da serialização. Os objetos desserializados incluem propriedades, mas nenhum método. A propriedade pstypenames contém o nome de tipo original prefixado com Deserialized.

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

Este exemplo mostra o resultado da conversão de um objeto de processo para CliXml e de volta. 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 comando a seguir 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 de volta. O tipo do novo objeto é prefixado com Deserialized. A contagem de membros no novo objeto é diferente do objeto original.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.