Bagikan melalui

Format-Wide

Modul:
Microsoft.PowerShell.Utility Module

Memformat objek sebagai tabel lebar yang hanya menampilkan satu properti dari setiap objek.

Sintaks

Default (Default) 

Format-Wide
    [[-Property] <Object>]
    [-AutoSize]
    [-Column <int>]
    [-GroupBy <Object>]
    [-View <string>]
    [-ShowError]
    [-DisplayError]
    [-Force]
    [-Expand <string>]
    [-InputObject <psobject>]
    [<CommonParameters>]

Deskripsi

cmdlet Format-Wide memformat objek sebagai tabel lebar yang hanya menampilkan satu properti dari setiap objek. Anda dapat menggunakan parameter Properti untuk menentukan properti mana yang ditampilkan.

Contoh

Contoh 1: Memformat nama file di direktori saat ini

Perintah ini menampilkan nama file di direktori saat ini dalam tiga kolom di seluruh layar.

Get-ChildItem | Format-Wide -Column 3

cmdlet Get-ChildItem mendapatkan objek yang mewakili setiap file dalam direktori. Operator alur (|) meneruskan objek file melalui alur untuk Format-Wide, yang memformatnya untuk output. Parameter Kolom menentukan jumlah kolom.

Contoh 2: Memformat nama kunci registri

Perintah ini menampilkan nama kunci registri di kunci HKEY_CURRENT_USER\Software\Microsoft.

Get-ChildItem HKCU:\software\Microsoft | Format-Wide -Property PSChildName -AutoSize

Cmdlet Get-ChildItem mendapatkan objek yang berfungsi sebagai representasi kunci. Jalur ditetapkan sebagai HKCU:, salah satu drive yang diekspos oleh penyedia Registri PowerShell, dan diikuti oleh jalur kunci. Operator alur (|) meneruskan objek kunci registri melalui alur untuk Format-Wide, yang memformatnya untuk output. Parameter Properti menentukan nama properti, dan parameter AutoSize menyesuaikan kolom untuk keterbacaan.

Contoh 3: Pemecahan masalah kesalahan format

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

PS /> Get-Date | Format-Wide { $_ / $null } -DisplayError


#ERR

PS /> Get-Date | Format-Wide { $_ / $null } -ShowError


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

Parameter

-AutoSize

Menyesuaikan ukuran kolom dan jumlah kolom berdasarkan lebar data. Secara default, ukuran dan angka kolom ditentukan oleh tampilan. Anda tidak dapat menggunakan parameter AutoSize dan Column dalam perintah yang sama.

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

-Column

Menentukan jumlah kolom dalam tampilan. Anda tidak dapat menggunakan parameter AutoSize dan Column dalam perintah yang sama.

Properti parameter

Jenis:Int32
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

-DisplayError

Menampilkan kesalahan pada baris perintah. Parameter ini jarang digunakan, tetapi dapat digunakan sebagai bantuan penelusuran kesalahan saat Anda memformat ekspresi dalam perintah Format-Wide, 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

Memformat objek koleksi itu sendiri, serta objek-objek di dalam koleksi tersebut. Parameter ini dirancang untuk memformat objek yang mendukung antarmuka System.Collections.ICollection . Nilai defaultnya adalah EnumOnly.

Nilai yang valid 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:EnumOnly
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 mengambil alih batasan yang mencegah perintah berhasil, sehingga perubahan tidak membahayakan keamanan. Misalnya, Force akan mengambil alih atribut baca-saja atau membuat direktori untuk menyelesaikan jalur file, tetapi tidak akan mencoba mengubah izin file.

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

Memformat 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-Wide untuk mengelompokkan objek.

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

  • Name (atau Label) - <string>
  • Expression - <string> atau <scriptblock>
  • 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 di tampilan. 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 bisa berupa blok skrip atau tabel hash. Pasangan kunci-nilai yang valid adalah:

  • Expression - <string> atau <scriptblock>
  • 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

Mengirimkan kesalahan melalui jalur pemrosesan. Parameter ini jarang digunakan, tetapi dapat digunakan sebagai bantuan penelusuran kesalahan saat Anda memformat ekspresi dalam perintah Format-Wide, 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 tabel 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 cmdlet ini.

Output

Microsoft.PowerShell.Commands.Internal.Format

Cmdlet ini mengembalikan objek format yang mewakili tabel.

Catatan

PowerShell menyertakan alias berikut untuk Format-Wide:

  • Semua platform:
    • fw

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 tabel; jika tidak, perintah gagal. Jika tampilan alternatif adalah daftar, gunakan Format-List. Jika tampilan alternatif bukan daftar atau tabel, gunakan Format-Custom.