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 returnerar ett enda XML-dokument i minnet som innehåller representationer av alla objekt.

Den här cmdleten liknar Export-Clixml förutom att Export-Clixml lagrar resulterande XML i en CLI-fil (Common Language Infrastructure) 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 inget 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 expanderas 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 typattributet 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 den här cmdleten

Utdata

String

När du använder parametern Som och anger värdet till stringreturnerar den här cmdleten XML som en sträng. När värdet är streamreturnerar den här cmdleten en matris med strängar.

XmlDocument

Som standard returnerar den här cmdleten ett XML-dokument.