Udostępnij za pośrednictwem

Invoke-History

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Uruchamia polecenia z historii sesji.

Składnia

Invoke-History
      [[-Id] <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Invoke-History cmdlet uruchamia polecenia z historii sesji. Można przekazać obiekty reprezentujące polecenia z funkcji Get-History do Invoke-History, lub zidentyfikować polecenia w bieżącej historii przy użyciu ich numeru identyfikatora . Aby znaleźć numer identyfikacyjny polecenia, użyj Get-History polecenia cmdlet .

Historia sesji jest zarządzana niezależnie od historii obsługiwanej przez moduł PSReadLine . Obie historie są dostępne w sesjach, w których jest ładowana funkcja PSReadLine . To polecenie cmdlet działa tylko z historią sesji. Aby uzyskać więcej informacji, zobacz about_PSReadLine.

Przykłady

Przykład 1. Uruchamianie najnowszego polecenia w historii

W tym przykładzie jest uruchamiane ostatnie lub najnowsze polecenie w historii sesji. Możesz skrócić to polecenie jako r, alias dla Invoke-History.

Invoke-History

Przykład 2. Uruchom polecenie o określonym identyfikatorze

W tym przykładzie polecenie jest uruchamiane w historii sesji o identyfikatorze 132. Ponieważ nazwa parametru Id jest opcjonalna, można skrócić to polecenie jako następujące: Invoke-History 132, ihy 132lub r 132.

Invoke-History -Id 132

Przykład 3. Uruchamianie najnowszego polecenia przy użyciu tekstu polecenia

W tym przykładzie jest uruchamiane najnowsze Get-Process polecenie w historii sesji. Podczas wpisywania znaków dla parametru Id uruchamia pierwsze polecenie, Invoke-History które znajduje, które pasuje do wzorca, począwszy od najnowszych poleceń.

Invoke-History -Id get-pr

Uwaga

Dopasowanie wzorca jest niewrażliwe na wielkość liter, ale wzorzec pasuje do początku wiersza.

Przykład 4. Uruchamianie sekwencji poleceń z historii

W tym przykładzie są uruchamiane polecenia od 16 do 24. Ponieważ można wyświetlić tylko jedną wartość identyfikatora , polecenie używa ForEach-Object polecenia cmdlet do uruchomienia Invoke-History polecenia jednorazowo dla każdej wartości identyfikatora .

16..24 | ForEach-Object {Invoke-History -Id $_ }

Przykład 5

W tym przykładzie uruchomiono siedem poleceń w historii, które kończą się poleceniem 255 (od 249 do 255). Używa Get-History polecenia cmdlet do pobierania poleceń. Ponieważ można wyświetlić tylko jedną wartość identyfikatora , polecenie używa ForEach-Object polecenia cmdlet do uruchomienia Invoke-History polecenia jednokrotnego dla każdej wartości identyfikatora .

Get-History -Id 255 -Count 7 | ForEach-Object {Invoke-History -Id $_.Id}

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Określa identyfikator polecenia w historii. Możesz wpisać identyfikator polecenia lub kilka pierwszych znaków polecenia.

W przypadku wpisywania znaków najpierw Invoke-History pasuje do najnowszych poleceń. Jeśli pominiesz ten parametr, Invoke-History uruchomi ostatnie lub najnowsze polecenie. Aby znaleźć identyfikator polecenia , użyj Get-History polecenia cmdlet .

Typ:String
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz przekazać identyfikator historii do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca własnych danych wyjściowych, ale uruchamiane polecenia mogą zwracać własne dane wyjściowe.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla programu Invoke-History:

  • ihy
  • r

Historia sesji to lista poleceń wprowadzonych podczas sesji. Historia sesji reprezentuje kolejność wykonywania, stan oraz czas rozpoczęcia i zakończenia polecenia. Po wprowadzeniu każdego polecenia program PowerShell dodaje go do historii, aby można było go ponownie użyć. Aby uzyskać więcej informacji na temat historii sesji, zobacz about_History.