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 cmdlet Invoke-History uruchamia polecenia z historii sesji. Możesz przekazać obiekty reprezentujące polecenia z Get-History do Invoke-Historyalbo zidentyfikować polecenia w bieżącej historii przy użyciu ich numeru identyfikacyjnego . Aby znaleźć numer identyfikacyjny polecenia, użyj polecenia cmdlet Get-History.

Historia sesji jest zarządzana niezależnie od historii obsługiwanej przez moduł PSReadLine. Obie historie są dostępne w sesjach, w których PSReadLine. 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. To polecenie można skrócić 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 z identyfikatorem 132. Ponieważ nazwa parametru identyfikatora 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 polecenie Get-Process w historii sesji. Podczas wpisywania znaków dla identyfikatora parametru, Invoke-History uruchamia pierwsze polecenie, jakie znajdzie, które jest zgodne ze wzorcem, zaczynając od najnowszych poleceń.

Invoke-History -Id get-pr

Notatka

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 wymienić tylko jedną wartość identyfikatora, polecenie używa cmdletu ForEach-Object do uruchomienia polecenia Invoke-History jeden raz 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). Do pobrania poleceń używa polecenia cmdlet Get-History. Ponieważ można wyświetlić tylko jedną wartość identyfikatora, polecenie używa polecenia cmdlet ForEach-Object do uruchomienia polecenia Invoke-History raz dla każdej wartości identyfikatora.

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

Parametry

-Confirm

Poprosi o potwierdzenie, zanim uruchomi polecenie 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ć numer lub Id polecenia albo kilka pierwszych znaków polecenia.

Jeśli wpiszesz znaki, Invoke-History najpierw pasuje do najnowszych poleceń. Jeśli pominięto ten parametr, Invoke-History uruchomi ostatnie lub najnowsze polecenie. Aby znaleźć numer identyfikatora polecenia, użyj cmdletu Get-History.

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, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.

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 przekierować do tego polecenia cmdlet historię identyfikatora .

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 PowerShell zawiera następujące aliasy dla Invoke-History:

  • Wszystkie platformy:
    • 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.