Megosztás a következőn keresztül:

ConvertTo-Xml

Modul:
Microsoft.PowerShell.Utility Module

Egy objektum XML-alapú ábrázolását hozza létre.

Syntax

Default (Alapértelmezett) 

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

Description

A ConvertTo-Xml parancsmag egy vagy több Microsoft .NET-keretrendszer-objektum XML-alapú ábrázolását hozza létre. A parancsmag használatához pipáljon egy vagy több objektumot a parancsmagba, vagy használja az InputObject paramétert az objektum megadásához.

Ha több objektumot ConvertTo-Xml vagy a InputObject paraméterrel több objektum elküldéséhez használ, ConvertTo-Xml egyetlen XML-dokumentumot ad vissza, amely az összes objektum ábrázolását tartalmazza.

Ez a parancsmag hasonló a Export-Clixml, kivéve, hogy Export-Clixml az eredményként kapott XML-fájlt egy fájlban tárolja. ConvertTo-Xml visszaadja az XML-t, így továbbra is feldolgozhatja azt a PowerShellben.

Példák

1. példa: Dátum konvertálása XML-fájllá

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

Ez a parancs xml formátumba konvertálja az aktuális dátumot (DateTime objektumot).

2. példa: Folyamatok konvertálása XML-fájllá

PS C:\> ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

Ez a parancs xml-dokumentummá alakítja a számítógépen található összes folyamatot képviselő folyamatobjektumokat. Az objektumok háromszintű mélységig vannak kibővítve.

Paraméterek

-As

Meghatározza a kimeneti formátumot. A paraméter elfogadható értékei a következők:

  • Szöveg. Egyetlen sztringet ad vissza.
  • Patak. Sztringtömböt ad vissza.
  • Dokumentum. Egy XmlDocument objektumot ad vissza.

Az alapértelmezett érték a Dokumentum.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:Stream, String, Document
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Depth

Meghatározza, hogy hány szint tartalmaz objektumokat az XML-reprezentációban. Az alapértelmezett érték 1.

Ha például az objektum tulajdonságai is tartalmaznak objektumokat, a tartalmazott objektumok tulajdonságainak XML-reprezentációjának mentéséhez 2 mélységet kell megadnia.

Az alapértelmezett érték felülírható a Types.ps1xml fájlok objektumtípusához. További információ: about_Types.ps1xml.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-InputObject

A konvertálni kívánt objektumot adja meg. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat. Az objektumokat a ConvertTo-XMLis csövezheti.

Paramétertulajdonságok

Típus:PSObject
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-NoTypeInformation

Kihagyja a Type attribútumot az objektumcsomópontokból.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSObject

Bármilyen objektumot átvehet a ConvertTo-XML.

Kimenetek

System.String or System.Xml.XmlDocument

A As paraméter értéke határozza meg, hogy milyen típusú objektumot ConvertTo-XML visszaadni.