ConvertTo-Xml

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

Syntax

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

Description

Rutina ConvertTo-Xml vytvoří reprezentaci jednoho nebo více objektů .NET založených na JAZYCE XML . Chcete-li použít tuto rutinu, předávejte jeden nebo více objektů do rutiny nebo použijte parametr InputObject k určení objektu.

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

Tato rutina se podobá exportu clixml s tím rozdílem, že Export-Clixml uloží výsledný kód XML do souboru XML Common Language Infrastructure(CLI), který lze znovu importovat jako objekty pomocí Import-Clixml. ConvertTo-Xml vrátí reprezentaci dokumentu XML v paměti, abyste ho mohli dál zpracovávat v PowerShellu. ConvertTo-Xml nemá možnost převést objekty na XML rozhraní příkazového řádku.

Příklady

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

Get-Date | ConvertTo-Xml

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

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

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 na dokument XML. Objekty jsou rozbalené na hloubku tří úrovní.

Parametry

-As

Určuje výstupní formát. Tento parametr přijímá tyto hodnoty:

  • String Vrátí jeden řetězec.
  • Stream Vrátí pole řetězců.
  • Document Vrátí objekt XmlDocument .

Výchozí hodnota je Document.

Type:String
Accepted values:Stream, String, Document
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 obsahují také objekty, pokud chcete 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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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ý získá objekty. Objekty lze také pipetovat do ConvertTo-XML.

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

-NoTypeInformation

Vynechá atribut Type z uzlů objektů.

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

Vstupy

PSObject

Do objektu můžete roušit ConvertTo-XMLlibovolný objekt .

Výstupy

System.String or System.Xml.XmlDocument

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