Add-History
Menambahkan entri ke riwayat sesi.
Sintaks
Default (Default)
Add-History
[[-InputObject] <PSObject[]>]
[-PassThru]
[<CommonParameters>]
Deskripsi
Cmdlet Add-History menambahkan entri ke akhir riwayat sesi, yaitu daftar perintah yang dimasukkan selama sesi saat ini.
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 sesi, lihat about_History.
Riwayat sesi dikelola secara terpisah dari riwayat yang dikelola oleh modul PSReadLine
Anda dapat menggunakan cmdlet Get-History untuk mendapatkan perintah dan meneruskannya ke Add-History, atau Anda dapat mengekspor perintah ke file CSV atau XML, lalu mengimpor perintah, dan meneruskan file yang diimpor ke Add-History. Anda dapat menggunakan cmdlet ini untuk menambahkan perintah tertentu ke riwayat atau untuk membuat satu file riwayat yang menyertakan perintah dari lebih dari satu sesi.
Contoh
Contoh 1: Menambahkan perintah ke riwayat sesi yang berbeda
Contoh ini menambahkan perintah yang ditik dalam satu sesi PowerShell ke riwayat sesi PowerShell yang berbeda.
Get-History | Export-Csv -Path C:\testing\history.csv -IncludeTypeInformation
Import-Csv -Path C:\testing\history.csv | Add-History
Perintah pertama mendapatkan objek yang mewakili perintah dalam riwayat dan mengekspornya ke file History.csv.
Perintah kedua ditik pada baris perintah sesi yang berbeda. Ini menggunakan cmdlet Import-Csv untuk mengimpor objek dalam file History.csv. Operator alur (|) meneruskan objek ke cmdlet Add-History, yang menambahkan objek yang mewakili perintah dalam file History.csv ke riwayat sesi saat ini.
Contoh 2: Mengimpor dan menjalankan perintah
Contoh ini mengimpor perintah dari file History.xml, menambahkannya ke riwayat sesi saat ini, lalu menjalankan perintah dalam riwayat gabungan.
Import-Clixml -Path C:\temp\history.xml |
Add-History -PassThru |
ForEach-Object -Process {Invoke-History}
Perintah pertama menggunakan cmdlet Import-Clixml untuk mengimpor riwayat perintah yang diekspor ke file History.xml. Operator alur meneruskan perintah ke cmdlet Add-History, yang menambahkan perintah ke riwayat sesi saat ini. Parameter PassThru meneruskan objek yang mewakili perintah yang ditambahkan ke alur.
Perintah kemudian menggunakan cmdlet ForEach-Object untuk menerapkan perintah Invoke-History ke setiap perintah dalam riwayat gabungan. Perintah Invoke-History diformat sebagai blok skrip, diapit kurung kurawal ({}), seperti yang diperlukan oleh parameter ForEach-ObjectProses cmdlet.
Contoh 3: Menambahkan perintah dalam riwayat ke akhir riwayat
Contoh ini menambahkan lima perintah pertama dalam riwayat ke akhir daftar riwayat.
Get-History -Id 5 -Count 5 | Add-History
Cmdlet Get-History mendapatkan lima perintah yang diakhiri dengan "command 5". Operator alur meneruskannya ke cmdlet Add-History, yang menambahkannya ke riwayat saat ini. Perintah Add-History tidak menyertakan parameter apa pun, tetapi PowerShell mengaitkan objek yang diteruskan melalui alur dengan parameter InputObjectAdd-History.
Contoh 4: Menambahkan perintah dalam file .csv ke riwayat saat ini
Contoh ini menambahkan perintah dalam file History.csv ke riwayat sesi saat ini.
$a = Import-Csv -Path C:\testing\history.csv
Add-History -InputObject $a -PassThru
Cmdlet Import-Csv mengimpor perintah dalam file History.csv dan menyimpan kontennya dalam variabel $a.
Perintah kedua menggunakan cmdlet Add-History untuk menambahkan perintah dari History.csv ke riwayat sesi saat ini. Ini menggunakan parameter InputObject untuk menentukan variabel $a dan parameter PassThru untuk menghasilkan objek yang akan ditampilkan di baris perintah. Tanpa parameter PassThru, cmdlet Add-History tidak menghasilkan output apa pun.
Contoh 5: Menambahkan perintah dalam file .xml ke riwayat saat ini
Contoh ini menambahkan perintah dalam file history.xml ke riwayat sesi saat ini.
Add-History -InputObject (Import-Clixml -Path C:\temp\history.xml)
Parameter InputObject meneruskan hasil perintah dalam tanda kurung ke cmdlet Add-History. Perintah dalam tanda kurung, yang dijalankan terlebih dahulu, mengimpor file history.xml ke PowerShell. Cmdlet Add-History kemudian menambahkan perintah dalam file ke riwayat sesi.
Parameter
-InputObject
Menentukan array entri yang akan ditambahkan ke riwayat sesi sebagai objek HistoryInfo. Anda dapat menggunakan parameter ini untuk mengirimkan objek HistoryInfo, seperti yang dikembalikan oleh cmdlet Get-History, Import-Clixml, atau Import-Csv, ke Add-History.
Properti parameter
| Jenis: | PSObject[] |
| 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 |
-PassThru
Menunjukkan bahwa cmdlet ini mengembalikan objek HistoryInfo untuk setiap entri riwayat. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| 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
HistoryInfo
Anda dapat menyalurkan objek HistoryInfo ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
HistoryInfo
Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek HistoryInfo.
Catatan
Riwayat sesi adalah daftar perintah yang dimasukkan selama sesi bersama dengan ID. 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 sesi, lihat about_History.
Untuk menentukan perintah yang akan ditambahkan ke riwayat, gunakan parameter InputObject. Perintah Add-History hanya menerima objek HistoryInfo, seperti yang dikembalikan oleh cmdlet Get-History untuk setiap perintah. Anda tidak dapat meneruskan jalur dan nama file atau daftar perintah.
Anda dapat menggunakan parameter InputObject untuk meneruskan file berupa objek HistoryInfo ke Add-History. Untuk melakukannya, ekspor hasil perintah Get-History ke file dengan menggunakan cmdlet Export-Csv atau Export-Clixml lalu impor file dengan menggunakan cmdlet Import-Csv atau Import-Clixml. Anda kemudian dapat meneruskan file objek HistoryInfo yang diimpor ke Add-History melalui alur atau dalam variabel. Untuk informasi selengkapnya, lihat contohnya.
File HistoryInfo objek yang Anda teruskan ke cmdlet Add-History harus menyertakan informasi jenis, judul kolom, dan semua properti objek HistoryInfo. Jika Anda ingin meneruskan objek kembali ke Add-History, jangan gunakan parameter NoTypeInformation cmdlet Export-Csv dan jangan hapus informasi jenis, judul kolom, atau bidang apa pun dalam file.
Untuk mengubah riwayat sesi, ekspor sesi ke file CSV atau XML, ubah file, impor file, dan gunakan Add-History untuk menambahkannya ke riwayat sesi saat ini.
