ConvertTo-CliXml
Převede objekt na řetězec formátovaný cliXml.
Syntax
Default (Výchozí)
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.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | 2 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Objekt, který se má převést na řetězec formátovaný cliXml.
Vlastnosti parametru
| Typ: | PSObject |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
