Udostępnij za pośrednictwem

ConvertTo-CliXml

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Konwertuje obiekt na ciąg w formacie CliXml.

Składnia

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

Opis

Polecenie ConvertTo-CliXml cmdlet konwertuje obiekty na ciągi sformatowane jako xml infrastruktury języka wspólnego (CLI). To polecenie jest podobne do Export-Clixmlpolecenia , ale nie zapisuje w pliku. Zamiast tego zwraca ciąg.

To polecenie cmdlet zostało wprowadzone w programie PowerShell 7.5-preview.4.

Przykłady

Przykład 1 — konwertowanie obiektu procesu na interfejs Wiersza polecenia i z powrotem

W tym przykładzie pokazano wynik konwersji obiektu procesu na cliXml i z powrotem. Najpierw bieżący proces jest przechowywany w zmiennej $process. Właściwość PSTypeNames obiektu procesu pokazuje, że obiekt jest typu System.Diagnostics.Process. Następne polecenie wyświetla liczbę dla każdego typu elementu członkowskiego w obiekcie 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

Następnie obiekt procesu jest konwertowany na interfejs CliXml i z powrotem. Typ nowego obiektu ma prefiks Deserialized. Liczba elementów członkowskich w nowym obiekcie różni się od oryginalnego obiektu.

Parametry

-Depth

Określa, ile poziomów zawartych obiektów jest uwzględnionych w reprezentacji XML. Wartości domyślne to 2.

Typ:Int32
Position:Named
Domyślna wartość:2
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Obiekt, który ma zostać przekonwertowany na ciąg w formacie CliXml.

Typ:PSObject
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSObject

Dane wyjściowe

String