Condividi tramite

ConvertFrom-CliXml

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Converte una stringa in formato CliXml in un PSObject personalizzato.

Sintassi

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

Descrizione

Il ConvertFrom-CliXml cmdlet converte le stringhe formattate come XML dell'interfaccia della riga di comando (Common Language Infrastructure) in un PSObject personalizzato. Questo comando è simile a Import-Clixml, ma non legge da un file. Al contrario, accetta una stringa come input.

Gli oggetti appena deserializzati non sono oggetti attivi. Sono uno snapshot degli oggetti al momento della serializzazione. Gli oggetti deserializzati includono proprietà, ma nessun metodo. La proprietà PSTypeNames contiene il nome del tipo originale preceduto da Deserialized.

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

-InputObject

Oggetto contenente una stringa in formato CliXml da convertire.

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

Input

String

Output

Object