Bagikan melalui

Memformat Ringkasan File

Format tampilan untuk objek yang dikembalikan oleh perintah (cmdlet, fungsi, dan skrip) ditentukan dengan menggunakan file pemformatan (format.ps1xml). Beberapa file ini disediakan oleh PowerShell untuk menentukan format tampilan untuk objek yang dikembalikan oleh perintah yang disediakan PowerShell, seperti objek System.Diagnostics.Process yang dikembalikan oleh cmdlet Get-Process. Namun, Anda juga dapat membuat file pemformatan kustom Anda sendiri untuk menimpa format tampilan default atau Anda dapat menulis file pemformatan kustom untuk menentukan tampilan objek yang dikembalikan oleh perintah Anda sendiri.

Penting

Memformat file tidak menentukan elemen objek yang dikembalikan ke alur. Saat objek dikembalikan ke alur, semua anggota objek tersebut tersedia meskipun beberapa tidak ditampilkan.

PowerShell menggunakan data dalam file pemformatan ini untuk menentukan apa yang ditampilkan dan bagaimana data yang ditampilkan diformat. Data yang ditampilkan dapat menyertakan properti objek atau nilai skrip. Skrip digunakan jika Anda ingin menampilkan beberapa nilai yang tidak tersedia langsung dari properti objek, seperti menambahkan nilai dua properti objek lalu menampilkan jumlah sebagai bagian dari data. Pemformatan data yang ditampilkan dilakukan dengan menentukan tampilan untuk objek yang ingin Anda tampilkan. Anda dapat menentukan satu tampilan untuk setiap objek, Anda dapat menentukan satu tampilan untuk beberapa objek, atau Anda dapat menentukan beberapa tampilan untuk objek yang sama. Tidak ada batasan jumlah tampilan yang dapat Anda tentukan.

Fitur Umum Pemformatan File

Setiap file pemformatan dapat menentukan komponen berikut yang dapat dibagikan di semua tampilan yang ditentukan oleh file:

  • Pengaturan konfigurasi default, seperti apakah data yang ditampilkan dalam baris tabel akan ditampilkan pada baris berikutnya jika data lebih panjang dari lebar kolom. Untuk informasi selengkapnya tentang pengaturan ini, lihat Wrap Element for TableRowEntry.

  • Kumpulan objek yang dapat ditampilkan oleh salah satu tampilan file pemformatan. Untuk informasi selengkapnya tentang set ini (disebut sebagai kumpulan pilihan ), lihat Menentukan Set Objek.

  • Kontrol umum yang dapat digunakan oleh semua tampilan file pemformatan. Kontrol memberi Anda kontrol yang lebih baik tentang cara data ditampilkan. Untuk informasi selengkapnya tentang kontrol, lihat Menentukan Kontrol Kustom.

Tampilan Pemformatan

Tampilan pemformatan dapat menampilkan objek dalam format tabel, format daftar, format lebar, dan format kustom. Untuk sebagian besar, setiap definisi pemformatan dijelaskan oleh sekumpulan tag XML yang menjelaskan tampilan. Setiap tampilan berisi nama tampilan, objek yang menggunakan tampilan, dan elemen tampilan, seperti informasi kolom dan baris untuk tampilan tabel.

Tampilan Tabel

Mencantumkan properti objek atau nilai blok skrip dalam satu atau beberapa kolom. Setiap kolom mewakili satu properti objek atau nilai skrip. Anda dapat menentukan tampilan tabel yang menampilkan semua properti objek, subset properti objek, atau kombinasi properti dan nilai skrip. Setiap baris tabel mewakili objek yang dikembalikan. Membuat tampilan tabel sangat mirip dengan saat Anda menyalurkan objek ke cmdlet Format-Table. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Tabel.

Tampilan Daftar

Mencantumkan properti objek atau nilai skrip dalam satu kolom. Setiap baris daftar menampilkan label opsional atau nama properti diikuti dengan nilai properti atau skrip. Membuat tampilan daftar sangat mirip dengan pipa objek dengan cmdlet Format-List. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Daftar.

Tampilan Lebar

Mencantumkan satu properti objek atau nilai skrip dalam satu atau beberapa kolom. Tidak ada label atau header untuk tampilan ini. Membuat tampilan lebar sangat mirip dengan pipa objek dengan cmdlet Format-Wide. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Lebar.

Tampilan kustom

Menampilkan tampilan properti objek atau nilai skrip yang dapat disesuaikan yang tidak mematuhi struktur kaku tampilan tabel, tampilan daftar, atau tampilan lebar. Anda dapat menentukan tampilan kustom yang berdiri sendiri, atau Anda bisa menentukan tampilan kustom yang digunakan oleh tampilan lain, seperti tampilan tabel atau tampilan daftar. Membuat tampilan kustom sangat mirip dengan pipa objek dengan cmdlet Format-Custom. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Kustom.

Komponen Tampilan

Contoh XML berikut menunjukkan komponen XML dasar tampilan. Elemen XML individual bervariasi tergantung pada tampilan mana yang ingin Anda buat, tetapi komponen dasar tampilan semuanya sama.

Untuk memulainya, setiap tampilan memiliki elemen Name yang menentukan nama ramah pengguna yang digunakan untuk mereferensikan tampilan. elemen ViewSelectedBy yang menentukan objek .NET mana yang ditampilkan oleh tampilan, dan elemen kontrol yang menentukan tampilan.

<ViewDefinitions>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <TableControl>...</TableControl>
  </View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <ListControl>...</ListControl>
  <View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <WideControl>...</WideControl>
  <View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <CustomControl>...</CustomControl>
  </View>
</ViewDefinitions>

Dalam elemen kontrol, Anda dapat menentukan satu atau beberapa elemen entri. Jika Anda menggunakan beberapa definisi, Anda harus menentukan objek .NET mana yang menggunakan setiap definisi. Biasanya hanya satu entri, dengan hanya satu definisi, diperlukan untuk setiap kontrol.

<ListControl>
  <ListEntries>
    <ListEntry>
      <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    </ListEntry>
    <ListEntry>
        <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    </ListEntry>
    <ListEntry>
        <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    </ListEntry>
  </ListEntries>
</ListControl>

Dalam setiap elemen entri tampilan, Anda menentukan item elemen yang menentukan properti .NET atau skrip yang ditampilkan oleh tampilan tersebut.


<ListItems>
  <ListItem>...</ListItem>
  <ListItem>...</ListItem>
  <ListItem>...</ListItem>
</ListItems>

Seperti yang ditunjukkan dalam contoh sebelumnya, file pemformatan dapat berisi beberapa tampilan, tampilan dapat berisi beberapa definisi, dan setiap definisi dapat berisi beberapa item.

Contoh Tampilan Tabel

Contoh berikut menunjukkan tag XML yang digunakan untuk menentukan tampilan tabel yang berisi dua kolom. Elemen ViewDefinitions adalah elemen kontainer untuk semua tampilan yang ditentukan dalam file pemformatan. Elemen View menentukan tabel, daftar, lebar, atau tampilan kustom tertentu. Dalam setiap elemen Tampilan, elemen Nama menentukan nama tampilan, elemen ViewSelectedBy menentukan objek yang menggunakan tampilan, dan elemen kontrol yang berbeda (seperti elemen TableControl yang diperlihatkan dalam contoh berikut) menentukan jenis tampilan.

<ViewDefinitions>
  <View>
    <Name>Name of View</Name>
    <ViewSelectedBy>
      <TypeName>Object to display using this view</TypeName>
      <TypeName>Object to display using this view</TypeName>
    </ViewSelectedBy>
    <TableControl>
      <TableHeaders>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
      </TableHeaders>
      <TableRowEntries>
        <TableRowEntry>
          <TableColumnItems>
            <TableColumnItem>
              <PropertyName>Header for column 1</PropertyName>
            </TableColumnItem>
            <TableColumnItem>
              <PropertyName>Header for column 2</PropertyName>
            </TableColumnItem>
          </TableColumnItems>
        </TableRowEntry>
      </TableRowEntries>
    </TableControl>
  </View>
</ViewDefinitions>

Lihat Juga

Membuat Tampilan Daftar

Membuat Tampilan Tabel

Membuat Tampilan Lebar

Membuat kontrol kustom

Menulis File Pemformatan dan Tipe PowerShell