Mengontrol pemformatan output alur

  • 8 menit

PowerShell menyediakan beberapa cara untuk mengontrol pemformatan output alur. Pemformatan default output tergantung pada objek yang ada dalam output dan file konfigurasi yang menentukan output. Setelah PowerShell memutuskan format yang sesuai, ia meneruskan output ke sekumpulan cmdlet pemformatan tanpa input Anda.

Cmdlet pemformatan adalah:

  • Format-List
  • Format-Table
  • Format-Wide
  • Format-Custom

Anda dapat mengganti pemformatan output default dengan menentukan salah satu cmdlet sebelumnya sebagai bagian dari alur.

Catatan

Cmdlet Format-Kustom memerlukan pembuatan file konfigurasi XML kustom yang menentukan format. Ini jarang digunakan dan berada di luar cakupan kursus ini.

Setiap cmdlet pemformatan menerima parameter -Property. Parameter -Property menerima daftar nama properti yang dipisahkan koma, lalu memfilter daftar properti yang ditampilkan dan urutan tampilannya. Perlu diingat bahwa ketika Anda menentukan nama properti untuk parameter ini, perintah asli harus mengembalikan properti tersebut.

Misalnya, cmdlet Get-ADUser hanya mengembalikan subset properti, kecuali Anda menentukan parameter -Properties. Oleh karena itu, jika Anda menentukan properti City dalam parameter -Property untuk cmdlet pemformatan, properti akan ditampilkan seolah-olah properti tidak diatur, kecuali Anda memastikan bahwa properti City adalah salah satu properti yang dikembalikan untuk pengguna yang dikueri.

Beberapa cmdlet default untuk melewati sekumpulan properti yang berbeda untuk setiap cmdlet pemformatan. Misalnya, cmdlet Get-Service menampilkan tiga properti (Status, Nama, dan DisplayName) dalam format tabel secara default. Jika Anda menampilkan output Get-Service sebagai daftar dengan menggunakan perintah Get-Service | Format-List, enam properti tambahan akan ditampilkan.

Format-List

Cmdlet Format-List, seperti namanya, memformat output perintah sebagai daftar properti sederhana, di mana setiap properti ditampilkan pada baris baru. Jika perintah meneruskan output ke Format-List mengembalikan beberapa objek, daftar properti terpisah untuk setiap objek ditampilkan. Pemformatan daftar sangat berguna ketika perintah mengembalikan sejumlah besar properti yang akan sulit ditinjau dalam format tabel.

Catatan

Alias untuk cmdlet Format-List adalah fl.

Untuk menampilkan daftar sederhana di konsol properti default untuk proses yang berjalan di komputer lokal, masukkan perintah berikut, lalu tekan tombol Enter:

Get-Process | Format-List

Format-Table

Cmdlet Format-Tabel memformat output sebagai tabel, di mana setiap baris mewakili objek, dan setiap kolom mewakili properti. Format tabel berguna untuk menampilkan properti banyak objek secara bersamaan dan membandingkan properti objek tersebut.

Secara default, tabel menyertakan nama properti sebagai header kolom, yang dipisahkan dari data dengan baris tanda hubung. Pemformatan tabel bergantung pada objek yang dikembalikan. Anda dapat mengubah pemformatan ini dengan menggunakan berbagai parameter, seperti:

  • -AutoSize. Parameter ini menyesuaikan ukuran dan jumlah kolom berdasarkan lebar data. Di Windows PowerShell 5.0 dan yang lebih baru, -AutoSize diatur ke true secara default. Dalam versi Windows PowerShell yang lebih lama, nilai default mungkin memotong data dalam tabel.
  • -HideTableHeaders. Parameter ini menghapus header tabel dari output.
  • -Wrap. Parameter ini menyebabkan teks yang lebih lebar dari lebar kolom untuk dibungkus ke baris berikutnya.

Catatan

Alias untuk cmdlet Format-Tabel adalah ft.

Untuk menampilkan properti Nama, ObjectClass, dan Deskripsi untuk semua objek Windows Server Active Directory sebagai tabel, dengan kolom diatur ke ukuran dan pembungkusan teks secara otomatis, masukkan perintah berikut di konsol, lalu tekan tombol Enter:

Get-ADObject -filter * -Properties * | ft -Property Name, ObjectClass, Description -AutoSize -Wrap

Format-Wide

Output cmdlet Format-Wide adalah properti tunggal dalam satu daftar yang ditampilkan dalam beberapa kolom. Cmdlet ini berfungsi seperti parameter /w dari perintah dir di cmd.exe. Format lebar berguna untuk menampilkan daftar besar data sederhana, seperti nama file atau proses, dalam format ringkas.

Secara default, Format-Wide menampilkan outputnya dalam dua kolom. Anda dapat mengubah jumlah kolom dengan menggunakan parameter -Column. Parameter -AutoSize, yang bekerja dengan cara yang sama seperti yang dilakukannya untuk Format-Tabel, juga tersedia. Namun, Anda tidak dapat menggunakan -AutoSize dan -Column together. Parameter -Property juga tersedia, tetapi dalam kasus Format-Wide, parameter ini hanya dapat menerima satu nama properti.

Catatan

Alias untuk cmdlet Format-Wide adalah fw.

Untuk mengirim properti DisplayName dari semua objek Kebijakan Grup (GPO) di domain saat ini sebagai output dalam tiga kolom, masukkan perintah berikut di konsol, lalu tekan tombol Enter:

Get-GPO -all | fw -Property DisplayName -Column 3