Partager via

ConvertFrom-CliXml

  • Référence
Module:
Microsoft.PowerShell.Utility

Convertit une chaîne au format CliXml en objet PSObject personnalisé.

Syntaxe

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

Description

L’applet ConvertFrom-CliXml de commande convertit les chaînes mises en forme en XML d’infrastructure de langage commun (CLI) en un PSObject personnalisé. 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éfixé par Deserialized.

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

Exemples

Exemple 1 : convertir un objet de processus en CliXml et en arrière

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.

Paramètres

-InputObject

Objet contenant une chaîne au format CliXml à convertir.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

String

Sorties

Object