ConvertTo-Xml

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee maakt u een XML-weergave van een object.

Syntax

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

Description

De ConvertTo-Xml cmdlet 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, ConvertTo-Xml retourneert u één XML-document in het geheugen dat weergaven van alle objecten bevat.

Deze cmdlet is vergelijkbaar met Export-Clixml , behalve dat Export-Clixml de resulterende XML wordt opgeslagen in een CLI-bestand (Common Language Infrastructure) 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 aanvaardbare 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
Accepted values:Stream, String, Document
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.ps1xml voor meer informatie.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoTypeInformation

Hiermee wordt het kenmerk Type weggelaten van de objectknooppunten.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSObject

U kunt elk object doorsluisen naar deze cmdlet

Uitvoerwaarden

String

Wanneer u de parameter As gebruikt en de waarde stringinstelt op, retourneert deze cmdlet de XML als een tekenreeks. Wanneer de waarde is stream, retourneert deze cmdlet een matrix met tekenreeksen.

XmlDocument

Deze cmdlet retourneert standaard een XML-document.