ConvertTo-XML
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.