ConvertTo-CliXml
Mengonversi objek menjadi string berformat CliXml.
Sintaks
Default (Default)
ConvertTo-CliXml
[-InputObject] <PSObject>
[-Depth <Int32>]
[<CommonParameters>]
Deskripsi
Cmdlet ConvertTo-CliXml mengonversi objek menjadi string yang diformat sebagai XML Common Language Infrastructure (CLI). Perintah ini mirip dengan Export-Clixml, tetapi tidak menulis ke file. Sebaliknya, ia mengeluarkan string.
Cmdlet ini diperkenalkan di PowerShell 7.5-preview.4.
Contoh
Contoh 1 - Mengonversi objek proses ke CliXml dan kembali
Contoh ini menunjukkan hasil konversi objek proses ke CliXml dan kembali. Pertama, proses saat ini disimpan dalam variabel $process. Properti pstypenames dari objek proses menunjukkan bahwa objek berjenis System.Diagnostics.Process. Perintah berikutnya menampilkan hitungan untuk setiap jenis anggota dalam objek proses.
$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
Selanjutnya, objek proses dikonversi ke CliXml dan kembali. Jenis objek baru diawali dengan Deserialized. Jumlah anggota dalam objek baru berbeda dari objek aslinya.
Parameter
-Depth
Menentukan berapa banyak tingkat objek yang terkandung yang disertakan dalam representasi XML. Nilai defaultnya adalah 2.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | 2 |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-InputObject
Objek yang akan dikonversi ke string berformat CliXml.
Properti parameter
| Jenis: | PSObject |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
