Bagikan melalui

Update-FormatData

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Memperbarui data pemformatan dalam sesi saat ini.

Sintaks

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

Deskripsi

Update-FormatData Cmdlet memuat ulang data pemformatan dari pemformatan 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 format.ps1xml ekstensi nama file. 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 pemformatan 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 Update-FormatData cmdlet untuk memuat ulang file pemformatan. Karena file NewFiles.format.ps1xml sebelumnya dimuat, Update-FormatData secara otomatis memuat ulang 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.

Type:String[]
Aliases:PSPath, Path
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 Update-FormatData perintah untuk memperbarui data pemformatan untuk perintah yang diimpor. Anda tidak perlu mengimpor modul lagi.