Out-GridView
Mengirim output ke tabel interaktif di jendela terpisah.
Sintaks
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-PassThru]
[<CommonParameters>]
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-Wait]
[<CommonParameters>]
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-OutputMode <OutputModeOption>]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Out-GridView
Cmdlet mengirimkan output dari perintah ke jendela tampilan kisi tempat output ditampilkan dalam tabel interaktif.
Karena cmdlet ini memerlukan antarmuka pengguna, cmdlet ini tidak berfungsi pada Windows Server Core atau Windows Nano Server.
Anda bisa menggunakan fitur tabel berikut untuk memeriksa data Anda:
- Sembunyikan, perlihatkan, dan urus ulang kolom
- Urutkan baris
- Filter cepat
- Menambahkan filter kriteria
- Salin dan tempel
Untuk petunjuk lengkap, lihat bagian Catatan di artikel ini.
Catatan
Cmdlet ini diperkenalkan kembali di PowerShell 7. Cmdlet ini hanya tersedia pada sistem Windows yang mendukung Windows Desktop. Untuk versi lintas platform cmdlet ini, lihat modul ConsoleGuiTools di Galeri PowerShell.
Contoh
Contoh 1: Proses output ke tampilan kisi
Contoh ini membuat proses berjalan di komputer lokal dan mengirimkannya ke jendela tampilan kisi.
Get-Process | Out-GridView
Contoh 2: Gunakan variabel untuk menghasilkan proses ke tampilan kisi
Contoh ini juga mendapatkan proses yang berjalan di komputer lokal dan mengirimkannya ke jendela tampilan kisi.
$P = Get-Process
$P | Out-GridView
Output Get-Process
cmdlet disimpan dalam $P
variabel . Kemudian, $P
disalurkan ke Out-GridView
.
Contoh 3: Menampilkan properti yang dipilih dalam tampilan kisi
Contoh ini menampilkan properti yang dipilih dari proses yang sedang berjalan dalam tampilan kisi.
Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
Sort-Object -Property WorkingSet -Descending | Out-GridView
Output disalurkan Get-Process
ke untuk Select-Object
memilih properti Nama, Set Kerja, dan PeakWorkingSet . Operator alur lain mengirim objek yang difilter ke Sort-Object
cmdlet untuk mengurutkannya dalam urutan menurun menurut nilai properti WorkingSet .
Kemudian, hasil yang diurutkan disalurkan ke Out-GridView
. Sekarang Anda dapat menggunakan fitur tampilan kisi untuk mencari, mengurutkan, dan memfilter data.
Contoh 4: Simpan output ke variabel, lalu keluarkan tampilan kisi
Contoh ini menyimpan output cmdlet dalam variabel lalu mengirimkannya ke Out-GridView
.
($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView
Get-ChildItem
mendapatkan semua file di direktori penginstalan PowerShell dan subdirektorinya menggunakan $PSHOME
variabel otomatis. Tanda kurung dalam perintah menetapkan urutan operasi. Akibatnya, output dari Get-ChildItem
perintah disimpan dalam $A
variabel sebelum dikirim ke Out-GridView
.
Contoh 5: Proses output untuk komputer tertentu ke tampilan kisi
Contoh ini menampilkan proses yang berjalan di komputer Server01 di jendela tampilan kisi.
Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"
Contohnya menggunakan ogv
, yang merupakan alias untuk Out-GridView
cmdlet. Parameter Judul menentukan judul jendela.
Contoh 6: Data output dari komputer jarak jauh ke tampilan kisi
Contoh ini menunjukkan cara mengirim data yang dikumpulkan dari komputer jarak jauh ke Out-GridView
.
Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView
Invoke-Command
Get-Culture
berjalan pada tiga komputer jarak jauh. Data yang dihasilkan disalurkan ke Out-GridView
. Perhatikan bahwa blok skrip yang berjalan di komputer jarak jauh tidak menyertakan Out-GridView
perintah . Jika ya, perintah akan gagal ketika mencoba membuka jendela tampilan kisi pada setiap komputer jarak jauh.
Contoh 7: Meneruskan beberapa item melalui 'Out-GridView'
Contoh ini memungkinkan Anda memilih beberapa proses dari jendela Out-GridView
. Proses yang Anda pilih diteruskan ke Export-Csv
perintah dan ditulis ke ProcessLog.csv
file.
Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv
Parameter PassThru Out-GridView
memungkinkan Anda mengirim beberapa item ke alur. Parameter PassThru setara dengan menggunakan beberapa nilai parameter OutputMode .
Contoh 8: Buat pintasan Windows ke 'Out-GridView'
Contoh ini menunjukkan cara menggunakan parameter Out-GridView
Tunggu untuk membuat pintasan Windows ke Out-GridView
jendela.
pwsh -Command "Get-Service | Out-GridView -Wait"
Baris perintah ini dapat digunakan dalam pintasan Windows. Tanpa parameter Tunggu, PowerShell akan keluar segera setelah Out-GridView
jendela terbuka, yang akan segera menutup Out-GridView
jendela.
Parameter
-InputObject
Menentukan objek yang diterima cmdlet sebagai input untuk Out-GridView
.
Saat Anda menggunakan parameter InputObject untuk mengirim kumpulan objek ke Out-GridView
, Out-GridView
memperlakukan koleksi sebagai satu objek koleksi, dan menampilkan satu baris yang mewakili koleksi. Untuk menampilkan setiap objek dalam koleksi, gunakan operator alur (|
) untuk mengirim objek ke Out-GridView
.
Jenis: | PSObject |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-OutputMode
Menentukan item yang dikirimkan jendela interaktif ke alur sebagai input ke perintah lain. Secara default, cmdlet ini tidak menghasilkan output apa pun. Untuk mengirim item dari jendela interaktif ke bawah alur, klik untuk memilih item lalu klik OK.
Nilai parameter ini menentukan berapa banyak item yang dapat Anda kirimkan ke alur.
None
. Tidak ada item. Ini adalah nilai default.Single
. Nol item atau satu item. Gunakan nilai ini ketika perintah berikutnya hanya dapat mengambil satu objek input.Multiple
. Nol, satu, atau banyak item. Gunakan nilai ini ketika perintah berikutnya dapat mengambil beberapa objek input. Nilai ini setara dengan parameter Passthru .
Parameter ini diperkenalkan di Windows PowerShell 3.0.
Jenis: | OutputModeOption |
Nilai yang diterima: | None, Single, Multiple |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PassThru
Menunjukkan bahwa cmdlet mengirim item dari jendela interaktif ke bawah alur sebagai input ke perintah lain. Secara default, cmdlet ini tidak menghasilkan output apa pun. Parameter ini setara dengan menggunakan beberapa nilai parameter OutputMode .
Untuk mengirim item dari jendela interaktif ke bawah alur, klik untuk memilih item lalu klik OK. Shift-click dan Ctrl-click didukung.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Title
Menentukan teks yang muncul di bilah judul jendela Out-GridView
. Secara default, bilah judul menampilkan perintah yang memanggil Out-GridView
.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Wait
Menunjukkan bahwa cmdlet menekan prompt perintah dan mencegah Windows PowerShell menutup hingga jendela Out-GridView
ditutup. Secara default, prompt perintah akan kembali saat jendela Out-GridView
terbuka.
Fitur ini memungkinkan Anda menggunakan Out-GridView
cmdlet di pintasan Windows. Saat Out-GridView
digunakan dalam pintasan tanpa parameter Tunggu , Out-GridView
jendela hanya muncul sesaat sebelum PowerShell ditutup.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
Anda dapat menyalurkan objek apa pun ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
Saat Anda menggunakan parameter PassThru , cmdlet ini mengembalikan objek yang mewakili baris yang dipilih.
Catatan
PowerShell menyertakan alias berikut untuk Out-GridView
:
- Windows:
ogv
Cmdlet ini hanya tersedia di platform Windows. Cmdlet ini hanya tersedia di platform Windows.
Anda tidak dapat menggunakan perintah jarak jauh untuk membuka jendela tampilan kisi pada komputer lain.
Output perintah yang Anda kirim Out-GridView
tidak dapat diformat menggunakan Format
cmdlet, seperti Format-Table
atau Format-Wide
cmdlet. Untuk memilih properti, gunakan Select-Object
cmdlet .
Output yang dideserialisasi dari perintah jarak jauh mungkin tidak diformat dengan benar di jendela tampilan kisi.
Pintasan Keyboard untuk Out-GridView
Gunakan kunci ini: | Untuk melakukan tindakan ini: |
---|---|
Tab | Memindahkan kursor dari kotak Filter ke menu Tambahkan kriteria ke tabel dan kembali. |
UpArrow | Memindahkan satu baris ke atas. Berpindah ke header kolom dari baris pertama data. |
DownArrow | Memindahkan satu baris ke bawah. |
LeftArrow | Di baris header kolom, pindahkan ke kiri satu kolom. |
KananArrow | Di baris header kolom, pindahkan ke kanan satu kolom. |
ContextMenuKey | Di baris header kolom, menampilkan opsi Pilih Kolom. |
Masukkan atau Bilah Spasi | Di baris header kolom, urutkan data kolom (alihkan A-Z, Z-A). |
Cara Menggunakan Fitur Jendela Tampilan Kisi
Untuk menyembunyikan atau memperlihatkan kolom:
- Klik kanan header kolom apa pun dan klik Pilih Kolom.
- Dalam kotak dialog Pilih Kolom , gunakan tombol panah untuk memindahkan kolom di antara kolom Yang dipilih ke kotak Kolom yang tersedia. Hanya kolom dalam kotak Pilih Kolom yang muncul di jendela tampilan kisi.
Untuk menyusun ulang kolom:
Anda dapat menyeret dan meletakkan kolom ke lokasi yang diinginkan. Atau gunakan langkah-langkah berikut:
- Klik kanan header kolom apa pun dan klik Pilih Kolom.
- Dalam kotak dialog Pilih Kolom , gunakan tombol Pindah ke atas dan Pindahkan ke bawah untuk menyusun ulang kolom. Kolom di bagian atas daftar muncul di sebelah kiri kolom di bagian bawah daftar di jendela tampilan kisi.
Cara Mengurutkan Data Tabel
- Untuk mengurutkan data, klik header kolom.
- Untuk mengubah urutan pengurutan, klik header kolom lagi. Setiap kali Anda mengklik header yang sama, urutan pengurutan beralih antara urutan naik ke urutan menurun. Urutan saat ini ditunjukkan oleh segitiga di header kolom.
Cara Memilih Data Tabel
- Untuk memilih baris, pilih baris atau gunakan panah atas atau bawah untuk menavigasi ke baris.
- Untuk memilih semua baris (kecuali untuk baris header), tekan CTRL+A.
- Untuk memilih baris berturut-turut, tekan dan tahan tombol SHIFT sambil mengklik baris atau menggunakan tombol panah.
- Untuk memilih baris yang tidak akurat, tekan tombol CTRL dan klik untuk menambahkan baris ke pilihan.
- Anda tidak dapat memilih kolom, dan Anda tidak dapat memilih seluruh baris header kolom.
Cara Menyalin Baris
Untuk menyalin satu atau beberapa baris dari tabel, pilih baris lalu tekan CTRL+C.
Anda dapat menempelkan data ke dalam program teks atau spreadsheet apa pun. Anda tidak dapat menyalin kolom atau bagian baris dan Anda tidak dapat menyalin baris header kolom.
Cara Mencari di Tabel (Filter Cepat)
Gunakan kotak Filter untuk mencari data dalam tabel. Saat Anda mengetik dalam kotak, hanya item yang menyertakan teks yang ditikkan yang muncul dalam tabel.
Cari teks. Untuk mencari teks dalam tabel, dalam kotak Filter, ketik teks yang akan ditemukan.
Cari beberapa kata. Untuk mencari beberapa kata dalam tabel, ketik kata yang dipisahkan oleh spasi.
Out-GridView
menampilkan baris yang menyertakan semua kata (LOGICAL AND).Cari frasa harfiah. Untuk mencari frasa yang menyertakan spasi atau karakter khusus, sertakan frasa dalam tanda kutip.
Out-GridView
menampilkan baris yang menyertakan kecocokan yang tepat untuk frasa.Cari di kolom. Untuk mencari teks dalam satu atau beberapa kolom, gunakan format berikut:
<column>:<text> [<column>:<text>] ...
Misalnya, untuk menemukan "Net" di kolom DisplayName , dalam kotak Filter , ketik:
displayname:net
Untuk menemukan baris dengan "Net" di kolom DisplayName dan Name , dalam kotak Filter , ketik:
displayname:net name:net
Nonaktifkan pencarian. Untuk menampilkan seluruh tabel lagi, klik tombol X merah di sudut kanan atas kotak Filter atau hapus teks dari kotak Filter .
Gunakan Kriteria untuk Memfilter Tabel
Anda dapat menggunakan aturan atau kriteria untuk menentukan item mana yang ditampilkan dalam tabel. Item hanya muncul saat memenuhi semua kriteria yang Anda buat. Kriteria yang tersedia ditentukan oleh properti objek yang ditampilkan di jendela tampilan kisi dan jenis .NET Framework dari properti tersebut.
Setiap kriteria memiliki format berikut:
<column> <operator> <value>
Kriteria untuk properti yang berbeda disambungkan oleh AND. Kriteria untuk properti yang sama disambungkan oleh OR. Anda tidak dapat mengubah konektor logis.
Kriteria hanya memengaruhi tampilan. Ini tidak menghapus item dari tabel.
Cara Menambahkan Kriteria
- Untuk menampilkan tombol menu Tambahkan kriteria , di sudut kanan atas jendela, klik panah Perluas.
- Klik tombol menu Tambahkan Kriteria .
- Klik untuk memilih kolom (properti). Anda dapat memilih satu atau banyak properti.
- Setelah selesai memilih properti, klik tombol Tambahkan .
- Untuk membatalkan penambahan, klik Batal.
- Untuk menambahkan kriteria lainnya, klik lagi tombol Tambahkan Kriteria .
Cara Mengedit Kriteria
- Untuk mengubah operator, klik nilai operator biru, lalu pilih operator lain dari daftar drop-down.
- Untuk memasukkan atau mengubah nilai, ketik nilai dalam kotak nilai. Jika Anda memasukkan nilai yang tidak valid, ikon X melingkar akan muncul. Untuk menghapusnya, ubah nilainya.
- Untuk membuat pernyataan OR , tambahkan kriteria dengan properti yang sama.
Cara Menghapus Kriteria
- Untuk menghapus kriteria yang dipilih, klik X merah di samping setiap kriteria.
- Untuk menghapus semua kriteria, klik tombol Hapus Semua .