Add-History

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Girdileri oturum geçmişine ekler.

Syntax

Add-History
   [[-InputObject] <PSObject[]>]
   [-Passthru]
   [<CommonParameters>]

Description

cmdlet'i Add-History oturum geçmişinin sonuna, yani geçerli oturum sırasında girilen komutların listesine girdiler ekler.

Oturum geçmişi, oturum sırasında girilen komutların listesidir. Oturum geçmişi yürütme sırasını, durumu ve komutun başlangıç ve bitiş saatlerini temsil eder. Her komutu girdiğinizde PowerShell, yeniden kullanabilmeniz için bu komutu geçmişe ekler. Oturum geçmişi hakkında daha fazla bilgi için bkz. about_History.

Oturum geçmişi, PSReadLine modülü tarafından tutulan geçmişe göre ayrı yönetilir. Her iki geçmiş de PSReadLine'ın yüklendiği oturumlarda kullanılabilir. Bu cmdlet yalnızca oturum geçmişiyle çalışır. Daha fazla bilgi için bkz. about_PSReadLine.

cmdlet'ini Get-History kullanarak komutları alabilir ve komutuna Add-Historygeçirebilirsiniz ya da komutları bir CSV veya XML dosyasına aktarabilir, ardından komutları içeri aktarabilir ve içeri aktarılan dosyayı 'a Add-Historygeçirebilirsiniz. Bu cmdlet'i kullanarak geçmişe belirli komutlar ekleyebilir veya birden fazla oturumdaki komutları içeren tek bir geçmiş dosyası oluşturabilirsiniz.

Örnekler

Örnek 1: Farklı bir oturumun geçmişine komut ekleme

Bu örnek, bir PowerShell oturumunda yazılan komutları farklı bir PowerShell oturumunun geçmişine ekler.

Get-History | Export-Csv c:\testing\history.csv -IncludeTypeInformation
Import-Csv c:\testing\history.csv | Add-History

İlk komut, geçmişteki komutları temsil eden nesneleri alır ve dosyaya History.csv aktarır.

İkinci komut, farklı bir oturumun komut satırına yazılır. Dosyadaki Import-Csv nesneleri içeri aktarmak için cmdlet'ini History.csv kullanır. İşlem hattı işleci (|), nesneleri cmdlet'ine Add-History geçirir ve bu da dosyadaki History.csv komutları temsil eden nesneleri geçerli oturum geçmişine ekler.

Örnek 2: komutları içeri aktarma ve çalıştırma

Bu örnek, dosyadan History.xml komutları içeri aktarır, geçerli oturum geçmişine ekler ve ardından komutları birleştirilmiş geçmiş içinde çalıştırır.

Import-Clixml c:\temp\history.xml | Add-History -PassThru | ForEach-Object -Process {Invoke-History}

İlk komut, dosyaya Import-Clixml aktarılmış bir komut geçmişini içeri aktarmak için cmdlet'ini History.xml kullanır. İşlem hattı işleci komutları cmdlet'ine Add-History geçirir ve bu komutlar geçerli oturum geçmişine eklenir. PassThru parametresi, eklenen komutları temsil eden nesneleri işlem hattına geçirir.

Komut daha sonra cmdlet'ini Invoke-History kullanarak ForEach-Object komutu birleştirilmiş geçmişteki komutların her birine uygular. KomutInvoke-History, cmdlet'in process parametresinin ForEach-Object gerektirdiği şekilde küme ayraçları (){} içine alınmış bir betik bloğu olarak biçimlendirilir.

Örnek 3: Geçmişin sonuna geçmişe komut ekleme

Bu örnek, geçmiş listesindeki ilk beş komutu geçmiş listesinin sonuna ekler.

Get-History -Id 5 -Count 5 | Add-History

cmdlet'i Get-History , komut 5 ile biten beş komutu alır. İşlem hattı işleci bunları geçerli geçmişe Add-History ekleyen cmdlet'ine geçirir. Add-History Komut herhangi bir parametre içermez, ancak PowerShell işlem hattından geçirilen nesneleri inputobject parametresiyle ilişkilendirirAdd-History.

Örnek 4: Geçerli geçmişe .csv dosyasına komut ekleme

Bu örnek, dosyadaki History.csv komutları geçerli oturum geçmişine ekler.

$a = Import-Csv c:\testing\history.csv
Add-History -InputObject $a -PassThru

cmdlet'i Import-Csv dosyasındaki History.csv komutları içeri aktarır ve içindekileri değişkeninde $adepolar.

İkinci komut, Add-History komutlarını History.csv geçerli oturum geçmişine eklemek için cmdlet'ini kullanır. Değişkenini belirtmek $a için InputObject parametresini ve komut satırında görüntülenecek bir nesne oluşturmak için PassThru parametresini kullanır. PassThru parametresi Add-History olmadan cmdlet herhangi bir çıkış oluşturmaz.

Örnek 5: .xml dosyasındaki komutları geçerli geçmişe ekleme

Bu örnek, dosyadaki history.xml komutları geçerli oturum geçmişine ekler.

Add-History -InputObject (Import-Clixml c:\temp\history.xml)

InputObject parametresi, komutun sonuçlarını parantez içinde cmdlet'ine Add-History geçirir. Önce yürütülen parantez içindeki komut, dosyayı PowerShell'e aktarır history.xml . Cmdlet Add-History daha sonra dosyadaki komutları oturum geçmişine ekler.

Parametreler

-InputObject

Oturum geçmişine HistoryInfo nesnesi olarak geçmişe eklenecek bir girdi dizisini belirtir. , veya Import-Csv cmdlet'leri tarafından Get-HistoryImport-Clixmldöndürülenler gibi bir HistoryInfo nesnesini adresine göndermek için bu parametreyi Add-Historykullanabilirsiniz.

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

-Passthru

Bu cmdlet'in her geçmiş girdisi için bir HistoryInfo nesnesi döndürdüğünü gösterir. Varsayılan olarak bu cmdlet herhangi bir çıktı üretmez.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Girişler

HistoryInfo

Bir HistoryInfo nesnesini bu cmdlet'e geçirebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

HistoryInfo

PassThru parametresini kullandığınızda, bu cmdlet bir HistoryInfo nesnesi döndürür.

Notlar

Oturum geçmişi, kimlikle birlikte oturum sırasında girilen komutların listesidir. Oturum geçmişi yürütme sırasını, durumu ve komutun başlangıç ve bitiş saatlerini temsil eder. Her komutu girdiğinizde PowerShell, yeniden kullanabilmeniz için bu komutu geçmişe ekler. Oturum geçmişi hakkında daha fazla bilgi için bkz. about_History.

Geçmişe eklenecek komutları belirtmek için InputObject parametresini kullanın. Add-History komutu yalnızca cmdlet'i tarafından Get-History her komut için döndürülenler gibi HistoryInfo nesnelerini kabul eder. Yolu, dosya adını veya komut listesini geçiremezsiniz.

InputObject parametresini kullanarak HistoryInfo nesnelerinin dosyasını öğesine Add-Historygeçirebilirsiniz. Bunu yapmak için, veya Export-Clixml cmdlet'ini kullanarak komutun Get-History sonuçlarını bir dosyaya Export-Csv aktarın ve ardından veya Import-Clixml cmdlet'lerini kullanarak Import-Csv dosyayı içeri aktarın. Ardından içeri aktarılan HistoryInfo nesnelerinin Add-History dosyasını bir işlem hattı aracılığıyla veya bir değişkende geçirebilirsiniz. Daha fazla bilgi için örneklere bakın.

cmdlet'ine geçirdiğiniz HistoryInfo nesnelerinin Add-History dosyası tür bilgilerini, sütun başlıklarını ve HistoryInfo nesnelerinin tüm özelliklerini içermelidir. Nesneleri öğesine Add-Historygeri geçirmek istiyorsanız, cmdlet'in Export-CsvNoTypeInformation parametresini kullanmayın ve dosyadaki tür bilgilerini, sütun başlıklarını veya herhangi bir alanı silmeyin.

Oturum geçmişini değiştirmek için oturumu CSV veya XML dosyasına aktarın, dosyayı değiştirin, dosyayı içeri aktarın ve geçerli oturum geçmişine eklemek için kullanın Add-History .