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

Export-FormatData Cmdlet 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 Get-FormatData cmdlet 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 Get-FormatData perintah ke Export-FormatData cmdlet, 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 Get-FormatData cmdlet untuk mendapatkan data format untuk jenis HelpInfoShort , dan menyimpannya dalam $F variabel.

Perintah kedua menggunakan parameter InputObject cmdlet Export-FormatData untuk memasukkan data format yang disimpan dalam $F variabel . 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 Export-FormatData perintah.

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

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

Perintah kedua menggunakan Update-FormatData cmdlet 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 Get-Process cmdlet 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 berjalan tanpa meminta konfirmasi pengguna.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:ExtendedTypeDefinition[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Menentukan lokasi untuk file output. Tidak seperti parameter Path , nilai LiteralPath digunakan persis seperti yang ditik. 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.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 untuk menimpa file baca-saja, gunakan parameter Paksa .

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 buat file di direktori saat ini.

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

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

Type:String
Aliases:FilePath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

ExtendedTypeDefinition

Anda dapat menyalurkan objek ExtendedTypeDefinition dari Get-FormatData ke Export-FormatData.

Output

None

Export-FormatData tidak mengembalikan objek apa pun. 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.