Udostępnij przez

Invoke-History

Moduł:
Microsoft.PowerShell.Core Module

Uruchamia polecenia z historii sesji.

Składnia

Default (Domyślna) 

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 załadowano PSReadLine. Ten cmdlet działa tylko z historią sesji. Więcej informacji można znaleźć w 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

Uwaga / 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

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

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.