Freigeben über

ConvertTo-Xml

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Erstellt eine XML-basierte Darstellung eines Objekts.

Syntax

ConvertTo-Xml
              [-InputObject] <PSObject>
              [-Depth <Int32>]
              [-NoTypeInformation]
              [-As <String>]
              [<CommonParameters>]

Beschreibung

Das ConvertTo-Xml Cmdlet erstellt eine XML-basierte Darstellung eines oder mehrerer Microsoft .NET Framework-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 zum Übermitteln mehrerer Objekte verwenden, gibt ein einzelnes XML-Dokument zurück, ConvertTo-Xml das Darstellungen aller Objekte enthält.

Dieses Cmdlet ähnelt dem Export-Clixml , außer dass Export-Clixml die resultierende XML-Datei in einer Datei speichert. ConvertTo-Xml gibt den XML-Code zurück, sodass Sie es in PowerShell weiter verarbeiten können.

Beispiele

Beispiel 1: Konvertieren eines Datums in XML

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

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

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. Zulässige Werte für diesen Parameter:

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

Der Standardwert ist 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 die Eigenschaften des Objekts instance 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 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 ConvertTo-XML übergeben.

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 ConvertTo-XML übergeben.

Ausgaben

System.String or System.Xml.XmlDocument

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