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 (Format-List -Property *).

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 pipeline (|) meneruskan objek proses Winlogon melalui pipeline 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

Set 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 System.Collections.ICollection . Nilai defaultnya adalah EnumOnly. Nilai yang dapat diterima untuk parameter ini adalah:

  • EnumOnly. Menampilkan properti objek dalam koleksi.
  • CoreOnly. Menampilkan properti objek koleksi.
  • Both. 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

Set 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 dituliskan ke dalam aliran kesalahan atau tampilan, hanya beberapa informasi kesalahan yang ditampilkan.

Juga diperlukan saat memformat jenis .NET tertentu. Untuk informasi selengkapnya, lihat bagian Catatan.

Properti parameter

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

Set 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. Parameter GroupBy mengharapkan objek diurutkan. Gunakan cmdlet Sort-Object sebelum menggunakan Format-List untuk mengelompokkan objek.

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

  • Name (atau Label) - <string>
  • Expression - <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

Set 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

Set 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 untuk 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:

  • Name (atau Label) - <string>
  • Expression - <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

Set 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

Set 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

Set 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 cmdlet ini.

Output

Microsoft.PowerShell.Commands.Internal.Format

Cmdlet ini mengembalikan objek format yang mewakili daftar.

Catatan

PowerShell menyertakan alias berikut untuk Format-List:

  • Semua platform:
    • fl

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 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.

Jika Anda ingin menggunakan Format-List dengan parameter Properti , Anda perlu menyertakan parameter Force di bawah salah satu kondisi berikut: