Delen via

ConvertTo-Xml

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee maakt u een XML-weergave van een object.

Syntaxis

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

Description

De cmdlet ConvertTo-Xml maakt een XML-weergave van een of meer Microsoft .NET Framework-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 met weergaven van alle objecten.

Deze cmdlet is vergelijkbaar met Export-Clixml, behalve dat Export-Clixml de resulterende XML in een bestand opslaat. ConvertTo-Xml retourneert de XML, zodat u deze kunt blijven verwerken in PowerShell.

Voorbeelden

Voorbeeld 1: Een datum converteren naar XML

PS C:\> Get-Date | ConvertTo-Xml

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

Voorbeeld 2: Processen converteren naar XML

PS C:\> 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:

  • Snaar. Retourneert één tekenreeks.
  • Stroom. Hiermee wordt een matrix met tekenreeksen geretourneerd.
  • Document. Hiermee wordt een XmlDocument--object geretourneerd.

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 om een XML-weergave van de eigenschappen van de ingesloten objecten op te slaan, moet u een diepte van 2 opgeven.

De standaardwaarde kan worden overschreven voor het objecttype in de types.ps1xml-bestanden. Zie about_Types.ps1xml voor 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 doorsluisen 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 doorsluisen naar ConvertTo-XML-.

Uitvoerwaarden

System.String or System.Xml.XmlDocument

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