Dela via

ConvertTo-Xml

  • Referens
Modul:
Microsoft.PowerShell.Utility

Skapar en XML-baserad representation av ett objekt.

Syntax

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

Description

Cmdleten ConvertTo-Xml skapar en XML-baserad representation av ett eller flera Microsoft .NET Framework-objekt. Om du vill använda den här cmdleten kan du skicka ett eller flera objekt till cmdleten eller använda parametern InputObject för att ange objektet.

När du skickar flera objekt för att ConvertTo-Xml eller använder parametern InputObject för att skicka flera objekt, returnerar ConvertTo-Xml ett enda XML-dokument som innehåller representationer av alla objekt.

Den här cmdleten liknar Export-Clixml förutom att Export-Clixml lagrar resulterande XML i en fil. ConvertTo-Xml returnerar XML-koden så att du kan fortsätta att bearbeta den i PowerShell.

Exempel

Exempel 1: Konvertera ett datum till XML

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

Det här kommandot konverterar det aktuella datumet (ett DateTime--objekt) till XML.

Exempel 2: Konvertera processer till XML

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

Det här kommandot konverterar processobjekten som representerar alla processer på datorn till ett XML-dokument. Objekten expanderas till ett djup av tre nivåer.

Parametrar

-As

Avgör utdataformatet. De godtagbara värdena för den här parametern är:

  • Sträng. Returnerar en enskild sträng.
  • Ström. Returnerar en matris med strängar.
  • Dokument. Returnerar ett XmlDocument--objekt.

Standardvärdet är Dokument.

Typ:String
Godkända värden:Stream, String, Document
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Depth

Anger hur många nivåer av inneslutna objekt som ingår i XML-representationen. Standardvärdet är 1.

Om objektets egenskaper till exempel också innehåller objekt måste du ange ett djup på 2 för att spara en XML-representation av egenskaperna för de inneslutna objekten.

Standardvärdet kan åsidosättas för objekttypen i filerna Types.ps1xml. Mer information finns i about_Types.ps1xml.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger det objekt som ska konverteras. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten. Du kan också skicka objekt till ConvertTo-XML-.

Typ:PSObject
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoTypeInformation

Utelämnar typattributet från objektnoderna.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSObject

Du kan skicka valfritt objekt till ConvertTo-XML-.

Utdata

System.String or System.Xml.XmlDocument

Värdet för parametern Som avgör vilken typ av objekt som ConvertTo-XML- returnerar.