Bagikan melalui


Export-FormatData

Menyimpan data pemformatan dari sesi saat ini dalam file pemformatan.

Sintaks

Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -Path <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]
Export-FormatData
      -InputObject <ExtendedTypeDefinition[]>
      -LiteralPath <String>
      [-Force]
      [-NoClobber]
      [-IncludeScriptBlock]
      [<CommonParameters>]

Deskripsi

cmdlet Export-FormatData membuat file pemformatan PowerShell (format.ps1xml) dari objek pemformatan dalam sesi saat ini. Dibutuhkan objek ExtendedTypeDefinition yang Get-FormatData mengembalikan dan menyimpannya dalam file dalam format XML.

PowerShell menggunakan data dalam memformat file (format.ps1xml) untuk menghasilkan tampilan default objek Microsoft .NET Framework dalam sesi. Anda dapat melihat dan mengedit file pemformatan dan menggunakan cmdlet Update-FormatData untuk menambahkan data pemformatan ke sesi.

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

Contoh

Contoh 1: Mengekspor data format sesi

Get-FormatData -TypeName "*" | Export-FormatData -Path "allformat.ps1xml" -IncludeScriptBlock

Perintah ini mengekspor semua data format dalam sesi ke file AllFormat.ps1xml.

Perintah menggunakan cmdlet Get-FormatData untuk mendapatkan data format dalam sesi. Nilai * (semua) untuk parameter TypeName mengarahkan cmdlet untuk mendapatkan semua data dalam sesi.

Perintah menggunakan operator alur (|) untuk mengirim data format dari perintah Get-FormatData ke cmdlet Export-FormatData, yang mengekspor data format ke file AllFormat.ps1.

Perintah Export-FormatData menggunakan parameter IncludeScriptBlock untuk menyertakan blok skrip dalam data format dalam file.

Contoh 2: Mengekspor data format untuk jenis

$F = Get-FormatData -TypeName "helpinfoshort"
Export-FormatData -InputObject $F -Path "c:\test\help.format.ps1xml" -IncludeScriptBlock

Perintah ini mengekspor data format untuk jenis HelpInfoShort ke file Help.format.ps1xml.

Perintah pertama menggunakan cmdlet Get-FormatData untuk mendapatkan data format untuk jenis HelpInfoShort, dan menyimpannya dalam variabel $F.

Perintah kedua menggunakan parameter InputObject cmdlet Export-FormatData untuk memasukkan data format yang disimpan dalam variabel $F. Ini juga menggunakan parameter IncludeScriptBlock untuk menyertakan blok skrip dalam output.

Contoh 3: Mengekspor data format tanpa blok skrip

Get-FormatData -TypeName "System.Diagnostics.Process" | Export-FormatData -Path process.format.ps1xml
Update-FormatData -PrependPath ".\process.format.ps1xml"
Get-Process p*

Handles  NPM(K)  PM(K)  WS(K) VM(M)   CPU(s)    Id ProcessName
-------  ------  -----  ----- -----   ------    -- -----------
323                                       5600 powershell
336                                       3900 powershell_ise
138                                       4076 PresentationFontCache

Contoh ini menunjukkan efek menghilangkan parameter IncludeScriptBlock dari perintah Export-FormatData.

Perintah pertama menggunakan cmdlet Get-FormatData untuk mendapatkan data format untuk objek System.Diagnostics.Process yang dikembalikan cmdlet Get-Process. Perintah menggunakan operator alur (|) untuk mengirim data pemformatan ke cmdlet Export-FormatData, yang mengekspornya ke file Process.format.ps1xml di direktori saat ini.

Dalam hal ini, perintah Export-FormatData tidak menggunakan parameter IncludeScriptBlock.

Perintah kedua menggunakan cmdlet Update-FormatData untuk menambahkan file Process.format.ps1xml ke sesi saat ini. Perintah menggunakan parameter PrependPath untuk memastikan bahwa data pemformatan untuk objek proses dalam file Process.format.ps1xml ditemukan sebelum data pemformatan standar untuk objek proses.

Perintah ketiga menunjukkan efek perubahan ini. Perintah menggunakan cmdlet Get-Process untuk mendapatkan proses yang memiliki nama yang dimulai dengan P. Output menunjukkan bahwa nilai properti yang dihitung dengan menggunakan blok skrip hilang dari tampilan.

Parameter

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-IncludeScriptBlock

Menunjukkan apakah blok skrip dalam data format diekspor.

Karena blok skrip berisi kode dan dapat digunakan dengan berbahaya, blok skrip tidak diekspor secara default.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InputObject

Menentukan objek data format yang akan diekspor. Masukkan variabel yang berisi objek atau perintah yang mendapatkan objek, seperti perintah Get-FormatData. Anda juga dapat menyalurkan objek dari Get-FormatData ke Export-FormatData.

Jenis:ExtendedTypeDefinition[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-LiteralPath

Menentukan lokasi untuk file output. Tidak seperti parameter Jalur, nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Jenis:String
Alias:PSPath, LP
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-NoClobber

Menunjukkan bahwa cmdlet tidak menimpa file yang ada. Secara default, Export-FormatData menimpa file tanpa peringatan kecuali file memiliki atribut baca-saja.

Untuk mengarahkan Export-FormatData menimpa file baca-saja, gunakan parameter Force.

Jenis:SwitchParameter
Alias:NoOverwrite
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Path

Menentukan lokasi untuk file output. Masukkan jalur (opsional) dan nama file dengan ekstensi nama file format.ps1xml. Jika Anda menghilangkan jalur, Export-FormatData membuat file di direktori saat ini.

Jika Anda menggunakan ekstensi nama file selain .ps1xml, cmdlet Update-FormatData tidak akan mengenali file.

Jika Anda menentukan file yang ada, Export-FormatData menimpa file tanpa peringatan, kecuali file memiliki atribut baca-saja. Untuk menimpa file baca-saja, gunakan parameter Force. Untuk mencegah file ditimpa, gunakan parameter NoClobber.

Jenis:String
Alias:FilePath
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

Input

ExtendedTypeDefinition

Anda dapat menyalurkan objek ExtendedTypeDefinition dari Get-FormatData ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output. Ini menghasilkan file dan menyimpannya di jalur yang ditentukan.

Catatan

  • Untuk menggunakan file pemformatan apa pun, termasuk file pemformatan yang diekspor, kebijakan eksekusi untuk sesi harus mengizinkan skrip dan file konfigurasi untuk dijalankan. Untuk informasi selengkapnya, lihat about_Execution_Policies.