Sdílet prostřednictvím

ConvertTo-Xml

  • Reference
Modul:
Microsoft.PowerShell.Utility

Vytvoří reprezentaci objektu založenou na jazyce XML.

Syntaxe

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

Description

Rutina ConvertTo-Xml vytvoří reprezentaci založené na jazyce XML jednoho nebo více objektů rozhraní Microsoft .NET Framework. Chcete-li použít tuto rutinu, předaný jeden nebo více objektů do rutiny nebo použijte InputObject parametr k určení objektu.

Když předáte více objektů do ConvertTo-Xml nebo použijete parametr InputObject k odeslání více objektů, ConvertTo-Xml vrátí jeden dokument XML, který obsahuje reprezentaci všech objektů.

Tato rutina se podobá Export-Clixml s tím rozdílem, že Export-Clixml uloží výsledný kód XML do souboru. ConvertTo-Xml vrátí xml, takže ho můžete dál zpracovávat v PowerShellu.

Příklady

Příklad 1: Převod data na XML

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

Tento příkaz převede aktuální datum (objekt DateTime) na XML.

Příklad 2: Převod procesů na XML

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

Tento příkaz převede procesní objekty, které představují všechny procesy v počítači do dokumentu XML. Objekty jsou rozbalené na hloubku tří úrovní.

Parametry

-As

Určuje výstupní formát. Přijatelné hodnoty pro tento parametr jsou:

  • Řetězec. Vrátí jeden řetězec.
  • Proud. Vrátí pole řetězců.
  • Dokument. Vrátí objekt XmlDocument.

Výchozí hodnota je Document.

Typ:String
Přípustné hodnoty:Stream, String, Document
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Depth

Určuje, kolik úrovní obsažených objektů je součástí reprezentace XML. Výchozí hodnota je 1.

Pokud například vlastnosti objektu také obsahují objekty, chcete-li uložit reprezentaci XML vlastností obsažených objektů, je nutné zadat hloubku 2.

Výchozí hodnotu lze přepsat pro typ objektu v souborech Types.ps1xml. Další informace najdete v tématu about_Types.ps1xml.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje objekt, který se má převést. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá. Objekty lze také pipetovat do ConvertTo-XML.

Typ:PSObject
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoTypeInformation

Vynechá atribut Type z uzlů objektů.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Libovolný objekt můžete převést na ConvertTo-XML.

Výstupy

System.String or System.Xml.XmlDocument

Hodnota parametru As určuje typ objektu, který ConvertTo-XML vrátí.