Dela via


ConvertFrom-CliXml

Konverterar en CliXml-formaterad sträng till en anpassad PSObject.

Syntax

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

Description

Cmdleten ConvertFrom-CliXml konverterar strängar som är formaterade som CLI-XML (Common Language Infrastructure) till en anpassad PSObject. Det här kommandot liknar Import-Clixml, men det läse inte från en fil. I stället krävs en sträng som indata.

De nyligen deserialiserade objekten är inte levande objekt. De är en ögonblicksbild av objekten vid tidpunkten för serialiseringen. De deserialiserade objekten innehåller egenskaper men inga metoder. Egenskapen PSTypeNames innehåller det ursprungliga typnamnet med prefixet Deserialized.

Den här cmdleten introducerades i PowerShell 7.5-preview.4.

Exempel

Exempel 1 – Konvertera ett processobjekt till CliXml och tillbaka

Det här exemplet visar resultatet av att konvertera ett processobjekt till CliXml och tillbaka. Först lagras den aktuella processen i variabeln $process. Egenskapen PSTypeNames för processobjektet visar att objektet är av typen System.Diagnostics.Process. Nästa kommando visar antalet för varje typ av medlem i processobjektet.

$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

Därefter konverteras processobjektet till CliXml och tillbaka. Typen av det nya objektet är prefixet med Deserialized. Antalet medlemmar i det nya objektet skiljer sig från det ursprungliga objektet.

Parametrar

-InputObject

Objektet som innehåller en CliXml-formaterad sträng som ska konverteras.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

Utdata

Object