อัปเดต-FormatData (Microsoft.PowerShell.Utility)

Update-FormatData

โมดูล :

Microsoft.PowerShell.Utility

อัพเดตข้อมูลการจัดรูปแบบในเซสชันปัจจุบัน

ไวยากรณ์

Update-FormatData
      [[-AppendPath] <String[]>]
      [-PrependPath <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

คำอธิบาย

Update-FormatData cmdlet จะโหลดข้อมูลการจัดรูปแบบจากการจัดรูปแบบไฟล์ลงในเซสชันปัจจุบันอีกครั้ง cmdlet นี้ช่วยให้คุณอัปเดตข้อมูลการจัดรูปแบบโดยไม่ต้องรีสตาร์ท PowerShell

หากไม่มีพารามิเตอร์ Update-FormatData จะโหลดไฟล์การจัดรูปแบบที่โหลดก่อนหน้านี้อีกครั้ง คุณสามารถใช้พารามิเตอร์ของ Update-FormatData เพื่อเพิ่มไฟล์การจัดรูปแบบใหม่ลงในเซสชัน

การจัดรูปแบบไฟล์คือไฟล์ข้อความในรูปแบบ XML ที่มีนามสกุลไฟล์ format.ps1xml ข้อมูลการจัดรูปแบบในไฟล์จะกำหนดการแสดงวัตถุ Microsoft .NET Framework ในเซสชัน

เมื่อ PowerShell เริ่มต้น ระบบจะโหลดข้อมูลรูปแบบจากซอร์สโค้ด PowerShell อย่างไรก็ตาม คุณสามารถสร้างไฟล์ format.ps1xml แบบกำหนดเองเพื่ออัปเดตการจัดรูปแบบในเซสชันปัจจุบันได้ คุณสามารถใช้ Update-FormatData เพื่อโหลดข้อมูลการจัดรูปแบบซ้ำในเซสชันปัจจุบันโดยไม่ต้องรีสตาร์ท PowerShell สิ่งนี้มีประโยชน์เมื่อคุณเพิ่มหรือเปลี่ยนแปลงไฟล์การจัดรูปแบบ แต่ไม่ต้องการขัดจังหวะเซสชัน

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบไฟล์ใน PowerShell โปรดดูที่ about_Format.ps1xml

ตัวอย่าง

ตัวอย่างที่ 1: โหลดไฟล์การจัดรูปแบบที่โหลดก่อนหน้านี้ซ้ำ

Update-FormatData

คำสั่งนี้จะโหลดไฟล์การจัดรูปแบบที่โหลดไว้ก่อนหน้านี้อีกครั้ง

ตัวอย่างที่ 2: โหลดไฟล์การจัดรูปแบบใหม่และติดตามและบันทึกไฟล์การจัดรูปแบบ

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

คำสั่งนี้จะรีโหลดไฟล์การจัดรูปแบบลงในเซสชัน รวมถึงไฟล์ใหม่สองไฟล์ Trace.format.ps1xml และ Log.format.ps1xml

เนื่องจากคำสั่งใช้พารามิเตอร์ AppendPath ข้อมูลการจัดรูปแบบในไฟล์ใหม่จะถูกโหลดหลังจากข้อมูลการจัดรูปแบบจากไฟล์ในตัว

พารามิเตอร์ AppendPath ถูกใช้เนื่องจากไฟล์ใหม่มีข้อมูลการจัดรูปแบบสำหรับออบเจ็กต์ที่ไม่ได้อ้างอิงในไฟล์ที่มีอยู่แล้วภายใน

ตัวอย่างที่ 3: แก้ไขไฟล์การจัดรูปแบบและโหลดซ้ำ

Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

Update-FormatData

ตัวอย่างนี้แสดงวิธีการโหลดไฟล์การจัดรูปแบบใหม่หลังจากที่คุณแก้ไขแล้ว

คำสั่งแรกจะเพิ่มไฟล์ NewFiles.format.ps1xml ให้กับเซสชัน โดยใช้พารามิเตอร์ PrependPath เนื่องจากไฟล์มีข้อมูลการจัดรูปแบบสำหรับออบเจ็กต์ที่อ้างอิงในไฟล์ในตัว

หลังจากเพิ่มไฟล์ NewFiles.format.ps1xml และทดสอบในเซสชันเหล่านี้ ผู้เขียนจะแก้ไขไฟล์

คำสั่งที่สองใช้ Update-FormatData cmdlet เพื่อโหลดไฟล์การจัดรูปแบบใหม่ เนื่องจากไฟล์ NewFiles.format.ps1xml ถูกโหลดไว้ก่อนหน้านี้ Update-FormatData จะโหลดซ้ำโดยอัตโนมัติโดยไม่ต้องใช้พารามิเตอร์

พารามิเตอร์

-AppendPath

ระบุการจัดรูปแบบไฟล์ที่ cmdlet นี้เพิ่มในเซสชัน ไฟล์จะถูกโหลดหลังจากที่ PowerShell โหลดไฟล์การจัดรูปแบบที่มีอยู่แล้วภายใน

เมื่อจัดรูปแบบออบเจ็กต์ .NET PowerShell จะใช้ข้อกำหนดการจัดรูปแบบแรกที่พบสำหรับ .NET แต่ละประเภท หากคุณใช้พารามิเตอร์ AppendPath PowerShell จะค้นหาข้อมูลจากไฟล์ที่มีอยู่แล้วภายในก่อนที่จะพบข้อมูลการจัดรูปแบบที่คุณกำลังเพิ่ม

ใช้พารามิเตอร์นี้เพื่อเพิ่มไฟล์ที่จัดรูปแบบออบเจ็กต์ .NET ที่ไม่ได้อ้างอิงในไฟล์การจัดรูปแบบที่มีอยู่แล้วภายใน

พิมพ์ :

String[]

นามแฝง :

PSPath, Path

ตำแหน่ง:

0

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

None

ที่จำเป็น:

False

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

True

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

False

-Confirm

แจ้งให้คุณยืนยันก่อนเรียกใช้ cmdlet

พิมพ์ :

SwitchParameter

นามแฝง :

cf

ตำแหน่ง:

ตั้งชื่อ

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

False

ที่จำเป็น:

False

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

False

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

False

-PrependPath

ระบุการจัดรูปแบบไฟล์ที่ cmdlet นี้เพิ่มในเซสชัน ไฟล์จะถูกโหลดก่อนที่ PowerShell จะโหลดไฟล์การจัดรูปแบบที่มีอยู่แล้วภายใน

เมื่อจัดรูปแบบออบเจ็กต์ .NET PowerShell จะใช้ข้อกำหนดการจัดรูปแบบแรกที่พบสำหรับ .NET แต่ละประเภท หากคุณใช้พารามิเตอร์ PrependPath PowerShell จะค้นหาข้อมูลจากไฟล์ที่คุณกำลังเพิ่มก่อนที่จะพบข้อมูลการจัดรูปแบบจากไฟล์ในตัว

ใช้พารามิเตอร์นี้เพื่อเพิ่มไฟล์ที่จัดรูปแบบออบเจ็กต์ .NET ที่ถูกอ้างอิงในไฟล์การจัดรูปแบบที่มีอยู่แล้วภายในด้วย

พิมพ์ :

String[]

ตำแหน่ง:

ตั้งชื่อ

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

None

ที่จำเป็น:

False

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

False

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

False

-WhatIf

แสดงสิ่งที่จะเกิดขึ้นหาก cmdlet ทำงาน cmdlet ไม่ทำงาน

พิมพ์ :

SwitchParameter

นามแฝง :

wi

ตำแหน่ง:

ตั้งชื่อ

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

False

ที่จำเป็น:

False

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

False

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

False

อินพุต

สตริง

คุณสามารถไปป์สตริงที่ประกอบด้วยเส้นทางผนวกกับ cmdlet นี้

เอาท์พุต

ไม่มี

cmdlet นี้ส่งคืนไม่มีผลลัพธ์

หมายเหตุ

• Update-FormatData ยังอัปเดตข้อมูลการจัดรูปแบบสำหรับคำสั่งในเซสชันที่นำเข้าจากโมดูล หากไฟล์การจัดรูปแบบสำหรับโมดูลเปลี่ยนแปลง คุณสามารถเรียกใช้คำสั่ง Update-FormatData เพื่ออัปเดตข้อมูลการจัดรูปแบบสำหรับคำสั่งที่นำเข้า คุณไม่จำเป็นต้องนำเข้าโมดูลอีกครั้ง