ConvertTo-Xml
Erstellt eine XML-basierte Darstellung eines Objekts.
Syntax
ConvertTo-Xml
[-Depth <Int32>]
[-InputObject] <PSObject>
[-NoTypeInformation]
[-As <String>]
[<CommonParameters>]
Beschreibung
Das ConvertTo-Xml
Cmdlet erstellt eine XML-basierte Darstellung eines oder mehrerer .NET-Objekte. Um dieses Cmdlet zu verwenden, leiten Sie ein oder mehrere Objekte an das Cmdlet weiter, oder verwenden Sie den InputObject-Parameter , um das Objekt anzugeben.
Wenn Sie mehrere Objekte an ConvertTo-Xml
übergeben oder den InputObject-Parameter verwenden, um mehrere Objekte zu übermitteln, ConvertTo-Xml
gibt ein einzelnes XML-Dokument im Arbeitsspeicher zurück, das Darstellungen aller Objekte enthält.
Dieses Cmdlet ähnelt Export-Clixml , mit der Ausnahme, dass Export-Clixml
die resultierende XML-Datei in einer XML-Datei der Common Language Infrastructure (CLI) gespeichert wird, die mit Import-Clixml als Objekte erneut importiert werden kann. ConvertTo-Xml
gibt eine Im-Memory-Darstellung eines XML-Dokuments zurück, sodass Sie es weiterhin in PowerShell verarbeiten können. ConvertTo-Xml
verfügt nicht über eine Option zum Konvertieren von Objekten in CLI-XML.
Beispiele
Beispiel 1: Konvertieren eines Datums in XML
Get-Date | ConvertTo-Xml
Mit diesem Befehl wird das aktuelle Datum (ein DateTime-Objekt ) in XML konvertiert.
Beispiel 2: Konvertieren von Prozessen in XML
ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3
Mit diesem Befehl werden die Prozessobjekte, die alle Prozesse auf dem Computer darstellen, in ein XML-Dokument konvertiert. Die Objekte werden auf eine Tiefe von drei Ebenen erweitert.
Parameter
-As
Bestimmt das Ausgabeformat. Zulässige Werte für diesen Parameter:
String
Gibt eine einzelne Zeichenfolge zurück.Stream
Gibt ein Array von Zeichenfolgen zurück.Document
Gibt ein XmlDocument-Objekt zurück.
Standardwert: Document
.
Type: | String |
Accepted values: | Stream, String, Document |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Depth
Gibt an, wie viele Ebenen der enthaltenen Objekte in der XML-Darstellung enthalten sind. Der Standardwert ist 1.
Wenn beispielsweise die Eigenschaften des Objekts ebenfalls Objekte enthalten, müssen Sie eine Tiefe von 2 angeben, um eine XML-Darstellung der Eigenschaften der enthaltenen Objekte zu speichern.
Der Standardwert kann für den Objekttyp in den Dateien „Types.ps1xml“ überschrieben werden. Weitere Informationen finden Sie unter about_Types.ps1xml.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Gibt das zu konvertierende Objekt an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden. Sie können objekte auch an pipen ConvertTo-XML
.
Type: | PSObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoTypeInformation
Lässt das Type-Attribute in den Objektknoten aus.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können jedes Objekt an übergeben ConvertTo-XML
.
Ausgaben
System.String or System.Xml.XmlDocument
Der Wert des As-Parameters bestimmt den Typ des zurückgegebenen Objekts ConvertTo-XML
.