File Pemformatan Kustom

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

Windows PowerShell menggunakan data dalam file pemformatan ini untuk menentukan apa yang ditampilkan dan bagaimana data diformat. Data yang ditampilkan dapat menyertakan properti objek atau nilai blok skrip. Blok skrip digunakan jika Anda ingin menampilkan beberapa nilai yang tidak tersedia langsung dari properti objek. Misalnya, Anda mungkin ingin menambahkan nilai dua properti objek dan menampilkan jumlah sebagai bagian data terpisah. Saat menulis file pemformatan Anda sendiri, Anda harus 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.

Penting

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

Format Tampilan

Tampilan pemformatan bisa 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 berikut tersedia.

Tampilan tabel Mencantumkan properti objek atau nilai blok skrip dalam satu atau beberapa kolom. Setiap kolom mewakili properti objek atau nilai blok skrip. Anda dapat menentukan tampilan tabel yang menampilkan semua properti objek, subset properti objek, atau kombinasi properti dan nilai blok skrip. Setiap baris tabel mewakili objek yang dikembalikan. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Tabel.

Tampilan daftar Mencantumkan properti objek atau nilai blok skrip dalam satu kolom. Setiap baris daftar menampilkan label opsional atau nama properti diikuti dengan nilai properti atau blok skrip. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Daftar.

Tampilan lebar Mencantumkan satu properti objek atau nilai blok skrip dalam satu atau beberapa kolom. Tidak ada label atau header untuk tampilan ini. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Lebar.

Tampilan kustom Menampilkan tampilan properti objek atau nilai blok skrip yang dapat disesuaikan yang tidak mematuhi struktur kaku tampilan tabel, tampilan daftar, atau tampilan lebar. Anda bisa menentukan tampilan kustom mandiri, atau Anda bisa menentukan tampilan kustom yang digunakan oleh tampilan lain, seperti tampilan tabel atau tampilan daftar. Untuk informasi selengkapnya tentang tampilan ini, lihat Tampilan Kustom.

Menampilkan Elemen XML

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 tampilan, elemen Nama menentukan nama tampilan, elemen ViewSelectedBy menentukan objek yang menggunakan tampilan, dan elemen kontrol yang berbeda (seperti elemen TableControl) menentukan format 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

Tampilan Tabel

Tampilan Daftar

Tampilan Lebar

Tampilan Kustom

Menulis Cmdlet Windows PowerShell