ConvertFrom-CliXml

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

L’applet de commande ConvertFrom-CliXml convertit les chaînes mises en forme en XML (Common Language Infrastructure) en PSObjectpersonnalisées. Cette commande est similaire à Import-Clixml, mais elle ne lit pas à partir d’un fichier. Au lieu de cela, il prend une chaîne comme entrée.

Les objets nouvellement désérialisés ne sont pas des objets actifs. Il s’agit d’un instantané des objets au moment de la sérialisation. Les objets désérialisés incluent des propriétés, mais aucune méthode. La propriété pstypenames contient le nom de type d’origine précédé de Deserialized.

Cette applet de commande a été introduite dans PowerShell 7.5-preview.4.

Cet exemple montre le résultat de la conversion d’un objet de processus en CliXml et en arrière. Tout d’abord, le processus actuel est stocké dans la variable $process. La propriété pstypenames de l’objet de processus indique que l’objet est de type System.Diagnostics.Process. La commande suivante affiche le nombre pour chaque type de membre dans l’objet de processus.

$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

Ensuite, l’objet de processus est converti en CliXml et en arrière. Le type du nouvel objet est préfixé par Deserialized. Le nombre de membres dans le nouvel objet est différent de l’objet d’origine.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.