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 XML-fil för 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
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 acceptabla värdena för den här parametern är:
- Sträng. Returnerar en enskild sträng.
- Stream. Returnerar en matris med strängar.
- Dokument. Returnerar ett XmlDocument-objekt .
Standardvärdet är Dokument.
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 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.