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żna przekazać obiekty reprezentujące polecenia z Get-History do Invoke-Historylub zidentyfikować polecenia w bieżącej historii przy użyciu ich identyfikatora numer. 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. 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. 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 parametru identyfikatoraInvoke-History uruchamia pierwsze polecenie, które znajduje, które jest zgodne ze wzorcem, począwszy od najnowszych poleceń.

Invoke-History -Id get-pr

Nuta

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 polecenia cmdlet ForEach-Object, aby uruchomić polecenie Invoke-History jeden raz dla każdej wartości identyfikatora 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

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 numer polecenia lub 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źć identyfikator liczbę poleceń, użyj polecenia cmdlet 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. Polecenie cmdlet nie jest uruchamiane.

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ć 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.