Get-History

  • Referensi
Modul:
Microsoft.PowerShell.Core

Mendapatkan daftar perintah yang dimasukkan selama sesi saat ini.

Sintaks

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Deskripsi

Get-History Cmdlet mendapatkan riwayat sesi, yaitu daftar perintah yang dimasukkan selama sesi saat ini.

PowerShell secara otomatis mempertahankan riwayat setiap sesi. Jumlah entri dalam riwayat sesi ditentukan oleh nilai $MaximumHistoryCount variabel preferensi. Dimulai di Windows PowerShell 3.0, nilai defaultnya adalah 4096. Secara default, file riwayat disimpan di direktori beranda, tetapi Anda dapat menyimpan file di lokasi mana pun. Untuk informasi selengkapnya tentang fitur riwayat di PowerShell, lihat about_History.

Riwayat sesi dikelola secara terpisah dari riwayat yang dikelola oleh modul PSReadLine . Kedua riwayat tersedia dalam sesi tempat PSReadLine dimuat. Cmdlet ini hanya berfungsi dengan riwayat sesi. Untuk informasi selengkapnya lihat, about_PSReadLine.

Contoh

Contoh 1: Dapatkan riwayat sesi

Contoh ini mendapatkan entri dalam riwayat sesi. Tampilan default menunjukkan setiap perintah dan ID-nya, yang menunjukkan urutan dijalankannya.

Get-History

Contoh 2: Dapatkan entri yang menyertakan string

Contoh ini mendapatkan entri dalam riwayat perintah yang menyertakan layanan string. Perintah pertama mendapatkan semua entri dalam riwayat sesi. Operator alur (|) meneruskan hasil ke Where-Object cmdlet, yang hanya memilih perintah yang menyertakan layanan.

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

Contoh 3: Mengekspor entri riwayat hingga ID tertentu

Contoh ini mendapatkan lima entri riwayat terbaru yang berakhiran dengan entri 7. Operator alur meneruskan hasil ke Export-Csv cmdlet, yang memformat riwayat sebagai teks yang dipisahkan koma dan menyimpannya dalam file History.csv. File menyertakan data yang ditampilkan saat Anda memformat riwayat sebagai daftar. Ini termasuk status dan waktu mulai dan berakhir perintah.

Get-History -ID 7 -Count 5 | Export-Csv -Path History.csv

Contoh 4: Menampilkan perintah terbaru

Contoh ini mendapatkan perintah terakhir dalam riwayat perintah. Perintah terakhir adalah perintah yang terakhir dimasukkan. Perintah ini menggunakan parameter Hitung untuk menampilkan hanya satu perintah. Secara default, Get-History mendapatkan perintah terbaru. Perintah ini dapat disingkat menjadi "h -c 1" dan setara dengan menekan tombol panah atas.

Get-History -Count 1

Contoh 5: Menampilkan semua properti entri dalam riwayat

Contoh ini menampilkan semua properti entri dalam riwayat sesi. Operator alur meneruskan hasil Get-History perintah ke Format-List cmdlet, yang menampilkan semua properti dari setiap entri riwayat. Ini termasuk ID, status, dan waktu mulai dan berakhir perintah.

Get-History | Format-List -Property *

Parameter

-Count

Menentukan jumlah entri riwayat terbaru yang didapat cmdlet ini. Secara default, Get-History mendapatkan semua entri dalam riwayat sesi. Jika Anda menggunakan parameter Hitung dan Id dalam perintah, tampilan diakhir dengan perintah yang ditentukan oleh parameter Id .

Di Windows PowerShell 2.0, secara default, Get-History mendapatkan 32 entri terbaru.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Menentukan array ID entri dalam riwayat sesi. Get-History hanya mendapatkan entri yang ditentukan. Jika Anda menggunakan parameter Id dan Count dalam perintah, Get-History mendapatkan entri terbaru yang diakhir dengan entri yang ditentukan oleh parameter Id .

Type:Int64[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

Int64

Anda dapat menyalurkan ID riwayat ke cmdlet ini.

Output

HistoryInfo

Cmdlet ini mengembalikan objek riwayat untuk setiap item riwayat yang didapatkannya.

Catatan

PowerShell menyertakan alias berikut untuk Get-History:

  • Semua platform:
    • h
    • history
    • ghy

Riwayat sesi adalah daftar perintah yang dimasukkan selama sesi. Riwayat sesi mewakili urutan eksekusi, status, dan waktu mulai dan berakhir perintah. Saat Anda memasukkan setiap perintah, PowerShell menambahkannya ke riwayat sehingga Anda dapat menggunakannya kembali. Untuk informasi selengkapnya tentang riwayat perintah, lihat about_History.

Mulai dari Windows PowerShell 3.0, nilai $MaximumHistoryCount default variabel preferensi adalah 4096. Di Windows PowerShell 2.0, nilai defaultnya adalah 64. Untuk informasi selengkapnya tentang variabel, $MaximumHistoryCount lihat about_Preference_Variables.