Update-FormatData
Memperbarui data pemformatan dalam sesi saat ini.
Sintaks
Update-FormatData
[[-AppendPath] <String[]>]
[-PrependPath <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Update-FormatData
memuat ulang data pemformatan dari memformat file 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 bawaan.
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.
Jenis: | String[] |
Alias: | PSPath, Path |
Position: | 0 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
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 perintahUpdate-FormatData
untuk memperbarui data pemformatan untuk perintah yang diimpor. Anda tidak perlu mengimpor modul lagi.