Udostępnij przez

Get-History

Moduł:
Microsoft.PowerShell.Core Module

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

Składnia

Default (Domyślna) 

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

Opis

Polecenie cmdlet Get-History 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 preferencji $MaximumHistoryCount. 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 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. Pobieranie historii sesji

Przykład ten pobiera elementy z 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: Pobierz wpisy zawierające ciąg

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

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

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

Ten przykład pobiera pięć najnowszych wpisów historii kończących się wpisem 7. Operator potoku przekazuje wynik do polecenia cmdlet Export-Csv, 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, aby wyświetlić tylko jedno polecenie. 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 przekazuje wyniki polecenia Get-History do polecenia Cmdlet Format-List, które wyświetla wszystkie właściwości każdego wpisu do 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 parametrów liczba i Id w poleceniu, wyświetlanie kończy się na poleceniu określonym przez parametr Id.

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

Właściwości parametru

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

Zestawy parametrów

(All)
Position:1
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 tablicę identyfikatorów wpisów w historii sesji. Get-History pobiera tylko określone wpisy. Jeśli w poleceniu używasz zarówno parametrów Id , jak i Count , Get-History pobiera najnowsze wpisy kończące się wpisem określonym przez parametr Id .

Właściwości parametru

Typ:

Int64[]

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

Zestawy parametrów

(All)
Position:0
Obowiązkowy:False
Wartość z potoku:True
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

Int64

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

Dane wyjściowe

HistoryInfo

To polecenie cmdlet zwraca obiekt historii dla każdego elementu historii, który otrzymuje.

Uwagi

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

  • Wszystkie platformy:
    • 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ą zmiennej preferencji $MaximumHistoryCount 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.