ConvertFrom-CliXml

ConvertFrom-CliXml
    [-InputObject] <String>
    [<CommonParameters>]

De ConvertFrom-CliXml-cmdlet converteert tekenreeksen die zijn opgemaakt als Common Language Infrastructure (CLI) XML naar een aangepaste PSObject-. Deze opdracht is vergelijkbaar met Import-Clixml, maar wordt niet gelezen uit een bestand. In plaats daarvan wordt een tekenreeks als invoer gebruikt.

De nieuw gedeserialiseerde objecten zijn geen levende objecten. Ze zijn een momentopname van de objecten op het moment van serialisatie. De gedeserialiseerde objecten bevatten eigenschappen, maar geen methoden. De pstypenames eigenschap bevat de oorspronkelijke typenaam voorafgegaan door Deserialized.

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.