ConvertTo-CliXml

Referensi

Modul:: Microsoft.PowerShell.Utility

Mengonversi objek menjadi string berformat CliXml.

Sintaks

ConvertTo-CliXml
              [-InputObject] <PSObject>
              [-Depth <Int32>]
              [<CommonParameters>]

Deskripsi

ConvertTo-CliXml Cmdlet mengonversi objek menjadi string yang diformat sebagai XML Common Language Infrastructure (CLI). Perintah ini mirip Export-Clixmldengan , 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.

Jenis:	Int32
Position:	Named
Nilai default:	2
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InputObject

Objek yang akan dikonversi ke string berformat CliXml.

Jenis:	PSObject
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

Input

PSObject

Output

String

Bagikan melalui