ConvertTo-Xml
Hiermee maakt u een op XML gebaseerde weergave van een object.
Syntax
ConvertTo-Xml
[-Depth <Int32>]
[-InputObject] <PSObject>
[-NoTypeInformation]
[-As <String>]
[<CommonParameters>]
Description
De ConvertTo-Xml
cmdlet maakt een op XML gebaseerde weergave van een of meer .NET-objecten. Als u deze cmdlet wilt gebruiken, sluist u een of meer objecten door naar 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 in te dienen, ConvertTo-Xml
wordt één XML-document in het geheugen geretourneerd 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 weergave in het geheugen van een XML-document, zodat u het kunt blijven verwerken in PowerShell. ConvertTo-Xml
heeft geen optie voor het converteren van objecten 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 te converteren. 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
Laat het kenmerk Type weg van de objectknooppunten.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt elk object doorsnijden naar deze cmdlet
Uitvoerwaarden
Wanneer u de parameter As gebruikt en de waarde instelt op string
, retourneert deze cmdlet de XML als een tekenreeks. Wanneer de waarde is stream
, retourneert deze cmdlet een matrix met tekenreeksen.
Deze cmdlet retourneert standaard een XML-document.