Sdílet prostřednictvím

ConvertTo-CliXml

  • Reference
Modul:
Microsoft.PowerShell.Utility

Převede objekt na řetězec formátovaný cliXml.

Syntaxe

ConvertTo-CliXml
              [-InputObject] <PSObject>
              [-Depth <Int32>]
              [<CommonParameters>]

Description

Rutina ConvertTo-CliXml převede objekty na řetězce, které jsou formátované jako XML common language infrastructure (CLI). Tento příkaz je podobný Export-Clixml, ale nezapisuje se do souboru. Místo toho vypíše řetězec.

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

-Depth

Určuje, kolik úrovní obsažených objektů je součástí reprezentace XML. Výchozí hodnoty jsou 2.

Typ:Int32
Position:Named
Default value:2
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

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

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

Vstupy

PSObject

Výstupy

String