Delen via

ConvertTo-Xml

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee maakt u een XML-weergave van een object.

Syntaxis

ConvertTo-Xml
              [-Depth <Int32>]
              [-InputObject] <PSObject>
              [-NoTypeInformation]
              [-As <String>]
              [<CommonParameters>]

Description

De cmdlet ConvertTo-Xml maakt een XML- weergave van een of meer .NET-objecten. Als u deze cmdlet wilt gebruiken, geeft u een of meer objecten door aan de cmdlet of gebruikt u de parameter InputObject om het object op te geven.

Wanneer u meerdere objecten doorsluist naar ConvertTo-Xml of de parameter InputObject gebruikt om meerdere objecten te verzenden, retourneert ConvertTo-Xml één XML-document in het geheugen dat weergaven van alle objecten bevat.

Deze cmdlet is vergelijkbaar met Export-Clixml-, behalve dat de resulterende XML opslaat in een XML--bestand Common Language Infrastructure(CLI) dat opnieuw kan worden geïmporteerd als objecten met Import-Clixml-. ConvertTo-Xml retourneert een in-memory weergave van een XML-document, zodat u het kunt blijven verwerken in PowerShell. ConvertTo-Xml heeft geen optie om objecten te converteren naar CLI XML.

Voorbeelden

Voorbeeld 1: Een datum converteren naar XML

Get-Date | ConvertTo-Xml

Met deze opdracht wordt de huidige datum (een DateTime-object) geconverteerd naar XML.

Voorbeeld 2: Processen converteren naar XML

ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

Met deze opdracht worden de procesobjecten die alle processen op de computer vertegenwoordigen, geconverteerd naar een XML-document. De objecten worden uitgebreid tot een diepte van drie niveaus.

Parameters

-As

Bepaalt de uitvoerindeling. De acceptabele waarden voor deze parameter zijn:

  • String retourneert één tekenreeks.
  • Stream retourneert een matrix met tekenreeksen.
  • Document retourneert een XmlDocument--object.

De standaardwaarde is Document.

Type:String
Geaccepteerde waarden:Stream, String, Document
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Depth

Hiermee geeft u op hoeveel niveaus van ingesloten objecten worden opgenomen in de XML-weergave. De standaardwaarde is 1.

Als de eigenschappen van het object bijvoorbeeld ook objecten bevatten, moet u een diepte van 2 opgeven om een XML-weergave van de eigenschappen van de ingesloten objecten op te slaan.

De standaardwaarde kan worden overschreven voor het objecttype in de types.ps1xml-bestanden. Zie about_Types.ps1xmlvoor meer informatie.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u het object dat moet worden geconverteerd. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald. U kunt objecten ook doorslangen naar ConvertTo-XML.

Type:PSObject
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoTypeInformation

Hiermee wordt het kenmerk Type weggelaten van de objectknooppunten.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSObject

U kunt elk object doorslangen naar ConvertTo-XML.

Uitvoerwaarden

System.String or System.Xml.XmlDocument

De waarde van de parameter As bepaalt het type object dat ConvertTo-XML retourneert.