Freigeben über

ConvertTo-Xml

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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 mehrere Objekte ü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 das resultierende XML in einer CLI-Datei (Common Language Infrastructure) gespeichert wird, die mit Import-Clixml als Objekte erneut importiert werden kann. ConvertTo-Xml gibt eine In-Memory-Darstellung eines XML-Dokuments zurück, sodass Sie es in PowerShell weiterverarbeiten 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

Dieser Befehl konvertiert das aktuelle Datum (ein DateTime-Objekt ) in XML.

Beispiel 2: Konvertieren von Prozessen in XML

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

Dieser Befehl konvertiert die Prozessobjekte, die alle Prozesse auf dem Computer darstellen, in ein XML-Dokument. 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 auch Objekte an übergeben 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

PSObject

Sie können jedes Objekt an dieses Cmdlet übergeben.

Ausgaben

String

Wenn Sie den As-Parameter verwenden und den Wert auf stringfestlegen, gibt dieses Cmdlet den XML-Code als Zeichenfolge zurück. Wenn der Wert ist stream, gibt dieses Cmdlet ein Array von Zeichenfolgen zurück.

XmlDocument

Standardmäßig gibt dieses Cmdlet ein XML-Dokument zurück.