Out-GridView
Mengirim output ke tabel interaktif di jendela terpisah.
Sintaks
PassThru (Default)
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-PassThru]
[<CommonParameters>]
Wait
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-Wait]
[<CommonParameters>]
OutputMode
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.
Nota
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 PassThruOut-GridView memungkinkan Anda mengirim beberapa item ke alur. Parameter
Contoh 8: Buat pintasan Windows ke 'Out-GridView'
Contoh ini menunjukkan cara menggunakan 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.
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 |
-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.
Properti parameter
| Jenis: | OutputModeOption |
| Nilai default: | None |
| Nilai yang diterima: | None, Single, Multiple |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
OutputMode
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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 nilai Beberapa parameter OutputMode.
Untuk mengirim item dari jendela interaktif ke bawah alur, klik untuk memilih item lalu klik OK. Shift-click dan Ctrl-click didukung.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
PassThru
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Title
Menentukan teks yang muncul di bilah judul jendela Out-GridView . Secara default, bilah judul menampilkan perintah yang memanggil Out-GridView.
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 |
-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.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
Wait
| 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
None
Secara default, cmdlet ini tidak mengembalikan output.
PSObject
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 untukOut-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-GridViewmenampilkan 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-GridViewmenampilkan 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:netUntuk menemukan baris dengan "Net" di kolom DisplayName dan Name , dalam kotak Filter , ketik:
displayname:net name:netNonaktifkan 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 .
