ConvertTo-XML - PowerShell Befehl Hilfe und Beispiele

Erstellt eine XML-Darstellung eines Objekts. (ConvertTo-XML)

... Beispiele      
 NAME
 
    ConvertTo-XML 

 ÜBERSICHT
 
    Erstellt eine XML-Darstellung eines Objekts. 

 SYNTAX
 
    ConvertTo-XML [-InputObject] <psobject> [-As <string>] [-Depth <int>] [-NoTypeInformation] [<CommonParameters>] 

 BESCHREIBUNG
 
    Mit dem Cmdlet "ConvertTo-Xml" wird eine XML-Darstellung eines oder mehrerer Microsoft .NET Framework-Objekte erstellt. Um dieses Cmdlet zu verwenden, übergeben Sie mindestens ein Objekt über die Pipeline an das Cmdlet oder geben das Objekt mithilfe des InputObject-Parameters an. 

    Wenn Sie mehrere Objekte über die Pipeline an ConvertTo-XML übergeben oder den InputObject-Parameter verwenden, um mehrere Objekte zu senden, gibt ConvertTo-XML ein einzelnes XML-Dokument zurück, das Darstellungen aller Objekte enthält. 

    Dieses Cmdlet ähnelt Export-Clixml, mit der Ausnahme, dass mit Export-Clixml der resultierende XML-Inhalt in einer Datei gespeichert wird. ConvertTo-XML gibt den XML-Inhalt zurück, sodass Sie diesen anschließend in Windows PowerShell verarbeiten können. 

 PARAMETER
 
    -As <string> 
        Bestimmt das Ausgabeformat. Gültige Werte: 

        - String: Gibt eine einzelne Zeichenfolge zurück. 
        - Stream: Gibt ein Zeichenfolgenarray zurück. 
        - Document: Gibt ein XmlDocument-Objekt zurück. 

        Der Standardwert ist "Stream". 

        Erforderlich?                false 
        Position?                    named 
        Standardwert                 Stream 
        Pipelineeingaben akzeptieren?false 
        Platzhalterzeichen akzeptieren?false 

    -Depth <int> 
        Gibt an, wie viele Ebenen enthaltener Objekte in die XML-Darstellung eingeschlossen werden. Der Standardwert ist 1. 

        Wenn beispielsweise die Eigenschaften des Objekts ebenfalls Objekte enthalten und Sie eine XML-Darstellung der Eigenschaften dieser Objekte speichern möchten, müssen Sie die Tiefe 2 angeben. 

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

        Erforderlich?                false 
        Position?                    named 
        Standardwert                 1 
        Pipelineeingaben akzeptieren?false 
        Platzhalterzeichen akzeptieren?false 

    -InputObject <psobject> 
        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 über die Pipeline an ConvertTo-XML übergeben. 

        Erforderlich?                true 
        Position?                    1 
        Standardwert                 Keiner 
        Pipelineeingaben akzeptieren?true (ByValue) 
        Platzhalterzeichen akzeptieren?true 

    -NoTypeInformation [<SwitchParameter>] 
        Lässt das Type-Attribut in den Objektknoten weg. 

        Erforderlich?                false 
        Position?                    named 
        Standardwert                 False 
        Pipelineeingaben akzeptieren?false 
        Platzhalterzeichen akzeptieren?false 

    <CommonParameters> 
        Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug", 
        "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", 
        "OutBuffer" und "OutVariable". Weitere Informationen 
        erhalten Sie mit dem Befehl "get-help about_commonparameters". 

 EINGABEN
 
    System.Management.Automation.PSObject 
        Sie können jedes Objekt über die Pipeline an ConvertTo-XML übergeben. 

 AUSGABEN
 
    System.String oder System.Xml.XmlDocument 
        Der Wert des As-Parameters bestimmt, welcher Objekttyp von ConvertTo-XML zurückgegeben wird. 

 HINWEISE
 

 Beispiele
    
BEISPIEL 1
 

    C:\PS>get-date | convertto-xml 

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

    
BEISPIEL 2
 

    C:\PS>convertto-xml -as Document -inputObject (get-process) -depth 3 

    Beschreibung 
    ----------- 
    Mit diesem Befehl werden die Prozessobjekte, die sämtliche Prozesse auf dem Computer darstellen, in ein XML-Dokument konvertiert. Die Objekte werden auf eine Tiefe von drei Ebenen erweitert. 

VERWANDTE LINKS 
    Online version: http://go.microsoft.com/fwlink/?LinkID=135204 (möglicherweise auf Englisch) 
    Export-Clixml 
    Import-Clixml 
    ConvertTo-Html 
    ConvertTo-Csv 

C:\Windows>powershell get-help Select-XML -full 

Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.

ColorConsole [Version 3.7.1000] PowerShell 2.0-Export

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016