Condividi tramite

ConvertTo-CliXml

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Converte un oggetto in una stringa in formato CliXml.

Sintassi

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

Descrizione

Il ConvertTo-CliXml cmdlet converte gli oggetti in stringhe formattate come XML dell'interfaccia della riga di comando (Common Language Infrastructure). Questo comando è simile a Export-Clixml, ma non scrive in un file. Restituisce invece una stringa.

Questo cmdlet è stato introdotto in PowerShell 7.5-preview.4.

Esempio

Esempio 1- Convertire un oggetto processo in CliXml e vice-end

In questo esempio viene illustrato il risultato della conversione di un oggetto processo in CliXml e indietro. In primo luogo, il processo corrente viene archiviato nella variabile $process. La proprietà PSTypeNames dell'oggetto process indica che l'oggetto è di tipo System.Diagnostics.Process. Il comando successivo visualizza il conteggio per ogni tipo di membro nell'oggetto processo.

$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

Successivamente, l'oggetto processo viene convertito in CliXml e indietro. Il tipo del nuovo oggetto è preceduto da Deserialized. Il conteggio dei membri nel nuovo oggetto è diverso dall'oggetto originale.

Parametri

-Depth

Specifica il numero di livelli di oggetti contenuti inclusi nella rappresentazione XML. I valori predefiniti sono 2.

Tipo:Int32
Posizione:Named
Valore predefinito:2
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Oggetto da convertire in una stringa in formato CliXml.

Tipo:PSObject
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

PSObject

Output

String