ConvertTo-Xml
Crea una rappresentazione basata su XML di un oggetto.
Sintassi
ConvertTo-Xml
[-InputObject] <PSObject>
[-Depth <Int32>]
[-NoTypeInformation]
[-As <String>]
[<CommonParameters>]
Descrizione
Il ConvertTo-Xml
cmdlet crea una rappresentazione basata su XML di uno o più oggetti di Microsoft .NET Framework.
Per usare questo cmdlet, inviare tramite pipe uno o più oggetti al cmdlet oppure usare il parametro InputObject per specificare l'oggetto.
Quando si inviano tramite pipe più oggetti o ConvertTo-Xml
si utilizza il parametro InputObject per inviare più oggetti, ConvertTo-Xml
restituisce un singolo documento XML che include rappresentazioni di tutti gli oggetti.
Questo cmdlet è simile a Export-Clixml
, ad eccezione del fatto che Export-Clixml
archivia il codice XML risultante in un file.
ConvertTo-Xml
restituisce il codice XML, in modo da poter continuare a elaborarlo in PowerShell.
Esempio
Esempio 1: Convertire una data in XML
PS C:\> Get-Date | ConvertTo-Xml
Questo comando converte la data corrente (un oggetto DateTime ) in XML.
Esempio 2: Convertire i processi in XML
PS C:\> ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3
Questo comando converte gli oggetti processo che rappresentano tutti i processi del computer in un documento XML. Gli oggetti vengono espansi fino a una profondità di tre livelli.
Parametri
-As
Determina il formato di output. I valori validi per questo parametro sono:
- Stringa. restituisce una singola stringa.
- Flusso. restituisce una matrice di stringhe.
- Documento. Restituisce un oggetto XmlDocument .
Il valore predefinito è Document.
Type: | String |
Accepted values: | Stream, String, Document |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Depth
Specifica il numero di livelli di oggetti contenuti inclusi nella rappresentazione XML. Il valore predefinito è 1.
Ad esempio, se le proprietà dell'oggetto contengono anche oggetti, per salvare una rappresentazione XML delle proprietà degli oggetti contenuti, è necessario specificare una profondità pari a 2.
È possibile eseguire l'override del valore predefinito per il tipo di oggetto nei file Types.ps1xml. Per altre informazioni, vedere about_Types.ps1xml.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica l'oggetto da convertire. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti. È anche possibile inviare tramite pipe oggetti a ConvertTo-XML.
Type: | PSObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoTypeInformation
Omette l'attributo Type dai nodi degli oggetti.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare tramite pipe qualsiasi oggetto a ConvertTo-XML.
Output
System.String or System.Xml.XmlDocument
Il valore del parametro As determina il tipo di oggetto restituito da ConvertTo-XML .