Partager via

ConvertTo-CliXml

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

Convertit un objet en chaîne au format CliXml.

Syntaxe

ConvertTo-CliXml
              [-InputObject] <PSObject>
              [-Depth <Int32>]
              [<CommonParameters>]

Description

L’applet ConvertTo-CliXml de commande convertit les objets en chaînes mises en forme en xml de Common Language Infrastructure (CLI). Cette commande est similaire à Export-Clixml, mais elle n’écrit pas dans un fichier. Au lieu de cela, il génère une chaîne.

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

-Depth

Spécifie le nombre de niveaux d'objets contenus inclus dans la représentation XML. Les valeurs par défaut sont 2.

Type:Int32
Position:Named
Valeur par défaut:2
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Objet à convertir en chaîne au format CliXml.

Type:PSObject
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

PSObject

Sorties

String