Add-History
Oturum geçmişine kayıtlar ekleme işlemi yapar.
Sözdizimi
Default EnterprisePublishing
Add-History
[[-InputObject] <PSObject[]>]
[-PassThru]
[<CommonParameters>]
Description
Add-History cmdlet'i 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ı, durumunu ve komutun başlangıç ve bitiş saatlerini temsil eder. Her komutu girdiğinizde PowerShell, yeniden kullanabilmeniz için bunu 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ı olarak yönetilir. Her iki geçmiş bilgisi de PSReadLine yüklendiğinde oturumlarda kullanılabilir. Bu cmdlet yalnızca oturum geçmişiyle çalışır. Daha fazla bilgi için bkz. about_PSReadLine.
komutları almak ve Get-History'e geçirmek için Add-History cmdlet'ini kullanabilir veya komutları bir CSV veya XML dosyasına aktarabilir, sonra komutları içeri aktarabilir ve içeri aktarılan dosyayı Add-History'a geç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 -Path C:\testing\history.csv -IncludeTypeInformation
Import-Csv -Path C:\testing\history.csv | Add-History
İlk komut, geçmişteki komutları temsil eden nesneleri alır ve bunları History.csv dosyasına aktarır.
İkinci komut, farklı bir oturumun komut satırına yazılır.
Import-Csv dosyasındaki nesneleri içeri aktarmak için History.csv cmdlet'ini kullanır. İşlem hattı işleci (|), nesneleri Add-History cmdlet'ine geçirir ve bu da History.csv dosyasındaki komutları temsil eden nesneleri geçerli oturum geçmişine ekler.
Örnek 2: komutları içeri aktarma ve çalıştırma
Bu örnek, komutları History.xml dosyasından içeri aktarır, geçerli oturum geçmişine ekler ve ardından komutları birleştirilmiş geçmişe çalıştırır.
Import-Clixml -Path C:\temp\history.xml | Add-History -PassThru | ForEach-Object -Process {Invoke-History}
İlk komut, Import-Clixml dosyasına aktarılmış bir komut geçmişini içeri aktarmak için History.xml cmdlet'ini kullanır. İşlem hattı işleci, komutları geçerli oturum geçmişine ekleyen Add-History cmdlet'ine aktarır.
PassThru parametresi, eklenen komutları temsil eden nesneleri işlem hattına geçirir.
Komut daha sonra ForEach-Object cmdlet'ini kullanarak Invoke-History komutunu birleştirilmiş geçmişteki komutların her birine uygular.
Invoke-History komutu, {} cmdlet'in, İşlem'in parametresinin gerektirdiği şekilde, parantez (ForEach-Object) içinde yer alan bir betik bloğu olarak biçimlendirilmiştir.
Örnek 3: Geçmişe komutları geçmişin sonuna ekleyin
Bu örnek, geçmiş listesindeki ilk beş komutu geçmiş listesinin sonuna ekler.
Get-History -Id 5 -Count 5 | Add-History
Get-History cmdlet'i, "komut 5" ile biten beş ayrı komutu alır. Boru hattı işleci, bunları geçerli geçmişe ekleyen Add-History cmdlet'ine iletir.
Add-History komutu herhangi bir parametre içermez, ancak PowerShell işlem hattından geçirilen nesneleri Add-History parametresiyle ilişkilendirir.
Örnek 4: .csv dosyasındaki komutları geçerli geçmişe ekleme
Bu örnek, History.csv dosyasındaki komutları geçerli oturum geçmişine ekler.
$a = Import-Csv -Path C:\testing\history.csv
Add-History -InputObject $a -PassThru
Import-Csv cmdlet'i History.csv dosyasındaki komutları içeri aktarır ve içeriğini $adeğişkeninde depolar.
İkinci komut, Add-History komutlarını geçerli oturum geçmişine eklemek için History.csv cmdlet'ini kullanır.
InputObject parametresini kullanarak $a değişkenini ve PassThru parametresini kullanarak komut satırında görüntülenecek bir nesne oluşturur.
PassThru parametresi olmadan, Add-History cmdlet'i herhangi bir çıkış oluşturmaz.
Örnek 5: .xml dosyasındaki komutları geçerli geçmişe ekleme
Bu örnek, history.xml dosyasındaki komutları geçerli oturum geçmişine ekler.
Add-History -InputObject (Import-Clixml -Path C:\temp\history.xml)
InputObject parametresi, komutun sonuçlarını parantez içinde Add-History cmdlet'ine geçirir. Önce yürütülen parantez içindeki komut, history.xml dosyasını PowerShell'e aktarır.
Add-History cmdlet'i daha sonra dosyadaki komutları oturum geçmişine ekler.
Parametreler
-InputObject
Geçmişe eklenecek girdi dizisini, HistoryInfo nesnesi olarak oturum geçmişine belirtir.
, Get-Historyveya Import-Clixml cmdlet'leri tarafından döndürülenler gibi bir Import-Csv nesnesini Add-Historygöndermek için bu parametreyi kullanabilirsiniz.
Parametre özellikleri
| Tür: | PSObject[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 çıkış oluşturmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
HistoryInfo
Bir HistoryInfo nesnesini bu cmdlet'e yöneltebilirsiniz.
Çı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ı, durumunu ve komutun başlangıç ve bitiş saatlerini temsil eder. Her komutu girdiğinizde PowerShell, yeniden kullanabilmeniz için bunu 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, cmdlet'i tarafından her komut için döndürülenler gibi yalnızca Get-History nesnelerini kabul eder. Bir yol ve dosya adı veya bir komut listesi veremezsiniz.
InputObject parametresini, HistoryInfo nesnelerinin dosyasını Add-Historyaktarmak için kullanabilirsiniz. Bunu yapmak için, Get-History veya Export-Csv cmdlet'ini kullanarak bir Export-Clixml komutunun sonuçlarını bir dosyaya aktarın ve ardından Import-Csv veya Import-Clixml cmdlet'lerini kullanarak dosyayı içeri aktarın. Ardından içeri aktarılan HistoryInfo nesnelerinin dosyasını bir işlem hattı veya değişken aracılığıyla Add-History aktarabilirsiniz. Daha fazla bilgi için örneklere bakın.
cmdlet'ine geçirdiğiniz Add-History nesnelerinin dosyası, HistoryInfo nesnelerinin tür bilgilerini, sütun başlıklarını ve tüm özelliklerini içermelidir. Nesneleri Add-Historygeri geçirmek istiyorsanız, cmdlet'in Export-Csv 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 Add-History kullanın.
