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 ü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

PSObject

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 .