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 cmdlet ConvertTo-Xml erstellt eine XML-basierten Darstellung eines oder mehrerer .NET-Objekte. Um dieses Cmdlet zu verwenden, übergeben Sie ein oder mehrere Objekte an das Cmdlet, oder verwenden Sie den parameter InputObject, um das Objekt anzugeben.

Wenn Sie mehrere Objekte an ConvertTo-Xml übergeben oder den parameter InputObject zum Senden mehrerer Objekte verwenden, gibt ConvertTo-Xml 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 in einer Common Language Infrastructure(CLI)-XML--Datei speichert, die als Objekte mit Import-Clixml-neu importiert werden kann. ConvertTo-Xml gibt eine Speicherdarstellung eines XML-Dokuments zurück, sodass Sie es weiterhin in PowerShell verarbeiten können. ConvertTo-Xml hat keine Möglichkeit, Objekte in CLI-XML zu konvertieren.

Beispiele

Beispiel 1: Konvertieren eines Datums in XML

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

Mit diesem Befehl wird das aktuelle Datum (ein DateTime--Objekt) in XML konvertiert.

Beispiel 2: Konvertieren von Prozessen in XML

PS C:\> 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. Die zulässigen Werte für diesen Parameter sind:

  • Schnur. Gibt eine einzelne Zeichenfolge zurück.
  • Bach. Gibt ein Array von Zeichenfolgen zurück.
  • Dokument. Gibt ein XmlDocument- -Objekt zurück.

Der Standardwert ist Document.

Typ:String
Zulässige Werte:Stream, String, Document
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Depth

Gibt an, wie viele Ebenen von enthaltenen Objekten in der XML-Darstellung enthalten sind. Der Standardwert ist 1.

Wenn die Eigenschaften des Objekts beispielsweise auch Objekte enthalten, müssen Sie zum Speichern einer XML-Darstellung der Eigenschaften der enthaltenen Objekte eine Tiefe von 2 angeben.

Der Standardwert kann für den Objekttyp in den Types.ps1xml-Dateien überschrieben werden. Weitere Informationen finden Sie unter about_Types.ps1xml.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt das zu konvertierende Objekt an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte abruft. Sie können Objekte auch an ConvertTo-XML-weitergeleitet werden.

Typ:PSObject
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NoTypeInformation

Lässt das Type-Attribut von den Objektknoten aus.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSObject

Sie können jedes Objekt an ConvertTo-XML-weitergeleitet werden.

Ausgaben

System.String or System.Xml.XmlDocument

Der Wert des As-Parameters bestimmt den Typ des Objekts, das ConvertTo-XML- zurückgibt.