ConvertTo-CliXml
Konvertiert ein Objekt in eine cliXml-formatierte Zeichenfolge.
Syntax
Default (Standardwert)
ConvertTo-CliXml
[-InputObject] <PSObject>
[-Depth <Int32>]
[<CommonParameters>]
Beschreibung
Das Cmdlet ConvertTo-CliXml konvertiert Objekte in Zeichenfolgen, die als CLI-XML (Common Language Infrastructure) formatiert sind. Dieser Befehl ähnelt Export-Clixml, schreibt aber nicht in eine Datei. Stattdessen wird eine Zeichenfolge ausgegeben.
Dieses Cmdlet wurde in PowerShell 7.5-preview.4 eingeführt.
Beispiele
Beispiel 1: Konvertieren eines Prozessobjekts in CliXml und zurück
Dieses Beispiel zeigt das Ergebnis der Konvertierung eines Prozessobjekts in CliXml und zurück. Zuerst wird der aktuelle Prozess in der Variablen $processgespeichert. Die pstypenames Eigenschaft des Prozessobjekts zeigt, dass das Objekt vom Typ System.Diagnostics.Processist. Der nächste Befehl zeigt die Anzahl für jeden Mitgliedstyp im Prozessobjekt an.
$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
Anschließend wird das Prozessobjekt in CliXml und zurück konvertiert. Der Typ des neuen Objekts wird mit Deserializedversehen. Die Anzahl der Elemente im neuen Objekt unterscheidet sich von dem ursprünglichen Objekt.
Parameter
-Depth
Gibt an, wie viele Ebenen von enthaltenen Objekten in der XML-Darstellung enthalten sind. Die Standardwerte sind 2.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | 2 |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InputObject
Das Objekt, das in eine cliXml-formatierte Zeichenfolge konvertiert werden soll.
Parametereigenschaften
| Typ: | PSObject |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
