Skip to content
PowerShell Commands

ConvertTo-Xml

ConvertTo-Xml [-InputObject*] <PSObject> [-As {Stream | String | Document}] [-Depth <Int32>] [-NoTypeInformation][<CommonParameters>]

The ConvertTo-Xml cmdlet creates an XML-based representation of one or more Microsoft .NET Framework objects. To use this cmdlet, pipe one or more objects to the cmdlet, or use the InputObject parameter to specify the object.

When you pipe multiple objects to ConvertTo-XML or use the InputObject parameter to submit multiple objects, ConvertTo-XML returns a single XML document that includes representations of all of the objects.

This cmdlet is similar to Export-Clixml except that Export-Clixml stores the resulting XML in a file**. ConvertTo-XML** returns the XML, so you can continue to process it in Windows PowerShell.

Parameters

-As <String>

  • Default value is None
  • Accepts pipeline input False

Determines the output format. The acceptable values for this parameter are:

- String. Returns a single string. - Stream. Returns an array of strings. - Document. Returns an XmlDocument object.

The default value is Document.

-Depth <Int32>

  • Default value is None
  • Accepts pipeline input False

Specifies how many levels of contained objects are included in the XML representation. The default value is 1.

For example, if the object's properties also contain objects, to save an XML representation of the properties of the contained objects, you must specify a depth of 2.

The default value can be overridden for the object type in the Types.ps1xml files.

-InputObject <PSObject>

  • This value is required
  • Default value is None
  • Accepts pipeline input ByValue

Specifies the object to be converted. Enter a variable that contains the objects, or type a command or expression that gets the objects. You can also pipe objects to ConvertTo-XML .

-NoTypeInformation [<SwitchParameter>]

  • Default value is False
  • Accepts pipeline input False

Omits the Type attribute from the object nodes.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs
System.Management.Automation.PSObject
You can pipe any object to ConvertTo-XML .
Outputs
System.String or System.Xml.XmlDocument
The value of the As parameter determines the type of object that ConvertTo-XML returns.
Examples
  1. Convert a date to XML:
    PS C:\> Get-Date | ConvertTo-Xml
    

    This command converts the current date (a DateTime object) to XML.

  2. Convert processes to XML:
    PS C:\> ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3
    

    This command converts the process objects that represent all of the processes on the computer into an XML document. The objects are expanded to a depth of three levels.

Additional Notes

This work is licensed under a Creative Commons Attribution 4.0 International. It is attributed to Microsoft Corporation and can be found here.

PowerShell Commands