Sdílet prostřednictvím

ConvertFrom-CliXml

  • Reference
Modul:
Microsoft.PowerShell.Utility

Převede řetězec ve formátu CliXml na vlastní objekt PSObject.

Syntaxe

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

Description

Rutina ConvertFrom-CliXml převede řetězce, které jsou formátované jako XML common language infrastructure (CLI) na vlastní objekt PSObject. Tento příkaz je podobný Import-Clixml, ale nečte se ze souboru. Místo toho přebírá jako vstup řetězec.

Nově deserializované objekty nejsou živé objekty. Jedná se o snímek objektů v době serializace. Deserializované objekty zahrnují vlastnosti, ale žádné metody. Vlastnost pstypenames obsahuje původní název typu s předponou Deserialized.

Tato rutina byla zavedena v PowerShellu 7.5-preview.4.

Příklady

Příklad 1 – Převod objektu procesu na CliXml a zpět

Tento příklad ukazuje výsledek převodu objektu procesu na CliXml a zpět. Nejprve je aktuální proces uložen v proměnné $process. Vlastnost pstypenames objektu procesu ukazuje, že objekt je typu System.Diagnostics.Process. Následující příkaz zobrazí počet pro každý typ člena v objektu procesu.

$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ále se objekt procesu převede na CliXml a zpět. Typ nového objektu má předponu Deserialized. Počet členů v novém objektu se liší od původního objektu.

Parametry

-InputObject

Objekt obsahující řetězec formátovaný cliXml, který se má převést.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

Výstupy