Bagikan melalui

Get-History

Modul:
Microsoft.PowerShell.Core Module

Mendapatkan daftar perintah yang dimasukkan selama sesi saat ini.

Sintaks

Default (Default) 

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

Deskripsi

cmdlet Get-History 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 variabel preferensi $MaximumHistoryCount. 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 di mana PSReadLine dimuat. Cmdlet ini hanya berfungsi dengan riwayat sesi. Untuk informasi selengkapnya lihat, about_PSReadLine.

Contoh

Contoh 1: Dapatkan riwayat sesi

Contoh ini memperoleh semua 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 cmdlet Where-Object, 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 cmdlet Export-Csv, yang memformat riwayat sebagai teks yang dipisahkan koma dan menyimpannya dalam file History.csv. File tersebut menyertakan data yang ditampilkan saat Anda memformat riwayat dalam bentuk 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 Hitungan 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 perintah Get-History ke cmdlet Format-List, 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 Count dan Id dalam perintah, tampilan diakhiri dengan perintah yang ditentukan oleh parameter Id.

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

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:1
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Id

Menentukan sebuah array dari ID-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.

Properti parameter

Jenis:

Int64[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:False
Nilai dari alur:True
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

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 default variabel preferensi $MaximumHistoryCount adalah 4096. Di Windows PowerShell 2.0, nilai defaultnya adalah 64. Untuk informasi selengkapnya tentang variabel $MaximumHistoryCount, lihat about_Preference_Variables.