Crea una rappresentazione di un oggetto basata su XML.

Sintassi

ConvertTo-XML [-InputObject] <psobject> [-As <string>] [-Depth <int>] [-NoTypeInformation] [<CommonParameters>]

Descrizione

Il cmdlet ConvertTo-Xml crea una rappresentazione basata su XML di uno o più oggetti Microsoft .NET Framework. Per utilizzare questo cmdlet, reindirizzare uno o più oggetti al cmdlet o utilizzare il parametro InputObject per specificare l'oggetto.

Quando si reindirizzano più oggetti a ConvertTo-XML o si utilizza il parametro InputObject per inviare più oggetti, ConvertTo-XML restituisce un unico documento XML che include le rappresentazioni di tutti gli oggetti.

Questo cmdlet è simile a Export-Clixml, a eccezione del fatto che Export-Clixml archivia l'XML risultante in un file. ConvertTo-XML restituisce l'XML, per consentire di continuarne l'elaborazione in Windows PowerShell.

Parametri

-As <string>

Determina il formato dell'output. I valori validi sono:

-- String: restituisce una singola stringa.

-- Stream: restituisce una matrice di stringhe.

-- Document: restituisce un oggetto XmlDocument.

Il valore predefinito è Stream.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Stream

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Depth <int>

Specifica quanti livelli di oggetti contenuti vengono inclusi nella rappresentazione XML. Il valore predefinito è 1.

Se, ad esempio, le proprietà dell'oggetto contengono anche oggetti, per salvare una rappresentazione XML delle proprietà degli oggetti contenuti, è necessario specificare un valore di profondità 2.

È possibile eseguire l'override del valore predefinito per il tipo di oggetto nei file Types.ps1xml. Per ulteriori informazioni, vedere about_Types.ps1xml.

Obbligatorio?

false

Posizione?

named

Valore predefinito

1

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-InputObject <psobject>

Specifica l'oggetto da convertire. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti. È inoltre possibile reindirizzare gli oggetti a ConvertTo-XML.

Obbligatorio?

true

Posizione?

1

Valore predefinito

nessuno

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

true

-NoTypeInformation

Omette l'attributo Type dai nodi oggetto.

Obbligatorio?

false

Posizione?

named

Valore predefinito

False

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.Management.Automation.PSObject

È possibile reindirizzare qualsiasi oggetto a ConvertTo-XML.

Output

System.String o System.Xml.XmlDocument

Il valore del parametro As determina il tipo di oggetto restituito da ConvertTo-XML.

Esempio 1

C:\PS>get-date | convertto-xml

Descrizione
-----------
Con questo comando viene convertita la data corrente (un oggetto DateTime) in XML.






Esempio 2

C:\PS>convertto-xml -as Document -inputObject (get-process) -depth 3

Descrizione
-----------
Con questo comando gli oggetti processo che rappresentano tutti i processi nel computer vengono convertiti in un documento XML. Gli oggetti vengono espansi a una profondità di tre livelli.






Vedere anche




Argomenti della Guida