Bagikan melalui

Format-List

Modul:
Microsoft.PowerShell.Utility Module

Memformat output sebagai daftar properti tempat setiap properti muncul pada baris baru.

Sintaks

Default (Default) 

Format-List
    [[-Property] <Object[]>]
    [-GroupBy <Object>]
    [-View <string>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <string>]
    [-InputObject <psobject>]
    [<CommonParameters>]

Deskripsi

cmdlet Format-List memformat output perintah sebagai daftar properti tempat setiap properti ditampilkan pada baris terpisah. Anda dapat menggunakan Format-List untuk memformat dan menampilkan semua atau properti objek yang dipilih sebagai daftar (daftar format *).

Karena lebih banyak ruang tersedia untuk setiap item dalam daftar daripada dalam tabel, PowerShell menampilkan lebih banyak properti objek dalam daftar, dan nilai properti cenderung tidak terpotong.

Contoh

Contoh 1: Memformat layanan komputer

Get-Service | Format-List

Perintah ini memformat informasi tentang layanan pada komputer sebagai daftar. Secara default, layanan diformat sebagai tabel. cmdlet Get-Service mendapatkan objek yang mewakili layanan di komputer. Operator alur (|) meneruskan hasil melalui alur ke Format-List. Kemudian, perintah Format-List memformat informasi layanan dalam daftar dan mengirimkannya ke cmdlet output default untuk ditampilkan.

Contoh 2: Memformat file PS1XML

Perintah ini menampilkan informasi tentang file PS1XML di direktori PowerShell sebagai daftar.

$A = Get-ChildItem $pshome\*.ps1xml
Format-List -InputObject $A

Perintah pertama mendapatkan objek yang mewakili file dan menyimpannya dalam variabel $A.

Perintah kedua menggunakan Format-List untuk memformat informasi tentang objek yang disimpan di $A. Perintah ini menggunakan parameter InputObject untuk meneruskan variabel ke , yang kemudian mengirim output yang diformat ke cmdlet output default untuk ditampilkan.

Contoh 3: Memformat properti proses berdasarkan nama

Perintah ini menampilkan nama, prioritas dasar, dan kelas prioritas dari setiap proses pada komputer.

Get-Process | Format-List -Property name, basepriority, priorityclass

Ini menggunakan cmdlet Get-Process untuk mendapatkan objek yang mewakili setiap proses. Operator alur (|) meneruskan objek proses melalui alur ke Format-List. Format-List memformat proses sebagai daftar properti yang ditentukan. Nama parameter Properti bersifat opsional, sehingga Anda dapat menghilangkannya.

Contoh 4: Memformat semua properti untuk proses

Perintah ini menampilkan semua properti proses Winlogon.

Get-Process winlogon | Format-List -Property *

Ini menggunakan cmdlet Get-Process untuk mendapatkan objek yang mewakili proses Winlogon. Operator alur (|) melewati objek proses Winlogon melalui alur ke Format-List. Perintah menggunakan parameter Properti untuk menentukan properti dan * untuk menunjukkan semua properti. Karena nama parameter Properti bersifat opsional, Anda dapat menghilangkannya dan mengetik perintah sebagai . Format-List secara otomatis mengirim hasil ke cmdlet output default untuk ditampilkan.

Contoh 5: Pemecahan masalah kesalahan format

Contoh berikut menunjukkan hasil penambahan parameter DisplayError atau ShowError dengan ekspresi.

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -DisplayError

DayOfWeek    : Friday
 $_ / $null  : #ERR

PC /> Get-Date | Format-List DayOfWeek,{ $_ / $null } -ShowError

DayOfWeek    : Friday
 $_ / $null  :

Failed to evaluate expression " $_ / $null ".
+ CategoryInfo          : InvalidArgument: (12/21/2018 7:59:23 AM:PSObject) [], RuntimeException
+ FullyQualifiedErrorId : PSPropertyExpressionError

Parameter

-DisplayError

Menunjukkan bahwa cmdlet ini menampilkan kesalahan pada baris perintah. Parameter ini jarang digunakan, tetapi dapat digunakan sebagai bantuan penelusuran kesalahan saat Anda memformat ekspresi dalam perintah Format-List, dan ekspresi tampaknya tidak berfungsi.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Expand

Menentukan objek koleksi yang diformat, serta objek dalam koleksi. Parameter ini dirancang untuk memformat objek yang mendukung antarmuka ICollection (System.Collections). Nilai defaultnya adalah EnumOnly. Nilai yang dapat diterima untuk parameter ini adalah:

  • EnumOnly. Menampilkan properti objek dalam koleksi.
  • Inti saja. Menampilkan properti objek koleksi.
  • Keduanya. Menampilkan properti objek koleksi dan properti objek dalam koleksi.

Properti parameter

Jenis:String
Nilai default:None
Nilai yang diterima:CoreOnly, EnumOnly, Both
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Menunjukkan bahwa cmdlet ini menampilkan semua informasi kesalahan. Gunakan dengan parameter DisplayError atau ShowError. Secara default, ketika sebuah objek kesalahan ditulis ke dalam aliran kesalahan atau aliran tampilan, hanya sebagian informasi kesalahan yang ditampilkan.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-GroupBy

Menentukan output dalam grup berdasarkan properti atau nilai bersama. Masukkan ekspresi atau properti output.

Nilai parameter GroupBy dapat menjadi properti terhitung baru. Properti terhitung dapat berupa blok skrip atau tabel hash. Pasangan kunci-nilai yang valid adalah:

  • Nama (atau Label) - <string>
  • Ekspresi - <string> atau <script block>
  • FormatString - <string>

Untuk informasi lebih lanjut, lihat tentang_Properti_Terhitung.

Properti parameter

Jenis:Object
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-InputObject

Menentukan objek yang akan diformat. Masukkan variabel yang berisi objek atau ketik perintah atau ekspresi yang mendapatkan objek.

Properti parameter

Jenis:PSObject
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Property

Menentukan properti objek yang muncul dalam tampilan dan urutan munculnya. Kartu liar diizinkan.

Jika Anda menghilangkan parameter ini, properti yang muncul di tampilan bergantung pada objek yang ditampilkan. Nama parameter "Properti" bersifat opsional. Anda tidak dapat menggunakan properti dan parameter tampilan dalam perintah yang sama.

Nilai parameter Properti dapat menjadi properti terhitung baru. Properti terhitung dapat berupa blok skrip atau tabel hash. Pasangan kunci-nilai yang valid adalah:

  • Nama (atau Label) - <string>
  • Ekspresi - <string> atau <script block>
  • FormatString - <string>

Untuk informasi lebih lanjut, lihat tentang_Properti_Terhitung.

Properti parameter

Jenis:

Object[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ShowError

Menunjukkan bahwa cmdlet mengirim kesalahan melalui pipeline. Parameter ini jarang digunakan, tetapi dapat digunakan sebagai bantuan penelusuran kesalahan saat Anda memformat ekspresi dalam perintah Format-List, dan ekspresi tampaknya tidak berfungsi.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-View

Menentukan nama format atau tampilan daftar alternatif. Anda tidak dapat menggunakan properti dan parameter tampilan dalam perintah yang sama.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSObject

Anda dapat menyalurkan objek apa pun ke Format-List.

Output

Microsoft.PowerShell.Commands.Internal.Format

Format-List mengembalikan objek format yang mewakili daftar.

Catatan

Anda juga dapat merujuk ke Format-List oleh alias bawaannya, FL. Untuk informasi selengkapnya, lihat about_Aliases.

Format cmdlet, seperti Format-List, mengatur data yang akan ditampilkan, tetapi tidak menampilkannya. Data ditampilkan oleh fitur output PowerShell dan oleh cmdlet yang berisi kata kerja Out (cmdlet Out), seperti Out-Host atau Out-File.

Jika Anda tidak menggunakan cmdlet format, PowerShell menerapkan format default tersebut untuk setiap objek yang ditampilkannya.

Parameter GroupBy mengasumsikan bahwa objek diurutkan. Gunakan Sort-Object sebelum menggunakan Format-List untuk mengelompokkan objek.

Parameter View memungkinkan Anda menentukan format alternatif untuk tabel. Anda dapat menggunakan tampilan yang ditentukan dalam file *.format.PS1XML di direktori PowerShell, atau Anda dapat membuat tampilan Anda sendiri dalam file PS1XML baru dan menggunakan cmdlet Update-FormatData untuk menyertakannya di PowerShell.

Tampilan alternatif untuk parameter Tampilan harus menggunakan format daftar, jika tidak, perintah gagal. Jika tampilan alternatif adalah tabel, gunakan Format-Table. Jika tampilan alternatif bukan daftar atau tabel, gunakan Format-Custom.