Condividi tramite


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

PSObject

È 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 .