Bagikan melalui

Update-FormatData

Modul:
Microsoft.PowerShell.Utility Module

Memperbarui data pemformatan dalam sesi saat ini.

Sintaks

Default (Default) 

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

Deskripsi

Cmdlet Update-FormatData memuat ulang data pemformatan dari file pemformatan ke dalam sesi saat ini. Cmdlet ini memungkinkan Anda memperbarui data pemformatan tanpa memulai ulang PowerShell.

Tanpa parameter, Update-FormatData memuat ulang file pemformatan yang dimuat sebelumnya. Anda dapat menggunakan parameter Update-FormatData untuk menambahkan file pemformatan baru ke sesi.

File pemformatan adalah file teks dalam format XML dengan ekstensi nama file format.ps1xml. Data pemformatan dalam file menentukan tampilan objek Microsoft .NET Framework dalam sesi.

Saat PowerShell dimulai, PowerShell memuat data format dari kode sumber PowerShell. Namun, Anda dapat membuat file format.ps1xml kustom untuk memperbarui pemformatan dalam sesi saat ini. Anda dapat menggunakan Update-FormatData untuk memuat ulang data pemformatan ke dalam sesi saat ini tanpa memulai ulang PowerShell. Ini berguna ketika Anda telah menambahkan atau mengubah file pemformatan, tetapi tidak ingin mengganggu sesi.

Untuk informasi selengkapnya tentang memformat file di PowerShell, lihat about_Format.ps1xml.

Contoh

Contoh 1: Muat ulang file pemformatan yang dimuat sebelumnya

Update-FormatData

Perintah ini memuat ulang file pemformatan yang dimuat sebelumnya.

Contoh 2: Memuat ulang file pemformatan dan melacak dan mencatat file pemformatan

Update-FormatData -AppendPath Trace.format.ps1xml, Log.format.ps1xml

Perintah ini memuat ulang file pemformatan ke dalam sesi, termasuk dua file baru, Trace.format.ps1xml dan Log.format.ps1xml.

Karena perintah menggunakan parameter appendPath , data pemformatan dalam file baru dimuat setelah memformat data dari file bawaan.

Parameter AppendPath digunakan karena file baru berisi data pemformatan untuk objek yang tidak dirujuk dalam file bawaan.

Contoh 3: Mengedit file pemformatan dan memuat ulang file tersebut

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

# Edit the NewFiles.format.ps1 file.

Update-FormatData

Contoh ini memperlihatkan cara memuat ulang file pemformatan setelah Anda mengeditnya.

Perintah pertama menambahkan file NewFiles.format.ps1xml ke sesi. Ini menggunakan parameter PrependPath karena file berisi data pemformatan untuk objek yang dirujuk dalam file tertanam.

Setelah menambahkan file NewFiles.format.ps1xml dan mengujinya dalam sesi ini, penulis mengedit file.

Perintah kedua menggunakan cmdlet Update-FormatData untuk memuat ulang file pemformatan. Karena file NewFiles.format.ps1xml sebelumnya dimuat, Update-FormatData secara otomatis memuat ulang file tanpa menggunakan parameter.

Parameter

-AppendPath

Menentukan file pemformatan yang ditambahkan cmdlet ini ke sesi. File dimuat setelah PowerShell memuat file pemformatan bawaan.

Saat memformat objek .NET, PowerShell menggunakan definisi pemformatan pertama yang ditemukannya untuk setiap jenis .NET. Jika Anda menggunakan parameter AppendPath , PowerShell mencari data dari file bawaan sebelum menemukan data pemformatan yang Anda tambahkan.

Gunakan parameter ini untuk menambahkan file yang memformat objek .NET yang tidak dirujuk dalam file pemformatan bawaan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath, Jalur

Set parameter

(All)
Position:0
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PrependPath

Menentukan file pemformatan yang ditambahkan cmdlet ini ke sesi. File dimuat sebelum PowerShell memuat file pemformatan bawaan.

Saat memformat objek .NET, PowerShell menggunakan definisi pemformatan pertama yang ditemukannya untuk setiap jenis .NET. Jika Anda menggunakan parameter prependPath , PowerShell mencari data dari file yang Anda tambahkan sebelum menemukan data pemformatan dari file bawaan.

Gunakan parameter ini untuk menambahkan file yang memformat objek .NET yang juga dirujuk dalam file pemformatan bawaan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
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.

Input

String

Anda dapat menyalurkan string yang berisi jalur tambahan ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

  • Update-FormatData juga memperbarui data pemformatan untuk perintah dalam sesi yang diimpor dari modul. Jika file pemformatan untuk modul berubah, Anda dapat menjalankan perintah Update-FormatData untuk memperbarui data pemformatan untuk perintah yang diimpor. Anda tidak perlu mengimpor modul lagi.