Dela via

ConvertTo-Xml

  • Referens
Modul:
Microsoft.PowerShell.Utility

Skapar en XML-baserad representation av ett objekt.

Syntax

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

Description

Cmdleten ConvertTo-Xml skapar en XML-baserad representation av ett eller flera .NET-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 till ConvertTo-Xml eller använder parametern InputObject för att skicka flera objekt ConvertTo-Xml returneras ett enda, minnesinternt 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 XML-fil (Common Language Infrastructure(CLI) som kan importeras igen som objekt med Import-Clixml. ConvertTo-Xml returnerar en minnesintern representation av ett XML-dokument så att du kan fortsätta att bearbeta det i PowerShell. ConvertTo-Xml har inte något alternativ för att konvertera objekt till CLI XML.

Exempel

Exempel 1: Konvertera ett datum till XML

Get-Date | ConvertTo-Xml

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

Exempel 2: Konvertera processer till XML

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 utökas till ett djup av tre nivåer.

Parametrar

-As

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

  • String Returnerar en enskild sträng.
  • Stream Returnerar en matris med strängar.
  • Document Returnerar ett XmlDocument-objekt .

Standardvärdet är Document.

Type:String
Accepted values:Stream, String, Document
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-NoTypeInformation

Utelämnar attributet Typ från objektnoderna.

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

Indata

PSObject

Du kan skicka valfritt objekt till ConvertTo-XML.

Utdata

System.String or System.Xml.XmlDocument

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