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 pemformatan 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 $F
disimpan dalam 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 dijalankan tanpa meminta konfirmasi pengguna.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Menentukan lokasi untuk file output. Tidak seperti parameter Jalur, 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 |
Required: | True |
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 |
Required: | False |
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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
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.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk