ConvertTo-Xml
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.
Denna cmdlet 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 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 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 djupet 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 type-attributet från objektnoderna.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka valfritt objekt till denna cmdlet
Utdata
När du använder parametern Som och anger värdet till string
returnerar denna cmdlet XML som en sträng. När värdet är stream
returnerar den här cmdleten en matris med strängar.
Som standard returnerar denna cmdlet ett XML-dokument.