Delen via

ConvertFrom-CliXml

  • Referentie
Module:
Microsoft.PowerShell.Utility

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

Syntaxis

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 laat zien 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.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

Object