ConvertTo-Xml

Létrehoz egy objektum XML-alapú reprezentációját.

Syntax

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

Description

A ConvertTo-Xml parancsmag egy vagy több . NET-objektum XML-alapú reprezentációját hozza létre. A parancsmag használatához egy vagy több objektumot a parancsmagba kell átirányítani, vagy az InputObject paraméter használatával megadhatja az objektumot.

Ha több objektumot küld el az InputObject paraméterrelConvertTo-Xml, vagy több objektumot küld el, ConvertTo-Xml egyetlen, memórián belüli XML-dokumentumot ad vissza, amely az összes objektum ábrázolását tartalmazza.

Ez a parancsmag hasonló az Export-Clixml parancsmaghoz, azzal a kivétellel, hogy Export-Clixml az eredményként kapott XML-fájlt egy Common Language Infrastructure(CLI) XML-fájlban tárolja, amely objektumként importálható újra az Import-Clixml használatával. ConvertTo-Xml A egy XML-dokumentum memórián belüli reprezentációját adja vissza, így tovább feldolgozhatja azt a PowerShellben. ConvertTo-Xml A nem rendelkezik lehetőséggel az objektumok parancssori felületi XML-fájllá konvertálására.

Példák

1. példa: Dátum konvertálása XML formátumba

Get-Date | ConvertTo-Xml

Ez a parancs XML-fájllá alakítja az aktuális dátumot ( dateTime objektumot).

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

ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

Ez a parancs XML-dokumentummá alakítja a számítógépen lévő összes folyamatot képviselő folyamatobjektumokat. Az objektumok három szint mélységig vannak kibontva.

Paraméterek

-As

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

  • String Egyetlen sztringet ad vissza.
  • Stream Sztringtömböt ad vissza.
  • DocumentXmlDocument objektumot ad vissza.

Az alapértelmezett érték Document.

Type:String
Accepted values:Stream, String, Document
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Depth

Meghatározza, hogy hány szint tartalmazott objektumot tartalmaz az XML-reprezentációban. Az alapértelmezett érték az 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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

A konvertálandó objektumot határozza 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 át is adhatja a parancsnak ConvertTo-XML.

Type:PSObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-NoTypeInformation

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

PSObject

Bármilyen objektumot átirányíthat .ConvertTo-XML

Kimenetek

System.String or System.Xml.XmlDocument

Az As paraméter értéke határozza meg a visszaadott objektum ConvertTo-XML típusát.