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. Este comando é semelhante ao Import-Clixml, mas não lê de um ficheiro. Em vez disso, ele usa uma cadeia de caracteres como entrada.

Os objetos recém-desserializados 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 do tipo original prefixado com Deserialized.

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

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.

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.