ConvertTo-Xml (Microsoft.PowerShell.Utility)

ConvertTo-Xml

โมดูล :

Microsoft.PowerShell.Utility

สร้างการแสดงวัตถุตาม XML

ไวยากรณ์

ConvertTo-Xml
              [-Depth <Int32>]
              [-InputObject] <PSObject>
              [-NoTypeInformation]
              [-As <String>]
              [<CommonParameters>]

คำอธิบาย

ConvertTo-Xml cmdlet สร้างการแสดงตาม XML ของวัตถุ .NET ตั้งแต่หนึ่งรายการขึ้นไป หากต้องการใช้ cmdlet นี้ ให้ไปป์วัตถุหนึ่งรายการขึ้นไปไปที่ cmdlet หรือใช้พารามิเตอร์ InputObject เพื่อระบุวัตถุ

เมื่อคุณไปป์วัตถุหลายรายการไปที่ ConvertTo-Xml หรือใช้พารามิเตอร์ InputObject เพื่อส่งวัตถุหลายรายการ ConvertTo-Xml จะส่งกลับค่าเดียวในหน่วยความจำ เอกสาร XML ที่มีการแทนค่าของวัตถุทั้งหมด

cmdlet นี้คล้ายกับ Export-Clixml ยกเว้นว่า Export-Clixml เก็บ XML ผลลัพธ์ไว้ในไฟล์ Common Language Infrastructure (CLI) ที่สามารถนำเข้าใหม่เป็นออบเจ็กต์ด้วย Import-Clixml ConvertTo-Xml ส่งคืนการแสดงเอกสาร XML ในหน่วยความจำ เพื่อให้คุณสามารถประมวลผลเอกสาร XML ต่อไปได้ ConvertTo-Xml ไม่มีตัวเลือกในการแปลงออบเจ็กต์เป็น CLI XML

ตัวอย่าง

ตัวอย่างที่ 1: แปลงวันที่เป็น XML

Get-Date | ConvertTo-Xml

คำสั่งนี้แปลงวันที่ปัจจุบัน (ออบเจ็กต์ DateTime) เป็น XML

ตัวอย่างที่ 2: แปลงกระบวนการเป็น XML

ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

คำสั่งนี้จะแปลงวัตถุกระบวนการที่แสดงถึงกระบวนการทั้งหมดบนคอมพิวเตอร์ให้เป็นเอกสาร XML วัตถุถูกขยายให้มีความลึกสามระดับ

พารามิเตอร์

-As

กำหนดรูปแบบเอาต์พุต ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ:

• String - ส่งกลับสตริงเดียว
• Stream - ส่งกลับอาร์เรย์ของสตริง
• Document - ส่งกลับวัตถุ XmlDocument

ค่าเริ่มต้นคือ เอกสาร

พิมพ์ :

String

ค่าที่ยอมรับ:

สตรีม สตริง เอกสาร

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-Depth

ระบุจำนวนอ็อบเจ็กต์ที่มีอยู่ในการแสดง XML ค่าเริ่มต้นคือ 1

ตัวอย่างเช่น หากคุณสมบัติของออบเจ็กต์มีออบเจ็กต์ด้วย หากต้องการบันทึกการแสดง XML ของคุณสมบัติของออบเจ็กต์ที่มีอยู่ คุณต้องระบุความลึกเป็น 2

ค่าเริ่มต้นสามารถแทนที่ได้สำหรับประเภทออบเจ็กต์ในไฟล์ Types.ps1xml สำหรับข้อมูลเพิ่มเติม โปรดดู about_Types.ps1xml

พิมพ์ :

Int32

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-InputObject

ระบุวัตถุที่จะแปลง ป้อนตัวแปรที่มีวัตถุ หรือพิมพ์คำสั่งหรือนิพจน์ที่ได้รับวัตถุ คุณยังสามารถไพพ์ออบเจ็กต์เป็น ConvertTo-XML ได้ด้วย

พิมพ์ :

PSObject

ตำแหน่ง:

0

ค่าเริ่มต้น:

None

ที่จำเป็น:

True

ยอมรับอินพุตไปป์ไลน์:

True

ยอมรับอักขระตัวแทน:

False

-NoTypeInformation

ละเว้นแอตทริบิวต์ Type จากโหนดอ็อบเจ็กต์

พิมพ์ :

SwitchParameter

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

อินพุต

PSObject

คุณสามารถไปป์วัตถุใด ๆ ไปที่ cmdlet นี้

เอาท์พุต

สตริง

เมื่อคุณใช้พารามิเตอร์ As และตั้งค่าเป็น string cmdlet นี้จะส่งคืน XML เป็นสตริง เมื่อค่าเป็น stream cmdlet นี้จะส่งคืนอาร์เรย์ของสตริง

เอกสาร Xml

ตามค่าเริ่มต้น cmdlet นี้จะส่งกลับเอกสาร XML