ConvertTo-CliXml

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

Met de cmdlet ConvertTo-CliXml worden objecten geconverteerd naar tekenreeksen die zijn opgemaakt als CLI-XML (Common Language Infrastructure). Deze opdracht is vergelijkbaar met Export-Clixml, maar schrijft niet naar een bestand. In plaats daarvan wordt een tekenreeks uitgevoerd.

Deze cmdlet is geïntroduceerd in PowerShell 7.5-preview.4.

In dit voorbeeld ziet u het resultaat van het converteren van een procesobject naar CliXml en terug. Eerst wordt het huidige proces opgeslagen in de variabele $process. De pstypenames eigenschap van het procesobject geeft aan dat het object van het type is System.Diagnostics.Process. Met de volgende opdracht wordt het aantal voor elk type lid in het procesobject weergegeven.

$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

Vervolgens wordt het procesobject geconverteerd naar CliXml en terug. Het type van het nieuwe object wordt voorafgegaan door Deserialized. Het aantal leden in het nieuwe object verschilt van het oorspronkelijke object.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.