ConvertTo-CliXml
Konverterar ett objekt till en CliXml-formaterad sträng.
Syntax
Default (Standard)
ConvertTo-CliXml
[-InputObject] <PSObject>
[-Depth <Int32>]
[<CommonParameters>]
Description
Cmdleten ConvertTo-CliXml konverterar objekt till strängar som är formaterade som CLI-XML (Common Language Infrastructure). Det här kommandot liknar Export-Clixml, men det skrivs inte till en fil. I stället matas en sträng ut.
Den här cmdleten introducerades i PowerShell 7.5-preview.4.
Exempel
Exempel 1 – Konvertera ett processobjekt till CliXml och tillbaka
Det här exemplet visar resultatet av att konvertera ett processobjekt till CliXml och tillbaka. Först lagras den aktuella processen i variabeln $process. Egenskapen pstypenames för processobjektet visar att objektet är av typen System.Diagnostics.Process. Nästa kommando visar antalet för varje typ av medlem i processobjektet.
$process = Get-Process -Id $PID
$process.pstypenames
System.Diagnostics.Process
System.ComponentModel.Component
System.MarshalByRefObject
System.Object
$process | Get-Member | Group-Object MemberType | Select-Object Name, Count
Name Count
---- -----
AliasProperty 7
CodeProperty 1
Property 52
NoteProperty 1
ScriptProperty 8
PropertySet 2
Method 19
Event 4
$xml = $process | ConvertTo-CliXml
$fromXML = ConvertFrom-CliXml $xml
$fromXML.pstypenames
Deserialized.System.Diagnostics.Process
Deserialized.System.ComponentModel.Component
Deserialized.System.MarshalByRefObject
Deserialized.System.Object
$fromXML | Get-Member | Group-Object MemberType | Select-Object Name, Count
Name Count
---- -----
Property 46
NoteProperty 17
PropertySet 2
Method 2
Därefter konverteras processobjektet till CliXml och tillbaka. Typen av det nya objektet är prefixet med Deserialized. Antalet medlemmar i det nya objektet skiljer sig från det ursprungliga objektet.
Parametrar
-Depth
Anger hur många nivåer av inneslutna objekt som ingår i XML-representationen. Standardvärdena är 2.
Parameteregenskaper
| Typ: | Int32 |
| Standardvärde: | 2 |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-InputObject
Objektet som ska konverteras till en CliXml-formaterad sträng.
Parameteregenskaper
| Typ: | PSObject |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
