Udostępnij za pośrednictwem

Get-History

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

Pobiera listę poleceń wprowadzonych podczas bieżącej sesji.

Składnia

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Opis

Polecenie Get-History cmdlet pobiera historię sesji, czyli listę poleceń wprowadzonych podczas bieżącej sesji.

Program PowerShell automatycznie zachowuje historię każdej sesji. Liczba wpisów w historii sesji jest określana przez wartość zmiennej $MaximumHistoryCount preferencji. Począwszy od programu Windows PowerShell 3.0, wartość domyślna to 4096. Domyślnie pliki historii są zapisywane w katalogu głównym, ale plik można zapisać w dowolnej lokalizacji. Aby uzyskać więcej informacji na temat funkcji historii w programie PowerShell, zobacz about_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 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. Pobieranie historii sesji

Ten przykład pobiera wpisy w historii sesji. Na ekranie domyślnym jest wyświetlane każde polecenie i jego identyfikator, który wskazuje kolejność, w jakiej zostały uruchomione.

Get-History

Przykład 2. Pobieranie wpisów zawierających ciąg

Ten przykład pobiera wpisy w historii poleceń, które zawierają usługę ciągów. Pierwsze polecenie pobiera wszystkie wpisy w historii sesji. Operator potoku (|) przekazuje wyniki do Where-Object polecenia cmdlet, które wybiera tylko polecenia zawierające usługę.

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

Przykład 3. Eksportowanie wpisów historii do określonego identyfikatora

Ten przykład pobiera pięć najnowszych wpisów historii kończących się wpisem 7. Operator potoku przekazuje wynik do Export-Csv polecenia cmdlet, które formatuje historię jako tekst rozdzielony przecinkami i zapisuje go w pliku History.csv. Plik zawiera dane wyświetlane podczas formatowania historii jako listy. Obejmuje to stan i czas rozpoczęcia i zakończenia polecenia.

Get-History -ID 7 -Count 5 | Export-Csv -Path History.csv

Przykład 4. Wyświetlanie najnowszego polecenia

Ten przykład pobiera ostatnie polecenie w historii poleceń. Ostatnie polecenie to ostatnio wprowadzone polecenie. To polecenie używa parametru Count do wyświetlenia tylko jednego polecenia. Domyślnie Get-History pobiera najnowsze polecenia. To polecenie można skrócić do "h -c 1" i jest równoważne naciśnięciu strzałki w górę.

Get-History -Count 1

Przykład 5. Wyświetlanie wszystkich właściwości wpisów w historii

W tym przykładzie są wyświetlane wszystkie właściwości wpisów w historii sesji. Operator potoku Get-History przekazuje wyniki polecenia do Format-List polecenia cmdlet, które wyświetla wszystkie właściwości każdego wpisu historii. Obejmuje to identyfikator, stan oraz godziny rozpoczęcia i zakończenia polecenia.

Get-History | Format-List -Property *

Parametry

-Count

Określa liczbę najnowszych wpisów historii pobieranych przez to polecenie cmdlet. Domyślnie Get-History pobiera wszystkie wpisy w historii sesji. Jeśli używasz zarówno parametrów Count, jak i Id w poleceniu, ekran kończy się poleceniem określonym przez parametr Id.

W programie Windows PowerShell 2.0 domyślnie Get-History pobiera 32 najnowsze wpisy.

Typ:Int32
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Określa tablicę identyfikatorów wpisów w historii sesji. Get-History pobiera tylko określone wpisy. Jeśli używasz zarówno parametrów Id , jak i Count w poleceniu, Get-History pobiera najnowsze wpisy kończące się wpisem określonym przez parametr Id .

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

Dane wejściowe

Int64

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

Dane wyjściowe

HistoryInfo

To polecenie cmdlet zwraca obiekt historii dla każdego odbieranego elementu historii.

Uwagi

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

  • h
  • history
  • ghy

Historia sesji to lista poleceń wprowadzonych podczas sesji. Historia sesji reprezentuje kolejność uruchamiania, 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 poleceń, zobacz about_History.

Począwszy od programu Windows PowerShell 3.0, domyślną wartością $MaximumHistoryCount zmiennej preferencji jest 4096. W programie Windows PowerShell 2.0 wartość domyślna to 64. Aby uzyskać więcej informacji na temat zmiennej $MaximumHistoryCount , zobacz about_Preference_Variables.