ConvertFrom-CliXml

Converteert een tekenreeks met cliXml-indeling naar een aangepast PSObject.

Syntax

Default (Standaard)

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

Description

De ConvertFrom-CliXml cmdlet converteert tekenreeksen die zijn opgemaakt als COMMON Language Infrastructure (CLI) XML naar een aangepast 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 eigenschap pstypenames bevat de oorspronkelijke typenaam met het voorvoegsel Deserialized.

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

Voorbeelden

Voorbeeld 1: een procesobject converteren naar CliXml en terug

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 eigenschap pstypenames van het procesobject geeft aan dat het object van het type System.Diagnostics.Process is. 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.

Parameters

-InputObject

Het object met een tekenreeks met cliXml-indeling die moet worden geconverteerd.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

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

Invoerwaarden

String

Uitvoerwaarden

Object